Ugrás a fő tartalomhoz
A Base44 CLI create parancsa az összes szükséges fájllal és konfigurációval hoz létre új projekteket. Ez a cikk a Base44 backend projekt felépítését ismerteti, és elmagyarázza, mire való az egyes fájlok és könyvtárak.

A backend projekt felépítése

Csak backendet tartalmazó Base44-projekt létrehozásakor a CLI ezt a minimális struktúrát hozza létre:
<your-project-name>
base44
.app.jsonc
config.jsonc
.gitignore
A projekt fejlesztése során fájlokat ad hozzá az erőforrásokhoz, például entitásokhoz, függvényekhez, ügynökökhöz, actorokhoz, összekötőkhöz és a hitelesítési konfigurációhoz:
<your-project-name>
base44
.app.jsonc
config.jsonc
.types
types.d.ts
agents
<agent-name>.jsonc
agent-skills
<skill-name>.md
actors
<actor-name>
entry.ts
auth
config.jsonc
connectors
<connector-type>.jsonc
entities
<entity-name>.jsonc
functions
<function-name>
entry.ts
function.jsonc
.gitignore
A függvényekhez csak egy entry.ts vagy entry.js fájl szükséges. Haladó konfigurációkhoz, például egyéni nevekhez, opcionálisan function.jsonc fájlt is hozzáadhat. A részleteket a Backend-függvények oldalon találja.

base44/

Az összes Base44 backend-konfigurációt és erőforrás-definíciót tartalmazza.

config.jsonc

A projekt konfigurációját határozza meg, beleértve az entitások, a függvények, az ügynökök, az összekötők és a hitelesítési konfiguráció útvonalait, valamint full-stack projekteknél a webhelytárhely beállításait. A CLI csak a projekt nevével hozza létre, és szükség szerint további konfigurációt adhat hozzá. Ha itt be van állítva a visibility, a deploy minden futtatáskor alkalmazza a szerveren. A projekthez egy config.jsonc (vagy config.json) fájl szükséges a base44/ könyvtárban:

.app.jsonc

Összekapcsolja a helyi projektet a Base44-alkalmazással. Ezt a fájlt a CLI automatikusan létrehozza projekt létrehozásakor vagy összekapcsolásakor. Az egyes CLI-parancsok az --app-id kapcsolóval vagy a BASE44_APP_ID környezeti változóval felülírhatják ezt az alapértelmezést. Lásd: Célalkalmazás kiválasztása.
Az .app.jsonc fájlt ne véglegesítse a verziókezelőben. A CLI automatikusan létrehoz egy .gitignore fájlt, amely kizárja.

.types/types.d.ts

Generált TypeScript-típusdefiníciók az entitásokhoz, függvényekhez, ügynökökhöz, actorokhoz és összekötőkhöz. A base44 types generate parancs futtatása hozza létre. A fájl automatikus kiegészítést és típusbiztonságot biztosít, amikor az SDK-t TypeScript-projektekben használja. További részletek: Dinamikus típusok.

agents/

Az MI-ügynökök konfigurációit tartalmazó könyvtár. Minden ügynök külön .json vagy .jsonc fájlban van definiálva.

agent-skills/

Az ügynökskilleket, vagyis az alkalmazás ügynökeiben futó újrahasználható utasításkészleteket tartalmazó könyvtár. Minden skill külön Markdown-fájl, amelynek neve a skill neve, előtétben description mezővel és utasítástörzzsel. Ezek az alkalmazás ügynökeinek futásidejű skilljei, nem az alább leírt MI-kódolóasszisztens-skillek.

actors/

A megosztott, valós idejű munkamenetekhez használt actorokat tartalmazó könyvtár. Minden actornak saját alkönyvtára van egy entry.ts fájllal, amely alapértelmezett exportként exportálja az actorosztályt. Az alkönyvtár neve lesz az actor neve az SDK-ban.

auth/

Az alkalmazás hitelesítési konfigurációját tartalmazó könyvtár. Egyetlen config.jsonc fájlt tartalmaz, amely meghatározza, mely bejelentkezési módok érhetők el a végfelhasználók számára. Az aktuális konfigurációt az auth pull paranccsal kérheti le a Base44-ből.

connectors/

Az OAuth-összekötők konfigurációit tartalmazó könyvtár. Minden összekötő külön .json vagy .jsonc fájlban van definiálva, amelynek neve az integráció típusa, például slack.jsonc vagy googlecalendar.jsonc.

entities/

Az entitássémák definícióit tartalmazó könyvtár. Minden entitás külön .json vagy .jsonc fájlban van definiálva. Akkor hozza létre ezt a könyvtárat, amikor definiálni szeretné az első entitást.

functions/

A szerver nélküli backend-függvényeket tartalmazó könyvtár. Minden függvénynek saját alkönyvtár kell egy entry.ts vagy entry.js kódfájllal. A CLI a függvények gyökeréhez viszonyított könyvtárútvonalat használja függvénynévként. A functions/sendEmail/entry.ts például sendEmail nevű függvényt hoz létre. A függvény nevének testreszabásához vagy automatizálások hozzáadásához opcionálisan function.jsonc konfigurációs fájlt is megadhat.
functions
<function-name>
entry.ts
function.jsonc

.gitignore

Megakadályozza, hogy bizonyos fájlok bekerüljenek a verziókezelőbe. A projekt ezzel a fájllal indul, hogy az .app.jsonc ne kerüljön véglegesítésre.

MI-kódolóasszisztens-skillek

Ha a base44 create paranccsal hoz létre projektet, a Base44 skillek automatikusan települnek. Az asszisztensre jellemző mappákban jelennek meg, például .claude/skills/, .cursor/skills/ vagy hasonló, attól függően, melyik MI-kódolóasszisztenst használja. Ezek a mappák segítenek a kódolóasszisztensnek megérteni, hogyan dolgozzon a Base44-gyel, és nyugodtan véglegesítheti őket a verziókezelőben.
Ezek a kódolóasszisztens-skillek elkülönülnek az agent-skills/ könyvtárban lévő ügynökskillektől. A kódolóasszisztens-skillek az olyan eszközöket segítik az alkalmazás építésében, mint a Claude és a Cursor, az ügynökskillek pedig az alkalmazás ügynökeiben futnak.

Lásd még

Ezt az oldalt MI segítségével fordítottuk. A legpontosabb és legfrissebb információkért tekintse meg az angol nyelvű változatot.