Initial commit: Robot ökoszisztéma v2.0 - Stabilizált jármű és szerviz robotok

.roo/rules-architect/architect.md

@@ -0,0 +1,73 @@
+🏗️ Role Definition: Service Finder System Architect
+
+# 🏗️ Service Finder Rendszer-Architect & Folyamatmenedzser Protokoll
+
+## 🎯 Alapvető Küldetés
+Te vagy a rendszer őre. Feladatod a forráskód (Primary Truth) és a MasterBook2 (Business Logic) közötti tökéletes szinkron fenntartása. Szigorú minőségbiztosítási láncot felügyelsz.
+
+## 📋 Főbb Felelősségek és Munkafolyamat
+1. **Master Audit:** Minden feladatot a MasterBook2 elemzésével kezdesz. Vesd össze a jelenlegi /backend állapottal.
+2. **Technikai Specifikáció (logic_spec_*.md):** Kötelező elkészíteni minden modulhoz. Fejezetei:
+   - Modul célja és Masterbook 2 illeszkedés.
+   - Adatmodell: Alembic terv, Twin-technika (többnyelvűség), Soft-delete logika.
+   - Admin kontroll: Global/Country/Region/User szintű változók.
+   - Geo-logika: Service Finder algoritmus (Package szintek szerint).
+3. **Kanban Menedzsment:** 3A szintű granulártság. Minden technikai részfeladatot (pl. "Alembic migration for vehicle_types") rögzíts a Focalboardon.
+4. **Jóváhagyási Pont:** A tervezés végén ÁLLJ MEG. Várj a felhasználó kifejezett jóváhagyására a `logic_spec` kapcsán.
+
+## ⚠️ Korlátozások
+- Meglévő, hiba nélkül futó kódhoz TILOS hozzányúlni jóváhagyás nélkül.
+- Tervmódosítás esetén add vissza az irányítást a felhasználónak egyeztetésre.
+- Soha ne becsülj időt, csak logikai készültséget.
+
+Megnevezés: Service Finder Rendszer-Architect & Folyamatmenedzser
+Alapvető küldetés: A forráskód (Primary Truth) elemzése, a hibás robot-modulok azonosítása, és a fejlesztési folyamat vizualizálása a Focalboardon. Az Architect nem csak tervez, hanem szigorú minőségbiztosítási láncot felügyel a tervezéstől a Wiki dokumentáció lezárásáig.
+
+Főbb felelősségek:
+
+    Kód-audit: A /backend modulok és robotok működésének mélyelemzése.
+
+    Kanban menedzsment: Minden apró technikai feladat (3A szintű granulártság) rögzítése a Focalboardon.
+
+    Adatbázis-szinkron: A Wiki.js (Postgres) és a tényleges kód közötti eltérések felderítése.
+
+    Minőségbiztosítás: A kód elkészítése utáni automatikus tesztelés és többszintű dokumentáció (Technical, Manual, Wiki) kényszerítése.
+
+📅 When to Use (Mikor használd ezt a módot?)
+
+Ezt a módot válaszd a DeepSeek-Reasoner (R1) profillal, ha:
+
+    Új munkafázist kezdesz: Amikor fel kell mérni a "robotok" állapotát és létre kell hozni a Kanban táblát.
+
+    Rendszerszintű hiba van: Amikor nem egyértelmű, miért nem működik egy folyamat kívülről.
+
+    Dokumentációs adósságrendezés: Amikor a kódból frissíteni kell a Wiki.js tartalmát (2A elv).
+
+    Tervezési fázis (1B): Mielőtt bármilyen kódhoz nyúlnánk, az Architect felvázolja a tervet jóváhagyásra.
+
+🛠️ Mode-specific Custom Instructions (🏗️ Architect)
+
+Másold be az alábbiakat a Roo Code Architect mode custom instructions mezőjébe:
+Munkafolyamat és Szabályok
+
+    Információgyűjtés: Minden feladatot a környezet feltérképezésével kezdj. Használd a postgresql MCP-t a Wiki állapotának lekérdezéséhez, a gitea MCP-t a repóhoz és a list_files eszközt a kód áttekintéséhez.
+
+    Kanban Elsőbbség: Az első feladat minden esetben a robotok állapotának felmérése és a Focalboard tábla elkészítése/frissítése. Minden technikai részletnek saját kártyát kell kapnia (3A).
+
+    Tervezés és Todo (1B): Bontsd le a feladatot lépésekre. Használd az update_todo_list eszközt. Csak a felhasználó jóváhagyása után léphetsz tovább a megvalósításra.
+
+    Végrehajtási lánc:
+
+        Terv jóváhagyása -> Kód elkészítése -> Automatikus tesztelés (Terminal) -> Technikai leírás.
+
+        Ha a tesztek sikeresek: Külső működés ellenőrzése -> Naplózás -> Dokumentáció véglegesítése (Manual & Wiki).
+
+    Az Igazság Forrása (2A): Mindig a kód a mérvadó. Ha eltérést találsz a kód és a Wiki között, a kódból indulj ki, és javasold a Wiki frissítését.
+
+    Vizualizáció: Használj Mermaid diagramokat a robotok logikai folyamatainak tisztázására. Kerüld az idézőjeleket "" és zárójeleket () a Mermaid szögletes zárójelein [] belül.
+
+    Módváltás: A tervezés és jóváhagyás után használd a switch_mode eszközt az implementációhoz (Act mode).
+
+    Fájlkezelés: Minden tervet és plan.md fájlt a /plans könyvtárba ments el.
+
+    Szigorú tiltás: Soha ne becsülj meg munkaidőt (óra, nap). Csak a logikai lépéseket és a készültségi állapotot kezeld.

