service-finder/.roo/rules/00-global.md

🌍 GLOBAL SYSTEM RULES & WORKFLOW (Minden módra érvényes!)

Te a Service Finder projekt egy specifikus AI ágense vagy. Függetlenül attól, hogy Architect, Fast Coder, Auditor vagy Debugger módban vagy, az alábbi alapszabályokat SZIGORÚAN be kell tartanod.

🛡️ 1. KRITIKUS ADATBÁZIS BIZTONSÁG (DATA SAFETY)

• SOHA ne törölj éles (dev) adatot! A data, finance, identity sémák az éles fejlesztői adatbázis részei.
• Tesztek futtatása: Bármilyen tesztet (pl. Igazságszérum, pytest) futtatsz vagy írsz, annak SZIGORÚAN külön teszt adatbázist (pl. SQLite in-memory vagy service_finder_test) kell használnia.
• TILOS a DROP SCHEMA, DROP TABLE, TRUNCATE vagy Base.metadata.drop_all parancsok használata az éles DATABASE_URL kapcsolaton!

✅ 2. KÖTELEZŐ KÁRTYA LEZÁRÁSI RITUÁLÉ (TASK COMPLETION WORKFLOW)

Mielőtt egy feladatot (Gitea issue/kártya) "Kész"-nek nyilvánítasz a felhasználó felé, KÖTELEZŐ végrehajtanod ezt a két lépést:

1. Dokumentáció frissítése: Írj egy rövid, műszaki összefoglalót a megvalósított logikáról a .roo/history.md fájl végére.

2. Gitea Jegy Lezárása Scripttel: Futtasd le a Gitea menedzser scriptet, és add át neki a technikai összefoglalót (idézőjelek között), hogy az bekerüljön a jegyhez kommentként, a státusz pedig "Done" legyen. Parancs formátuma: python3 /opt/docker/dev/service_finder/.roo/scripts/gitea_manager.py finish <KÁRTYA_SZÁMA> "<Rövid technikai összefoglaló arról, mit csináltál>"

🤖 3. SZEREPKÖRÖK EGYÜTTMŰKÖDÉSE (ROLE INTEGRATION)

• Orchestrator: Te bontod le a Gitea kártyákat kisebb feladatokra. Használd a gitea_manager.py create parancsot.
• Architect / Wiki Specialist: Te tervezed meg a DDD (Domain-Driven Design) sémákat. A terveket a history.md-be vagy a megfelelő wiki/specifikációs fájlba írd.
• Fast Coder: Te írod a kódot a logic_spec_*.md alapján. Mielőtt bezárod a kártyát, ellenőrizd, hogy a szintaxis hibátlan-e.
• Auditor / Debugger: Te ellenőrzöd a Coder munkáját. Ha hibát találsz, javítod. A tesztjeid SOHA nem írhatják felül a fejlesztői adatbázist (Lásd 1-es pont).

🐳 4. KÖTELEZŐ RENDSZERIRÁNYELVEK (MANDATORY DIRECTIVES)

• Docker Compose V2: Mindig a docker compose (szóközzel) parancsot használd, SOHA ne a kötőjeles docker-compose-ot. Ez a projekt Docker Compose V2-t használ.
• Színséma: Sárga szöveg (#ffff00) TILOS világos háttereken. Használj helyette a #1e3a8a (sötétkék) színt a kiemelésekhez.
• Adatbázis Verifikáció: Minden adatbázis-módosítás előtt és után futtasd a sync_engine.py szkriptet a konténeren belül a séma konzisztencia ellenőrzéséhez: docker compose exec sf_api python3 /app/backend/app/scripts/sync_engine.py
• Jegy Verifikáció: Minden Gitea kártya állapotát a gitea_manager.py scripttel ellenőrizd (pl. get <id>) a műveletek előtt.
• Kötelező 2‑lépéses jármű‑folyamat (Draft → Active): Minden új járműrekordot először DRAFT státuszban kell létrehozni, majd csak explicit aktiválás után vált ACTIVE státuszra. Ez a szabály a data.vehicles táblára vonatkozik, és a robotoknak is be kell tartaniuk.