> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# מבנה הפרויקט

> הבנת מבנה פרויקט Base44 עבור פיתוח מקומי

הפקודה [`create`](/developers/references/cli/commands/create) של Base44 CLI יוצרת פרויקטים חדשים עם כל הקבצים והתצורה הנדרשים. מאמר זה מתאר את מבנה פרויקט הבקאנד של Base44 ומסביר מה כל קובץ ותיקייה עושים.

## מבנה פרויקט בקאנד

כאשר אתה יוצר פרויקט Base44 של backend-only, ה-CLI מייצר את המבנה המינימלי הזה:

<Tree>
  <Tree.Folder name="<your-project-name>" defaultOpen>
    <Tree.Folder name="base44" defaultOpen>
      <Tree.File name=".app.jsonc" />

      <Tree.File name="config.jsonc" />
    </Tree.Folder>

    <Tree.File name=".gitignore" />
  </Tree.Folder>
</Tree>

ככל שאתה מפתח את הפרויקט שלך, אתה מוסיף קבצים עבור משאבים כמו [entities](/developers/backend/resources/entities/overview), [functions](/developers/backend/resources/backend-functions/overview), [agents](/developers/backend/resources/agents-config), [connectors](/developers/backend/resources/connectors), ו-[auth config](/developers/backend/resources/auth):

<Tree>
  <Tree.Folder name="<your-project-name>" defaultOpen>
    <Tree.Folder name="base44" defaultOpen>
      <Tree.File name=".app.jsonc" />

      <Tree.File name="config.jsonc" />

      <Tree.Folder name=".types" defaultOpen>
        <Tree.File name="types.d.ts" />
      </Tree.Folder>

      <Tree.Folder name="agents" defaultOpen>
        <Tree.File name="<agent-name>.jsonc" />
      </Tree.Folder>

      <Tree.Folder name="auth" defaultOpen>
        <Tree.File name="config.jsonc" />
      </Tree.Folder>

      <Tree.Folder name="connectors" defaultOpen>
        <Tree.File name="<connector-type>.jsonc" />
      </Tree.Folder>

      <Tree.Folder name="entities" defaultOpen>
        <Tree.File name="<entity-name>.jsonc" />
      </Tree.Folder>

      <Tree.Folder name="functions" defaultOpen>
        <Tree.Folder name="<function-name>" defaultOpen>
          <Tree.File name="entry.ts" />

          <Tree.File name="function.jsonc" />
        </Tree.Folder>
      </Tree.Folder>
    </Tree.Folder>

    <Tree.File name=".gitignore" />
  </Tree.Folder>
</Tree>

<Note>
  Functions דורשות רק קובץ `entry.ts` או `entry.js`. ניתן להוסיף אופציונלית `function.jsonc` עבור תצורות מתקדמות כמו שמות מותאמים או automations. ראה [Backend Functions](/developers/backend/resources/backend-functions/overview) לפרטים.
</Note>

### base44/

מכיל את כל תצורת הבקאנד והגדרות המשאבים של Base44.

#### config.jsonc

מגדיר את תצורת הפרויקט שלך, כולל נתיבים ל-[entities](/developers/backend/resources/entities/overview), [functions](/developers/backend/resources/functions), [agents](/developers/backend/resources/agents-config), [connectors](/developers/backend/resources/connectors), [auth config](/developers/backend/resources/auth), והגדרות אירוח אתר עבור פרויקטים full-stack. ה-CLI יוצר את זה רק עם שם הפרויקט שלך, ואתה יכול להוסיף תצורה נוספת לפי הצורך.

הפרויקט שלך דורש קובץ `config.jsonc` (או `config.json`) בתיקיית `base44/`:

```jsonc theme={null}
// Base44 Project Configuration
{
  "name": "my-project",
  "description": "My Base44 app",

  // Directory paths (relative to config file)
  "entitiesDir": "./entities",
  "functionsDir": "./functions",
  "agentsDir": "./agents",
  "connectorsDir": "./connectors",
  "authDir": "./auth",

  // Site/hosting configuration (for full-stack projects)
  "site": {
    "outputDirectory": "./dist", // Required - where your built files are located
  },
}
```

| Property               | תיאור                                                                              | ברירת מחדל     |
| ---------------------- | ---------------------------------------------------------------------------------- | -------------- |
| `name`                 | שם הפרויקט (חובה)                                                                  | —              |
| `description`          | תיאור הפרויקט                                                                      | —              |
| `entitiesDir`          | נתיב לתיקיית [entities](/developers/backend/resources/entities/overview)           | `./entities`   |
| `functionsDir`         | נתיב לתיקיית [functions](/developers/backend/resources/backend-functions/overview) | `./functions`  |
| `agentsDir`            | נתיב לתיקיית [agents](/developers/backend/resources/agents-config)                 | `./agents`     |
| `connectorsDir`        | נתיב לתיקיית [connectors](/developers/backend/resources/connectors)                | `./connectors` |
| `authDir`              | נתיב לתיקיית [auth config](/developers/backend/resources/auth)                     | `./auth`       |
| `site.outputDirectory` | היכן נמצאים קבצי האתר הבנויים (חובה לפריסת אתר)                                    | —              |
| `site.buildCommand`    | משמש רק במהלך `base44 create` לפריסה אוטומטית                                      | —              |
| `site.installCommand`  | משמש רק במהלך `base44 create` לפריסה אוטומטית                                      | —              |
| `site.serveCommand`    | לעיון בלבד. אינו בשימוש כרגע על ידי ה-CLI                                          | —              |