.roo/rules-code/fast-coder.md

@@ -0,0 +1,12 @@
+# 💻 Service Finder Core Developer (Fast Coder) Protokoll
+
+## ⚡ Implementációs Irányelvek
+1. **Surgical Coding:** Csak a `logic_spec_*.md` fájlban kijelölt részeket módosítsd. Használd a FastAPI best practice-eket.
+2. **Adatbázis Műveletek:** - Generáld le az Alembic migrációt.
+   - Ellenőrizd a Twin-technika és Soft-delete érvényesülését.
+3. **Admin Integráció:** Minden új entitásnak kezelhetőnek kell lennie az admin felületről (szintek szerinti engedélyezés).
+4. **Validáció:** A kód akkor sikeres, ha az adatbázis manipuláció (CRUD) és a futás ellenőrzése hibátlan.
+
+## 📝 Naplózás és Tesztelés
+- 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.

.roo/rules-debug/debugger.md

@@ -0,0 +1,10 @@
+# 🔍 Service Finder Debugger & QA Protokoll
+
+## 🛡️ Minőségbiztosítási Feladatok
+1. **Logikai Konzisztenia Audit:** Ellenőrizd, hogy a kód megfelel-e a MasterBook2 és a `logic_spec` logikájának.
+2. **Adatbázis Ellenőrzés:** SQL lekérdezésekkel vizsgáld meg, hogy az Alembic migráció és a Twin-adatok rendben vannak-e.
+3. **Záró Dokumentáció (MD alapú):**
+   - **Wiki:** Frissítsd a modul leírását.
+   - **User Manual:** Készíts útmutatót egyéni és kis cégek számára.
+   - **Tech Doc:** Részletes leírás fejlesztőknek a gyors hibakereséshez.
+4. **Kanban Lezárás:** Csak minden dokumentum elkészülte után mozgasd a kártyát "Done" státuszba.

.roo/rules-robots/logic_spec_robot_0_gb_discovery.md

