> ## 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.

# Projektstruktúra

> A Base44-projekt felépítése helyi fejlesztéshez

A Base44 CLI [`create`](https://docs.base44.com/developers/references/cli/commands/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](https://docs.base44.com/hu/developers/backend/resources/entities/overview.md), [függvényekhez](https://docs.base44.com/hu/developers/backend/resources/backend-functions/overview.md), [ügynökökhöz](https://docs.base44.com/hu/developers/backend/resources/agents/overview.md), [actorokhoz](https://docs.base44.com/hu/developers/backend/resources/actors/overview.md), [összekötőkhöz](https://docs.base44.com/hu/developers/backend/resources/connectors.md) és a [hitelesítési konfigurációhoz](https://docs.base44.com/hu/developers/backend/resources/auth.md):

**\<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**

> [!NOTE]
>
> 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](https://docs.base44.com/hu/developers/backend/resources/backend-functions/overview.md) 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](https://docs.base44.com/hu/developers/backend/resources/entities/overview.md), a [függvények](https://docs.base44.com/hu/developers/backend/resources/backend-functions/overview.md), az [ügynökök](https://docs.base44.com/hu/developers/backend/resources/agents/overview.md), az [összekötők](https://docs.base44.com/hu/developers/backend/resources/connectors.md) és a [hitelesítési konfiguráció](https://docs.base44.com/hu/developers/backend/resources/auth.md) ú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`](https://docs.base44.com/developers/references/cli/commands/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:

```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",
  "agentSkillsDir": "./agent-skills",
  "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
  },
}
```

| Tulajdonság | Leírás | Alapértelmezés |
| - | - | - |
| `name` | Projektnév (kötelező) | — |
| `description` | Projektleírás | — |
| `visibility` | A közzétett alkalmazás hozzáférési szintje. A `public` értékkel bárki bejelentkezés nélkül megnyithatja, a `private` a meghívott felhasználókra, a `workspace` a munkaterület tagjaira korlátozza a hozzáférést. | — |
| `entitiesDir` | Az [entitások](https://docs.base44.com/hu/developers/backend/resources/entities/overview.md) könyvtárának útvonala | `./entities` |
| `functionsDir` | A [függvények](https://docs.base44.com/hu/developers/backend/resources/backend-functions/overview.md) könyvtárának útvonala | `./functions` |
| `agentsDir` | Az [ügynökök](https://docs.base44.com/hu/developers/backend/resources/agents/overview.md) könyvtárának útvonala | `./agents` |
| `agentSkillsDir` | Az [ügynökskillek](https://docs.base44.com/hu/developers/backend/resources/agents/agent-skills.md) könyvtárának útvonala | `./agent-skills` |
| `actorsDir` | Az [actorok](https://docs.base44.com/hu/developers/backend/resources/actors/overview.md) könyvtárának útvonala | `./actors` |
| `connectorsDir` | Az [összekötők](https://docs.base44.com/hu/developers/backend/resources/connectors.md) könyvtárának útvonala | `./connectors` |
| `authDir` | A [hitelesítési konfiguráció](https://docs.base44.com/hu/developers/backend/resources/auth.md) könyvtárának útvonala | `./auth` |
| `site` | Frontend-konfiguráció. Csak backendet tartalmazó projekteknél hagyja el. | — |
| `site.outputDirectory` | A buildelt webhelyfájlok helye. A [`site deploy`](https://docs.base44.com/developers/references/cli/commands/site-deploy) parancshoz kötelező. A projekt gyökeréből (a `base44/` könyvtárat tartalmazó könyvtárból) oldódik fel, nem a konfigurációs fájlból, mint a fenti könyvtárútvonalak. Ez megegyezik azzal a hellyel, ahová a frontend build eszköze a kimenetét írja. | — |
| `site.buildCommand` | A [`build`](https://docs.base44.com/developers/references/cli/commands/build), [`deploy --build`](https://docs.base44.com/developers/references/cli/commands/deploy), [`site deploy --build`](https://docs.base44.com/developers/references/cli/commands/site-deploy) és az [`eject`](https://docs.base44.com/developers/references/cli/commands/eject) által futtatott parancs, amely a `VITE_BASE44_APP_ID` beinjektálásával fordítja le a webhelyet. | — |
| `site.installCommand` | A [`create`](https://docs.base44.com/developers/references/cli/commands/create), `scaffold` és az [`eject`](https://docs.base44.com/developers/references/cli/commands/eject) által futtatott parancs, amely buildelés előtt telepíti a függőségeket. | — |
| `site.serveCommand` | A [`base44 dev`](https://docs.base44.com/developers/references/cli/commands/dev) által használt parancs, amely a helyi backend mellett elindítja a frontend fejlesztői szervert. | — |

#### .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](https://docs.base44.com/developers/references/cli/commands/introduction.md#select-a-target-app).

```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]
>
> 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`](https://docs.base44.com/developers/references/cli/commands/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](https://docs.base44.com/developers/references/sdk/getting-started/dynamic-types.md).

#### agents/

Az [MI-ügynökök konfigurációit](https://docs.base44.com/hu/developers/backend/resources/agents/overview.md) tartalmazó könyvtár. Minden ügynök külön `.json` vagy `.jsonc` fájlban van definiálva.

#### agent-skills/

Az [ügynökskilleket](https://docs.base44.com/hu/developers/backend/resources/agents/agent-skills.md), 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](https://docs.base44.com/hu/developers/backend/resources/actors/overview.md) 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](https://docs.base44.com/hu/developers/backend/resources/auth.md) 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`](https://docs.base44.com/developers/references/cli/commands/auth-pull) paranccsal kérheti le a Base44-ből.

#### connectors/

Az [OAuth-összekötők konfigurációit](https://docs.base44.com/hu/developers/backend/resources/connectors.md) 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](https://docs.base44.com/hu/developers/backend/resources/entities/overview.md) 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](https://docs.base44.com/hu/developers/backend/resources/backend-functions/overview.md) 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](https://docs.base44.com/hu/developers/backend/overview/skills.md) 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.

> [!NOTE]
>
> Ezek a kódolóasszisztens-skillek elkülönülnek az `agent-skills/` könyvtárban lévő [ügynökskillektől](https://docs.base44.com/hu/developers/backend/resources/agents/agent-skills.md). 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](https://docs.base44.com/hu/developers/backend/quickstart/templates/quickstart-backend-only.md): Az első, csak backendet tartalmazó projekt létrehozása
* [Gyors kezdés – React](https://docs.base44.com/hu/developers/backend/quickstart/templates/quickstart-react-template.md): Full-stack React-alkalmazás építése a Base44-gyel
* [A `types generate` parancs](https://docs.base44.com/developers/references/cli/commands/types-generate): TypeScript-típusok generálása a projektből
* [Dinamikus típusok](https://docs.base44.com/developers/references/sdk/getting-started/dynamic-types.md): Típusbiztonság az SDK-kódhoz
* [Actorok](https://docs.base44.com/hu/developers/backend/resources/actors/overview.md): Megosztott, valós idejű munkamenetek létrehozása
* [Entitások](https://docs.base44.com/hu/developers/backend/resources/entities/overview.md): Az adatbázisséma konfigurálása
* [Backend-függvények](https://docs.base44.com/hu/developers/backend/resources/backend-functions/overview.md): Szerver nélküli API-végpontok létrehozása
* [MI-ügynökök](https://docs.base44.com/hu/developers/backend/resources/agents/overview.md): MI-ügynökök konfigurálása az alkalmazáshoz
* [Összekötők](https://docs.base44.com/hu/developers/backend/resources/connectors.md): OAuth-kapcsolatok beállítása külső szolgáltatásokhoz
* [Hitelesítési konfiguráció](https://docs.base44.com/hu/developers/backend/resources/auth.md): Az alkalmazás bejelentkezési módjainak kezelése

> [!NOTE]
>
> 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](https://docs.base44.com/index.md).


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