<Note>
  המאפיינים `buildCommand`, `installCommand`, ו-`serveCommand` נכללים אוטומטית כאשר אתה יוצר פרויקט מתבנית ה-full-stack. הם משמשים רק במהלך זרימת `base44 create` הראשונית עבור פריסה אוטומטית. אינך צריך לציין או לשנות מאפיינים אלה לאחר יצירת הפרויקט. בעת פריסת האתר שלך מאוחר יותר עם `site deploy`, רק `outputDirectory` משמש.
</Note>

#### .app.jsonc

מקשר את הפרויקט המקומי שלך לאפליקציית Base44 שלך. קובץ זה נוצר אוטומטית על ידי ה-CLI כאשר אתה יוצר או מקשר פרויקט.

```jsonc theme={null}
// Base44 App Configuration
// This file links your local project to your Base44 app.
// Do not commit this file to version control.
{
  "id": "your-app-id",
}
```

<Note>
  אסור להעלות את קובץ `.app.jsonc` ל-version control. ה-CLI
  יוצר אוטומטית קובץ `.gitignore` המחריג קובץ זה.
</Note>

#### .types/types.d.ts

הגדרות סוג TypeScript שנוצרו עבור entities, functions, agents ו-connectors שלך. נוצר על ידי הרצת [`base44 types generate`](/developers/references/cli/commands/types-generate). קובץ זה מספק השלמה אוטומטית ובטיחות סוגים בעת שימוש ב-SDK בפרויקטי TypeScript. ראה [Dynamic Types](/developers/references/sdk/getting-started/dynamic-types) לפרטים נוספים.

#### agents/

תיקייה המכילה [תצורות סוכן AI](/developers/backend/resources/agents-config). כל סוכן מוגדר בקובץ `.json` או `.jsonc` נפרד.

#### auth/

תיקייה המכילה את [תצורת האימות](/developers/backend/resources/auth) של האפליקציה שלך. מכילה קובץ `config.jsonc` יחיד המגדיר אילו שיטות התחברות זמינות למשתמשי הקצה שלך. משוך את התצורה הנוכחית מ-Base44 עם [`auth pull`](/developers/references/cli/commands/auth-pull).

#### connectors/

תיקייה המכילה [תצורות OAuth connector](/developers/backend/resources/connectors). כל connector מוגדר בקובץ `.json` או `.jsonc` נפרד הנקרא על שם סוג האינטגרציה כמו `slack.jsonc` או `googlecalendar.jsonc`.

#### entities/

תיקייה המכילה [הגדרות entity schema](/developers/backend/resources/entities/overview). כל entity מוגדר בקובץ `.json` או `.jsonc` נפרד. צור תיקייה זו כאשר אתה מוכן להגדיר את ה-entity הראשון שלך.

#### functions/

תיקייה המכילה [פונקציות בקאנד](/developers/backend/resources/backend-functions/overview) serverless. כל פונקציה דורשת תיקיית משנה משלה עם קובץ קוד `entry.ts` או `entry.js`. ה-CLI משתמש בנתיב התיקייה יחסית לשורש ה-functions כשם הפונקציה. לדוגמה, `functions/sendEmail/entry.ts` יוצר פונקציה בשם `sendEmail`. ניתן להוסיף אופציונלית קובץ תצורה `function.jsonc` כדי להתאים אישית את שם הפונקציה או להוסיף automations.

<Tree>
  <Tree.Folder name="functions" defaultOpen>
    <Tree.Folder name="<function-name>" defaultOpen>
      <Tree.File name="entry.ts" />

      <Tree.File name="function.jsonc" />
    </Tree.Folder>
  </Tree.Folder>
</Tree>

### .gitignore

מונע מקבצים להיות מועלים ל-version control. הפרויקט שלך מתחיל עם קובץ זה כדי למנוע מ-`.app.jsonc` להיות מועלה.

### תיקיות AI agent skills

כאשר אתה יוצר פרויקט עם `base44 create`, [AI agent skills](/developers/backend/overview/base44-skills) מותקנים אוטומטית. אלה מופיעים בתיקיות ספציפיות לסוכן כמו `.claude/skills/`, `.cursor/skills/`, או דומה, בהתאם לעוזר הקידוד AI שבו אתה משתמש. תיקיות אלה עוזרות לסוכן הקידוד שלך להבין כיצד לעבוד עם Base44 ובטוח להעלות אותן ל-version control.

## ראה גם

* [Quickstart - Backend only](/developers/backend/quickstart/templates/quickstart-backend-only): צור את הפרויקט הראשון שלך של backend-only
* [Quickstart - React](/developers/backend/quickstart/templates/quickstart-react-template): בנה אפליקציית React מסוג full-stack עם Base44
* [`types generate` command](/developers/references/cli/commands/types-generate): ייצר types של TypeScript מהפרויקט שלך
* [Dynamic Types](/developers/references/sdk/getting-started/dynamic-types): קבל בטיחות סוגים עבור קוד SDK שלך
* [Entities](/developers/backend/resources/entities/overview): למד על תצורת schema של מסד הנתונים
* [Backend Functions](/developers/backend/resources/backend-functions/overview): צור נקודות קצה API מסוג serverless
* [AI Agents](/developers/backend/resources/agents-config): הגדר סוכני AI עבור האפליקציה שלך
* [Connectors](/developers/backend/resources/connectors): הגדר חיבורי OAuth לשירותי צד שלישי
* [Auth Config](/developers/backend/resources/auth): נהל את שיטות ההתחברות של האפליקציה שלך

<Note>דף זה תורגם באמצעות בינה מלאכותית. למידע המדויק והעדכני ביותר, עיין ב[גרסה האנגלית](/). </Note>