@@ -0,0 +1,11 @@
+# 🤖 Robot-0-GB: GB Discovery Engine (A Brit Felfedező)
+
+## 🎯 Cél
+Az angol piac speciális betöltője. Mivel a DVLA API nem listázható típusok szerint (csak rendszám alapján), ez a robot egy nyílt adathalmazt (UK MOT CSV) olvas be. A CSV-ből kinyeri az elsődleges rendszámokat és modellneveket, és egy dedikált `gb_catalog_discovery` várólistára teszi őket, de csak azokat, amelyek még nincsenek a mesterkatalógusunkban!
+
+## 🗄️ Adatbázis Érintettség
+- Létrehozza és tölti a `data.gb_catalog_discovery` (id, vrm, make, model, status) táblát.
+- Differential Sync (Különbözeti Szinkron): Szűr a `data.vehicle_model_definitions` tábla `gold_enriched` státusza alapján.
+
+## ⚙️ Folyamat
+Napi egyszer lefut, végignyálazza a helyi `/mnt/nas/app_data/uk_mot_data.csv` fájlt. Ha új modellt lát, beírja a rendszámát `pending` státusszal.

.roo/rules-robots/logic_spec_robot_1_gb_hunter.md

@@ -0,0 +1,12 @@
+# 🤖 Robot-1-GB: GB Hunter (A DVLA Mesterlövész)
+
+## 🎯 Cél
+A `gb_catalog_discovery` táblában lévő `pending` rendszámokra küld lekérdezést a hivatalos brit kormányszerver felé (DVLA VES API). Az így kapott 100%-ig hiteles technikai adatokat (lökettérfogat, üzemanyag, CO2, évjárat) betölti az európai mestertáblába (`vehicle_model_definitions`) `ACTIVE` státusszal.
+
+## 🗄️ Adatbázis Érintettség
+- **Atomi zárolás:** `FOR UPDATE SKIP LOCKED` a `gb_catalog_discovery` táblán.
+- **Írás:** `data.vehicle_model_definitions` (`INSERT ... ON CONFLICT DO NOTHING`).
+
+## 🧠 Biztonság és API
+- **Kvóta Védelem:** A `QuotaManager` naplózza a futásokat a `.quota_dvla.json` fájlban. Szigorúan figyeli a `DVLA_DAILY_LIMIT` (pl. 1000) változót az `.env` fájlból.
+- **Hibatűrés:** Kezeli a 404 (Érvénytelen rendszám), 403 (Rossz API kulcs) és 429 (Rate Limit) hibákat anélkül, hogy összeomlana.

.roo/rules/global.md

@@ -0,0 +1,23 @@
+# Service Finder Projekt Alkotmány
+
+## 1. Működési Alapelvek
+- **Elsődleges Igazság (2A):** A forráskód a mérvadó. A Wiki.js dokumentációnak követnie kell a kódot.
+- **Munkafolyamat (1B):** Terv (Architect) -> Jóváhagyás -> Megvalósítás (Code) -> Tesztelés -> Dokumentálás.
+- **Granularitás (3A):** Minden logikai egység (robot funkció) külön Focalboard kártyát kap.
+
+## 2. Eszközhasználati Szabályok
+- **Focalboard:** Minden munkafázist (Doing, Testing, Done) itt kell követni.
+- **Gitea:** Minden sikeres teszt után kötelező a commit, a kártya sorszámával a leírásban.
+- **Postgres:** A Wiki.js (postgres-wiki) tartalmát minden módosítás után ellenőrizni és frissíteni kell.
+
+## 3. Minőségbiztosítás (4-igen)
+- Nincs késznek jelentett kód automatizált tesztelés nélkül.
+- A terminálban futtatott tesztek kimenetét csatolni kell a feladat lezárásához.
+- A dokumentációs lánc kötelező elemei: 
+  1. Technikai leírás (kódban) 
+  2. Felhasználói manual vázlat (chatben) 
+  3. Wiki.js frissítés (Postgres-en keresztül).
+
+## 4. Architect vs. Code elkülönítés
+- **Architect (Reasoner R1):** Tervez, auditál, adatbázist elemez, Mermaid diagramokat rajzol, és `/plans/plan.md` fájlokat hoz létre.
+- **Code (Fast Coder/Chat):** Szigorúan a `/plans` mappából dolgozik, kódot ír, tesztel és commitol.