2026.06.04 frontend építés közben

This commit is contained in:
Roo
2026-06-04 07:26:22 +00:00
parent 7adf6cc3e3
commit 59a30ac428
3302 changed files with 24091 additions and 1771 deletions

View File

@@ -11,6 +11,19 @@
- Minden folyamatot dedikált log fájlokba naplózz.
- A kód elkészítése után futtass ellenőrzést. Ha hiba van, jelezd a Debuggernek vagy kérj segítséget az Architecttől.
## 🌐 Frontend Fejlesztési és Távoli Tesztelési Protokoll (KÖTELEZŐ)
A frontend (Vue 3 / Vite) fejlesztése során SZIGORÚAN TILOS helyi böngészős tesztelést vagy helyi hálózati pingelést szimulálni. A tesztelés kizárólag a távoli, Headless Chrome szerveren keresztül történhet.
1. **A Vite Szerver Indítása:** Amikor UI kódot módosítasz, és tesztelni kell, a helyi fejlesztői szervert úgy kell elindítanod, hogy a külső tesztgép lássa:
`npm run dev -- --host 0.0.0.0`
2. **A Távoli E2E Teszt (Playwright) Indítása:**
A teszteléshez futtasd a Playwright-ot a projekt frontend mappájában:
`npx playwright test`
*(A rendszer már be van állítva, hogy a WebSocket kapcsolaton keresztül a `faktor01` szerver 3030-as portját használja a teszteléshez).*
3. **Teszt Értékelése:**
- Ha a teszt zöld (Pass), a kód mehet tovább a Gitea jegy lezárása felé.
- Ha a teszt elbukik (Fail), kötelező beolvasnod a Playwright által generált hibaüzeneteket és képernyőfotókat (screenshots) a `test-results/` mappából, mielőtt kódot módosítanál.
## 🔍 Hibakeresési Protokoll (Debug Protocol)
Soha ne találgass! A hibakeresés tényalapú és szisztematikus. Ha valami nem működik, tilos azonnal átírni a kódot. Előbb diagnosztizálj!
@@ -27,4 +40,5 @@ Soha ne találgass! A hibakeresés tényalapú és szisztematikus. Ha valami nem
- **Pydantic Validáció:** Minden bemeneti/kimeneti adathoz használj Pydantic modelleket (`BaseModel`). A validáció legyen részletes és tartalmazza a custom validátorokat a domain szabályokhoz.
- **Frontend Integráció:** Az API végpontoknak követniük kell a REST konvenciókat és biztosítaniuk kell a frontend számára szükséges adatokat (pl. pagination, filtering, sorting). Használd a `fastapi.Query`, `fastapi.Path`, `fastapi.Body` paramétereket.
- **Aszinkron Műveletek:** Minden I/O művelet legyen `async` és `await`-el hívd meg a megfelelő service függvényeket.
- **Hibakezelés:** Használd a `HTTPException`-t specifikus státuszkódokkal és részletes hibaüzenetekkel. Naplózd a hibákat a rendszer loggerén keresztül.
- **Hibakezelés:** Használd a `HTTPException`-t specifikus státuszkódokkal és részletes hibaüzenetekkel. Naplózd a hibákat a rendszer loggerén keresztül.