2026.06.04 frontend építés közben

.roo/rules/00_system_manifest.md

@@ -15,20 +15,31 @@
 - **Project:** Master Book 2.0
 
 . ELÉRHETŐ GITEA PARANCSOK:
-- LISTÁZÁS: 'docker exec sf_api python3 /scripts/gitea_manager.py list'
-- RÉSZLETEK: 'docker exec sf_api python3 /scripts/gitea_manager.py get <issue_id>'
-- INDÍTÁS: 'docker exec sf_api python3 /scripts/gitea_manager.py start <issue_id>'
-- LEZÁRÁS: 'docker exec sf_api python3 /scripts/gitea_manager.py finish <issue_id>'
-- FRISSÍTÉS (ÚJ!): 'docker exec sf_api python3 /scripts/gitea_manager.py update <issue_id> --title "Új cím" --body "Új leírás"'
+- LISTÁZÁS: 'docker exec roo-helper python3 /scripts/gitea_manager.py list'
+- RÉSZLETEK: 'docker exec roo-helper python3 /scripts/gitea_manager.py get <issue_id>'
+- INDÍTÁS: 'docker exec roo-helper python3 /scripts/gitea_manager.py start <issue_id>'
+- LEZÁRÁS: 'docker exec roo-helper python3 /scripts/gitea_manager.py finish <issue_id>'
+- FRISSÍTÉS (ÚJ!): 'docker exec roo-helper python3 /scripts/gitea_manager.py update <issue_id> --title "Új cím" --body "Új leírás"'
 
 
-# 🛠️ TERMINÁL HASZNÁLATI SZABÁLYOK (KRITIKUS)
-1. **Helyi környezet korlátja:** A helyi terminálban NINCS Python, NINCS adatbázis elérés. SOHA ne futtass közvetlen parancsokat (pl. `python ...`, `pip ...`, `pytest ...`).
-2. **Kötelező prefix:** Minden végrehajtandó parancsot a `docker compose exec sf_api` előtaggal kell futtatnod.
-3. **Munkakönyvtár kezelése:** Ha a parancsot egy alkönyvtárban kell futtatni, azt a konténeren belül tedd meg.
-   - **Hibás:** `cd backend && python -m app.scripts...`
-   - **Helyes:** `docker compose exec sf_api /bin/sh -c "cd /app/backend && python3 -m app.scripts.unified_db_audit"`
+🛠️ TERMINÁL HASZNÁLATI SZABÁLYOK (KRITIKUS)
 
+A projekt hibrid architektúrával működik. Szigorúan különbséget kell tenned a Backend és a Frontend parancsok futtatási helye között!
+
+1. **BACKEND Parancsok (Python, Adatbázis, Robotok):**
+   - A helyi gép termináljában NINCS Python környezet beállítva ezekhez.
+   - Minden backend parancsot KÖTELEZŐ a konténeren belül futtatni a `docker compose exec sf_api` előtaggal!
+   - *Helyes:* `docker compose exec sf_api python3 -m app.scripts.sync_engine`
+
+2. **FRONTEND Parancsok (Vue, Vite, Playwright):**
+   - Ezeket a helyi gép termináljában kell futtatni, a `/opt/docker/dev/service_finder/frontend` mappában!
+   - Kódolás/tesztelés előtt mindig lépj be a mappába: `cd frontend`
+   - konténer neve: sf_public_frontend
+   - *Helyes teszt indítás:* `npm run dev -- --host 0.0.0.0` majd új terminálban `npx playwright test`
+
+3. **Munkakönyvtár kezelése konténerben:** Ha a parancsot egy alkönyvtárban kell futtatni a konténeren belül, használd a `/bin/sh -c` szintaxist:
+   - *Helyes:* `docker compose exec sf_api /bin/sh -c "cd /app/backend && python3 ..."`
+   
 #   CRITICAL DATABASE SYNC RULE:
 NEVER use alembic upgrade head or try to resolve Alembic migration conflicts manually unless explicitly instructed. The Masterbook 2.0.1 architecture uses a custom synchronization engine.
 To apply database schema changes based on SQLAlchemy models, ALWAYS use:

.roo/rules/04-debug-protocol.md

@@ -10,4 +10,19 @@ Soha ne találgass! A hibakeresés nálunk tényalapú és szisztematikus. Ha va
    - Ha a logok szerint a módosított kód nem frissült, AZONNAL ellenőrizd a `docker-compose.yml` volume beállításait.
    - Ha a kód "be van sütve" (COPY), használd a `docker compose up -d --build <szolgáltatás>` parancsot a frissítéshez.
 3. **SQL Trace & Adatbázis Audit:**
-   - Adatbázis hiba (pl. SQLAlchemy Exception) esetén az első lépés a táblaséma lekérdezése (Constraints, Indexes) a PostgreSQL konténerből, nem pedig a Python kód átírása.
+   - Adatbázis hiba (pl. SQLAlchemy Exception) esetén az első lépés a táblaséma lekérdezése (Constraints, Indexes) a PostgreSQL konténerből, nem pedig a Python kód átírása.
+
+   ## 🕵️‍♂️ A Hibakeresés Kötelező Lépései:
+
+### Backend és Adatbázis Hibák Esetén:
+1. **Log-First Megközelítés:** Első lépés mindig a konténer logjainak lekérése: `docker compose logs --tail 100 -f <konténer_neve>`.
+2. **Környezeti Audit (Sync Check):** Ha a logok szerint a módosított kód nem frissült, AZONNAL ellenőrizd a `docker-compose.yml` volume beállításait, vagy építsd újra a konténert.
+3. **SQL Trace & Adatbázis Audit:** Adatbázis hiba (pl. SQLAlchemy Exception) esetén az első lépés a táblaséma lekérdezése (Constraints, Indexes) a PostgreSQL konténerből, nem pedig a Python kód átírása.
+
+### Frontend és Távoli Tesztelési Hibák Esetén (UI/E2E):
+Soha ne találgass vizuális vagy frontend API hibáknál! A tesztek a távoli `faktor01` szerveren futnak, így a hálózat is okozhat hibát.
+1. **Playwright Artifacts:** Ha egy E2E teszt elbukik, AZONNAL olvasd be a hiba stack trace-t és a legutóbbi képernyőfotót (screenshot) a `frontend/test-results/` mappából. Keresd a szétcsúszott komponenseket vagy a "Timeout" hibákat.
+2. **Hálózati Vakfoltok (CORS & Proxy):** Ha a távoli böngésző "Failed to fetch" vagy "Network Error" hibát kap a frontenden:
+   - Ellenőrizd a `frontend/.env` fájlban a `VITE_API_BASE_URL` értékét.
+   - Ellenőrizd a `vite.config.ts` proxy beállításait. A frontend kéréseknek a helyi proxy-n keresztül kell elérniük a backendet.
+3. **Távoli Böngésző Állapota:** Ha a Playwright WebSocket hibaüzenetet ad (pl. nem tud csatlakozni a ws:// hálózathoz), tilos a kódot módosítani! Jelezd a felhasználónak, hogy a távoli Docker konténer valószínűleg leállt a faktor01 szerveren.