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
<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 avisibility, 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. Abase44 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étbendescription 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 egyentry.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. Egyetlenconfig.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 egyentry.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 abase44 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
- Gyors kezdés – Csak backend: Az első, csak backendet tartalmazó projekt létrehozása
- Gyors kezdés – React: Full-stack React-alkalmazás építése a Base44-gyel
- A
types generateparancs: TypeScript-típusok generálása a projektből - Dinamikus típusok: Típusbiztonság az SDK-kódhoz
- Actorok: Megosztott, valós idejű munkamenetek létrehozása
- Entitások: Az adatbázisséma konfigurálása
- Backend-függvények: Szerver nélküli API-végpontok létrehozása
- MI-ügynökök: MI-ügynökök konfigurálása az alkalmazáshoz
- Összekötők: OAuth-kapcsolatok beállítása külső szolgáltatásokhoz
- Hitelesítési konfiguráció: Az alkalmazás bejelentkezési módjainak kezelése
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.