דלג לתוכן הראשי
הפקודה create של Base44 CLI יוצרת פרויקטים חדשים עם כל הקבצים והתצורה הנדרשים. מאמר זה מתאר את מבנה פרויקט הבקאנד של Base44 ומסביר מה כל קובץ ותיקייה עושים.

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

כאשר אתה יוצר פרויקט Base44 של backend-only, ה-CLI מייצר את המבנה המינימלי הזה:
<your-project-name>
base44
.app.jsonc
config.jsonc
.gitignore
ככל שאתה מפתח את הפרויקט שלך, אתה מוסיף קבצים עבור משאבים כמו entities, functions, agents, connectors, ו-auth config:
<your-project-name>
base44
.app.jsonc
config.jsonc
.types
types.d.ts
agents
<agent-name>.jsonc
auth
config.jsonc
connectors
<connector-type>.jsonc
entities
<entity-name>.jsonc
functions
<function-name>
entry.ts
function.jsonc
.gitignore
Functions דורשות רק קובץ entry.ts או entry.js. ניתן להוסיף אופציונלית function.jsonc עבור תצורות מתקדמות כמו שמות מותאמים או automations. ראה Backend Functions לפרטים.

​
base44/

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

​
config.jsonc

מגדיר את תצורת הפרויקט שלך, כולל נתיבים ל-entities, functions, agents, connectors, auth config, והגדרות אירוח אתר עבור פרויקטים full-stack. ה-CLI יוצר את זה רק עם שם הפרויקט שלך, ואתה יכול להוסיף תצורה נוספת לפי הצורך. הפרויקט שלך דורש קובץ config.jsonc (או config.json) בתיקיית base44/: 
// 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./entities
functionsDirנתיב לתיקיית functions./functions
agentsDirנתיב לתיקיית agents./agents
connectorsDirנתיב לתיקיית connectors./connectors
authDirנתיב לתיקיית auth config./auth
site.outputDirectoryהיכן נמצאים קבצי האתר הבנויים (חובה לפריסת אתר)—
site.buildCommandמשמש רק במהלך base44 create לפריסה אוטומטית—
site.installCommandמשמש רק במהלך base44 create לפריסה אוטומטית—
site.serveCommandלעיון בלבד. אינו בשימוש כרגע על ידי ה-CLI—
המאפיינים buildCommand, installCommand, ו-serveCommand נכללים אוטומטית כאשר אתה יוצר פרויקט מתבנית ה-full-stack. הם משמשים רק במהלך זרימת base44 create הראשונית עבור פריסה אוטומטית. אינך צריך לציין או לשנות מאפיינים אלה לאחר יצירת הפרויקט. בעת פריסת האתר שלך מאוחר יותר עם site deploy, רק outputDirectory משמש.

​
.app.jsonc

מקשר את הפרויקט המקומי שלך לאפליקציית Base44 שלך. קובץ זה נוצר אוטומטית על ידי ה-CLI כאשר אתה יוצר או מקשר פרויקט. 
// 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",
}
אסור להעלות את קובץ .app.jsonc ל-version control. ה-CLI יוצר אוטומטית קובץ .gitignore המחריג קובץ זה.

​
.types/types.d.ts

הגדרות סוג TypeScript שנוצרו עבור entities, functions, agents ו-connectors שלך. נוצר על ידי הרצת base44 types generate. קובץ זה מספק השלמה אוטומטית ובטיחות סוגים בעת שימוש ב-SDK בפרויקטי TypeScript. ראה Dynamic Types לפרטים נוספים.

​
agents/

תיקייה המכילה תצורות סוכן AI. כל סוכן מוגדר בקובץ .json או .jsonc נפרד.

​
auth/

תיקייה המכילה את תצורת האימות של האפליקציה שלך. מכילה קובץ config.jsonc יחיד המגדיר אילו שיטות התחברות זמינות למשתמשי הקצה שלך. משוך את התצורה הנוכחית מ-Base44 עם auth pull.

​
connectors/

תיקייה המכילה תצורות OAuth connector. כל connector מוגדר בקובץ .json או .jsonc נפרד הנקרא על שם סוג האינטגרציה כמו slack.jsonc או googlecalendar.jsonc.

​
entities/

תיקייה המכילה הגדרות entity schema. כל entity מוגדר בקובץ .json או .jsonc נפרד. צור תיקייה זו כאשר אתה מוכן להגדיר את ה-entity הראשון שלך.

​
functions/

תיקייה המכילה פונקציות בקאנד 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 מותקנים אוטומטית. אלה מופיעים בתיקיות ספציפיות לסוכן כמו .claude/skills/, .cursor/skills/, או דומה, בהתאם לעוזר הקידוד AI שבו אתה משתמש. תיקיות אלה עוזרות לסוכן הקידוד שלך להבין כיצד לעבוד עם Base44 ובטוח להעלות אותן ל-version control.

​
ראה גם

  • Quickstart - Backend only: צור את הפרויקט הראשון שלך של backend-only
  • Quickstart - React: בנה אפליקציית React מסוג full-stack עם Base44
  • types generate command: ייצר types של TypeScript מהפרויקט שלך
  • Dynamic Types: קבל בטיחות סוגים עבור קוד SDK שלך
  • Entities: למד על תצורת schema של מסד הנתונים
  • Backend Functions: צור נקודות קצה API מסוג serverless
  • AI Agents: הגדר סוכני AI עבור האפליקציה שלך
  • Connectors: הגדר חיבורי OAuth לשירותי צד שלישי
  • Auth Config: נהל את שיטות ההתחברות של האפליקציה שלך
דף זה תורגם באמצעות בינה מלאכותית. למידע המדויק והעדכני ביותר, עיין בגרסה האנגלית.