Fejlesztői Dokumentáció¶

Ez a dokumentáció a FormFiller rendszer fejlesztőinek szól.

Tartalom¶

Általános¶

Backend Fejlesztés - Backend architektúra és fejlesztési útmutató
Frontend Fejlesztés - Frontend architektúra, hívási láncok, előnyök
Schema és Típusok - Low-code definíciós nyelv, közös típusok

API és Integráció¶

API Referencia - REST API dokumentáció
Eseménykezelés - Deklaratív eseménykezelő rendszer

Komponensek¶

Form Komponensek - Űrlap komponensek és rendererek
Validáció - Validációs rendszer, group validátorok, computedRules

Funkciók (részletes)¶

Felhasználó Kezelés - Regisztráció, bejelentkezés, profil, token kezelés
Jogosultságkezelés (RBAC) - Szerepkörök, engedélyek, UI szűrés
Multisite Kezelés - Több bérlős működés, site kontextus
Téma és Lokalizáció - Témák, többnyelvűség, i18n
Workflow Kezelés - Üzleti folyamatok, step típusok, hibakezelés
Adatkezelés - Mentés, lekérdezés, exportálás, save limit
🤖 AI Interfész - Működő funkció! Természetes nyelvű generálás, ~98% időmegtakarítás

Fejlesztői Környezet Beállítása¶

Előfeltételek¶

Node.js 18+
MongoDB 4.4+ (lokálisan vagy Docker-ben)
Git

Repók Klónozása¶

# Fő könyvtár létrehozása
mkdir formfiller && cd formfiller

# Repók klónozása
git clone <repo-url>/formfiller-backend
git clone <repo-url>/formfiller-frontend
git clone <repo-url>/formfiller-schema
git clone <repo-url>/formfiller-validator
git clone <repo-url>/formfiller-types
git clone <repo-url>/formfiller-deployment

Schema Beállítása (első)¶

cd formfiller-schema
npm install
npm run build
npm run distribute  # Disztribúció a többi projektbe

Backend Indítása¶

cd formfiller-backend
npm install
cp env.example .env
# Szerkeszd a .env fájlt
npm run dev

Frontend Indítása¶

cd formfiller-frontend
npm install
cp .env.development.example .env.development
npm start

Fejlesztési Gyakorlatok¶

Kód Stílus¶

TypeScript strict mode
ESLint és Prettier használata
Angol nyelvű kommentek és változónevek

Git Workflow¶

Feature branch létrehozása: feature/feature-name
Commit message formátum: type: description
feat: - Új funkció
fix: - Hibajavítás
docs: - Dokumentáció
refactor: - Kód átszervezés
test: - Tesztek
Pull request a develop branch-be

Tesztelés¶

# Backend tesztek
cd formfiller-backend
npm test

# Frontend tesztek
cd formfiller-frontend
npm test

# Validator tesztek
cd formfiller-validator
npm test

Hibaelhárítás¶

MongoDB Kapcsolat¶

Ha a MongoDB nem elérhető:

# Docker-rel
docker run -d -p 27017:27017 --name mongodb mongo:7

# Vagy brew-vel (macOS)
brew services start mongodb-community

Schema Változások¶

Ha a schema módosult, újra kell disztributálni:

cd formfiller-schema
npm run distribute
# Majd újraindítás a backend és frontend projektekben

Port Ütközések¶

Backend: 3001 (módosítható .env-ben)
Frontend: 3000 (módosítható vite.config.ts-ben)
MongoDB: 27017
Redis: 6379 (opcionális)