> ## 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`](https://docs.base44.com/he/developers/references/cli/commands/create) של Base44 CLI יוצרת פרויקטים חדשים עם כל הקבצים והתצורה הנדרשים. מאמר זה מתאר את מבנה פרויקט הבקאנד של Base44 ומסביר מה כל קובץ ותיקייה עושים.

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

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

**\<your-project-name>**

**base44**

**.app.jsonc**

**config.jsonc**

**.gitignore**

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

**\<your-project-name>**

**base44**

**.app.jsonc**

**config.jsonc**

**.types**

**types.d.ts**

**agents**

**\<agent-name>.jsonc**

**actors**

**\<actor-name>**

**entry.ts**

**auth**

**config.jsonc**

**connectors**

**\<connector-type>.jsonc**

**entities**

**\<entity-name>.jsonc**

**functions**

**\<function-name>**

**entry.ts**

**function.jsonc**

**.gitignore**

> [!NOTE]
>
> Functions דורשות רק קובץ `entry.ts` או `entry.js`. ניתן להוסיף אופציונלית `function.jsonc` עבור תצורות מתקדמות כמו שמות מותאמים. ראה [Backend Functions](https://docs.base44.com/he/developers/backend/resources/backend-functions/overview.md) לפרטים.

### base44/

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

#### config.jsonc

מגדיר את תצורת הפרויקט שלך, כולל נתיבים ל-[entities](https://docs.base44.com/he/developers/backend/resources/entities/overview.md), [functions](https://docs.base44.com/he/developers/backend/resources/backend-functions/overview.md), [agents](https://docs.base44.com/developers/backend/resources/agents-config.md), [connectors](https://docs.base44.com/he/developers/backend/resources/connectors.md), [auth config](https://docs.base44.com/he/developers/backend/resources/auth.md), והגדרות אירוח אתר עבור פרויקטים full-stack. ה-CLI יוצר את זה רק עם שם הפרויקט שלך, ואתה יכול להוסיף תצורה נוספת לפי הצורך. כאשר `visibility` מוגדר כאן, [`deploy`](https://docs.base44.com/he/developers/references/cli/commands/deploy) מחיל אותו על השרת בכל הרצה.

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

```jsonc theme={null}
// Base44 Project Configuration
{
  "name": "my-project",
  "description": "My Base44 app",
  "visibility": "private",        // optional: public | private | workspace

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

  // Site/hosting configuration (for full-stack projects)
  "site": {
    "outputDirectory": "./dist", // Required - relative to the project root, not to this file
  },
}
```

| Property | תיאור | ברירת מחדל |
| - | - | - |
| `name` | שם הפרויקט (חובה) | — |
| `description` | תיאור הפרויקט | — |
| `visibility` | רמת הגישה לאפליקציה שפורסמה. השתמש ב-`public` לאפליקציה שכל אחד יכול לפתוח ללא התחברות, ב-`private` כדי להגביל גישה למשתמשים מוזמנים, או ב-`workspace` כדי להגביל גישה לחברי סביבת העבודה. | — |
| `entitiesDir` | נתיב לתיקיית [entities](https://docs.base44.com/he/developers/backend/resources/entities/overview.md) | `./entities` |
| `functionsDir` | נתיב לתיקיית [functions](https://docs.base44.com/he/developers/backend/resources/backend-functions/overview.md) | `./functions` |
| `agentsDir` | נתיב לתיקיית [agents](https://docs.base44.com/developers/backend/resources/agents-config.md) | `./agents` |
| `actorsDir` | נתיב לתיקיית [actors](https://docs.base44.com/he/developers/backend/resources/actors/overview.md) | `./actors` |
| `connectorsDir` | נתיב לתיקיית [connectors](https://docs.base44.com/he/developers/backend/resources/connectors.md) | `./connectors` |
| `authDir` | נתיב לתיקיית [auth config](https://docs.base44.com/he/developers/backend/resources/auth.md) | `./auth` |
| `site` | תצורת ה-frontend. השמט עבור פרויקטים של בקאנד בלבד. | — |
| `site.outputDirectory` | היכן נמצאים קבצי האתר הבנויים. חובה עבור [`site deploy`](https://docs.base44.com/he/developers/references/cli/commands/site-deploy). הנתיב נפתר מתיקיית השורש של הפרויקט (התיקייה שמכילה את `base44/`), ולא מקובץ התצורה כמו נתיבי התיקיות שלמעלה. כך הוא תואם למקום שבו כלי הבנייה של ה-frontend כותב את הפלט. | — |
| `site.buildCommand` | פקודה שמורצת על ידי [`build`](https://docs.base44.com/he/developers/references/cli/commands/build), [`deploy --build`](https://docs.base44.com/he/developers/references/cli/commands/deploy), [`site deploy --build`](https://docs.base44.com/he/developers/references/cli/commands/site-deploy) ו-[`eject`](https://docs.base44.com/he/developers/references/cli/commands/eject) כדי לקמפל את האתר עם `VITE_BASE44_APP_ID` מוזרק. | — |
| `site.installCommand` | פקודה שמורצת על ידי [`create`](https://docs.base44.com/he/developers/references/cli/commands/create), `scaffold` ו-[`eject`](https://docs.base44.com/he/developers/references/cli/commands/eject) כדי להתקין תלויות לפני הבנייה. | — |
| `site.serveCommand` | פקודה שבה [`base44 dev`](https://docs.base44.com/he/developers/references/cli/commands/dev) משתמש כדי להפעיל את שרת הפיתוח של ה-frontend לצד הבקאנד המקומי. | — |

#### .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` המחריג קובץ זה.

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

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

#### agents/

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

#### agent-skills/

תיקייה שמכילה [agent skills](https://docs.base44.com/he/developers/backend/resources/agents/agent-skills.md), ערכות ההוראות לשימוש חוזר שרצות בתוך הסוכנים של האפליקציה. כל skill הוא קובץ Markdown נפרד ששמו הוא שם ה-skill, עם `description` ב-frontmatter וגוף הוראות. אלה skills בזמן ריצה עבור הסוכנים של האפליקציה, ולא ה-skills של עוזרי קידוד AI שמתוארים בהמשך.

#### actors/

תיקייה המכילה [actors](https://docs.base44.com/he/developers/backend/resources/actors/overview.md) לסשנים משותפים בזמן אמת. לכל actor יש תת-תיקייה משלו עם קובץ `entry.ts`, שמייצא את מחלקת ה-actor כייצוא ברירת המחדל. שם תת-התיקייה הופך לשם ה-actor ב-SDK.

#### auth/

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

#### connectors/

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

#### entities/

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

#### functions/

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

**functions**

**\<function-name>**

**entry.ts**

**function.jsonc**

### .gitignore

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

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

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

## ראה גם

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

> [!NOTE]
>
> דף זה תורגם באמצעות AI. למידע המדויק והעדכני ביותר, עיין ב[גרסה האנגלית](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.