refaktorálás javításai

docs/v02/10_Economy_Social.md

@@ -0,0 +1,24 @@
+🏛️ SERVICE FINDER - ECONOMY MANIFEST (V1.0)
+1. A Négyes Tárca Rendszer (Quadruple Wallet)
+
+Minden tranzakciónak rögzítenie kell a forrást és a cél-tárcát.
+Tárca	Megnevezés	Jellemzők	Korlátozás
+W1	Purchased	Fiat/Crypto befizetés.	NEM használható szervizre.
+W2	Earned	Rendszer-jutalék, elvégzett munka.	Kifizetés limithez kötött.
+W3	Service Coin	B2B feltöltés (Szolgáltatók).	Csak hirdetés/rangsorolás.
+W4	Voucher	Promóció, kártérítés.	Lejárati idő + Automatikus törlés.
+2. Kibocsátói Logika (Issuer Load Balancer - "Vetésforgó")
+
+A rendszer automatikusan dönt, ki állítja ki a bizonylatot:
+
+    EV (Alanyi mentes): Ha a vevő magánszemély/nem ÁFA-körös EV ÉS a cég éves bevétele < revenue_limit.
+
+    Kft (ÁFÁ-s): Minden egyéb esetben (Céges vásárlás, EU-s adóalany, vagy ha az EV keret betelt).
+
+3. Technikai Alapelvek
+
+    Adapter Pattern: A fizetési (Stripe/Crypto) és számlázó (Számlázz.hu/Billingo) szolgáltatók modulárisak.
+
+    Double-Entry Ledger: Minden mozgás naplózva: Ledger Entry -> Wallet Update -> Invoice Trigger.
+
+    RBAC-szintű védelem: Csak FINANCE_ADMIN vagy SUPERUSER módosíthatja az Issuer kereteket vagy az árfolyamokat.

docs/v02/epic5_robot_audit_2026-03-12.md

@@ -0,0 +1,29 @@
+# Epic 5 Audit: Robotok védelmi hiányosságai
+
+## Áttekintés
+Az audit célja a Master Data & Robot Ecosystem (Epic 5) aktuális állapotának felmérése, különös tekintettel a #27, #28, #29 Gitea kártyákban megfogalmazott követelményekre.
+
+## Feltérképezett fájlok
+- `backend/app/workers/vehicle/vehicle_robot_2_researcher.py`
+- `backend/app/workers/vehicle/vehicle_robot_3_alchemist_pro.py`
+- `backend/app/models/vehicle_definitions.py`
+
+## #27 – Manuális felülírás elleni védelem
+**Állapot: HIÁNYOS**  
+A `vehicle_robot_3_alchemist_pro.py` SELECT lekérdezése (175–190 sor) nem szűr az `is_manual` mezőre. A `vehicle_model_definitions` táblában létezik az `is_manual` logikai mező (117. sor), de a robot nem veszi figyelembe. Emiatt a robot felülírhatja a manuálisan bevitt adatokat.
+
+
+## #28 – Regex/JSON bányászat webből
+
+**Állapot: HIÁNYOS**  
+A `vehicle_robot_2_researcher.py` csak nyers szöveget gyűjt a DuckDuckGo keresésből (`fetch_ddg_targeted`). Nincs implementálva regex vagy JSON elemzés a technikai adatok (ccm, kW, engine_code) kinyerésére. A kutatás kimenete pusztán szöveges kontextus, ami továbbítódik az AI-nak.
+
+## #29 – Explicit deduplikáció
+**Állapot: RÉSZBEN MEGVAN**  
+A `vehicle_definitions.py` modellben a deduplikáció a `make`, `normalized_name`, `variant_code`, `version_code`, `fuel_type` kombinációján alapul (UniqueConstraint). A `vehicle_robot_1_catalog_hunter.py` ezt az öt mezőt használja az `ON CONFLICT` záradékban (157–158 sor). A `technical_code` (holland rendszám) nem része a konfliktus kezelésnek, de a `make + technical_code` pároson kívül további normalizációs logika már jelen van.
+
+## Epic 4.1 utóélet
+A #64, #65, #66 kártyák a Closed listában szerepelnek, tehát lezárásra kerültek.
+
+## Összefoglaló
+A robotok alapvető működése megvan (adatgyűjtés, AI dúsítás, deduplikáció), de a manuális adatok védelme és a technikai adatok automatikus kinyerése hiányzik. A deduplikáció logikája kielégítő, de a `technical_code` integrációja javítható.