2026.06.04 frontend építés közben

docs/masterbook_2.0.1/Service Finder Gitea Feladatok Elemzése és Fejlesztési Menetrend.md

@@ -0,0 +1,60 @@
+Service Finder Gitea Feladatok Elemzése és Fejlesztési Menetrend
+📋 Nyitott Gitea Feladatok Listája
+A gitea_manager.py segítségével listáztam a nyitott feladatokat. Összesen 35 nyitott feladat található, melyek a következő mérföldkövek szerint csoportosíthatók:
+
+Phase 1: Core Functionality Fixes (12 feladat)
+Phase 2: Dashboard & Analytics Wiring (6 feladat)
+Phase 3: Advanced Features & Epic 11 (6 feladat)
+Phase 4: Testing & Deployment (7 feladat)
+Mérföldkő nélkül (4 feladat)
+A teljes lista megtalálható a fenti végrehajtott parancs kimenetében.
+
+🔍 Feladatok Állapotának Elemzése Kód Alapján
+Az egyes feladatokhoz tartozó kód jelenlétét és készültségi szintjét elemeztem. Az alábbi táblázat foglalja össze a legfontosabb feladatokat a felhasználókezelés, járművek rögzítése és költségek rögzítése szempontjából:
+
+Feladat ID	Cím	Állapot	Megjegyzés
+#180	[CORE] Ground Zero: Registration, Email & RBAC Baseline	Folyamatban	Regisztráció és email küldés működik, de SMTP timeout probléma van. Brevo API integráció szükséges.
+#178	Vehicle Transfer Requests - Implement Dual-Control Workflow	Folyamatban	vehicle_transfer_requests tábla létezik, AssetService metódusok vannak, de a dual-control workflow nincs teljesen kialakítva.
+#152	Implement Historical Data (occurrence_date fields)	Folyamatban	occurrence_date mező már létezik a service táblában, de más táblákban hiányozhat. Migráció és frontend formok szükségesek.
+#151	Connect User Management Table to Real Data	Nincs meg	Backend user endpointok léteznek, de a frontend admin tábla nincs összekötve valós adatokkal.
+#150	Wire Service Map with Real Provider Data	Nincs meg	Nincs konkrét service map implementáció a kódban.
+#149	Implement Analytics Service (TCO/km Calc)	Kész	Teljes TCO analytics service létezik (analytics_service.py, analytics.py endpoint).
+#148	Connect Gamification Components to Real	Folyamatban	Gamification rendszer teljesen kiépítve, de a valós adatokra kapcsolás hiányos.
+#147	Wire Financial Dashboard to Real Finance	Nincs meg	Nincs explicit financial dashboard kód.
+#146	Implement Basic Error Handling in Frontend	Nincs meg	Frontend feladat, nincs meg a kódban.
+#145	Standardize API Base URL Usage in Frontend	Nincs meg	Frontend feladat.
+#142	Implement Catalog API Endpoints	Kész	catalog.py endpoint teljesen implementálva.
+Általános megállapítás: A backend alapvető funkcionalitás (felhasználókezelés, járművek, költségek) nagyrészt megvan, de hibák és hiányosságok vannak. A frontend és a valós adatokra kapcsolás sok esetben hiányzik.
+
+🚀 Fejlesztési Menetrend
+A felhasználó kérésének megfelelően elsődleges cél a felhasználókezelés, járművek rögzítése és költségek rögzítésének stabilizálása. Ajánlott fejlesztési sorrend:
+
+1. Fázis: Alapfunkcionalitás Hibamentesítése (Kritikus)
+#180 Ground Zero: Azonnali megoldás az SMTP timeout problémára (Brevo API), tesztadatok törlése, regisztráció és email küldés stabilizálása.
+#142 Catalog API Endpoints: Ellenőrzés, hogy a katalógus végpontok hibátlanul működnek-e. Szükség esetén javítás.
+#178 Vehicle Transfer Requests: Dual-control workflow befejezése, admin jóváhagyási mechanizmus implementálása.
+2. Fázis: Frontend Alapok (Stabilitás)
+#145 Standardize API Base URL: Frontend API hívások egységesítése.
+#146 Basic Error Handling: Frontend hibakezelés implementálása a felhasználói élmény javítása érdekében.
+3. Fázis: Adatkezelés és Kapcsolatok
+#152 Historical Data: occurrence_date mezők bevezetése minden releváns táblában, dátumkezelés a költségek és szervizek számára.
+#151 User Management Table: Admin felület összekötése valós adatokkal, CRUD műveletek lehetősége.
+#150 Service Map: Szolgáltatók térképes megjelenítésének implementálása (ha szükséges a MVP-hez).
+4. Fázis: Dashboard és Analitika
+#149 Analytics Service: TCO számítások tesztelése és finomítása.
+#148 Gamification: Valós adatokra kapcsolás, pontozási rendszer aktiválása.
+#147 Financial Dashboard: Pénzügyi áttekintő dashboard összekötése a valós adatokkal.
+5. Fázis: Fejlett Funkciók és Tesztelés
+A Phase 3 és Phase 4 feladatok (pl. Advanced Search, Bulk Operations, Webhook, CI/CD, Security Audit) csak az alapok stabilizálása után.
+📊 Prioritási Mátrix
+Prioritás	Feladat ID	Rövid leírás
+P0 (Kritikus)	#180	Regisztráció és email javítás
+P1 (Magas)	#142, #178, #152, #145, #146	Alapfunkcionalitás és frontend stabilitás
+P2 (Közepes)	#151, #150, #149, #148, #147	Adatkapcsolatok és dashboardok
+P3 (Alacsony)	Phase 3 és 4 feladatok	Fejlett funkciók és infrastruktúra
+✅ Következő Lépések
+Azonnal kezdjük a #180 feladat megoldásával (Brevo API integráció, tesztadatok törlése).
+Párhuzamosan ellenőrizzük a #142 és #178 állapotát, hogy mikor lehet rálépni.
+Hozzunk létre részletes technikai specifikációkat (logic_spec_*.md) a hiányzó komponensekhez.
+Frissítsük a Kanban táblát (Focalboard) az új prioritásokkal.
+A fenti menetrend garantálja, hogy a rendszer alapvető funkciói (felhasználókezelés, járművek, költségek) a lehető leghamarabb hibamentes és stabil állapotba kerülnek.

docs/masterbook_2.0.1/User_person_kezelés.md

@@ -0,0 +1,33 @@
+📑 HIVATALOS FELHASZNÁLÓ KEZELÉSI DOKUMENTUM (V1.0)
+
+1. Regisztráció és Hitelesítés (A Kapu)
+
+    Szigorú beléptetés: A rendszerbe történő bejelentkezés alapfeltétele a megerősített email cím. Megerősítés (aktiválás) hiányában a felhasználó nem kaphat hozzáférési tokent.
+
+    Kétlépcsős profilépítés: 1. Lite Regisztráció: Csak email és jelszó. Az eredmény egy is_active=False inaktív fiók.
+    2. Aktiválás: Emailben kapott token (link) kattintása.
+    3. KYC (Know Your Customer): Személyes adatok megadása a rendszer teljes körű használatához (Saját Széf létrehozása).
+
+2. Jelszópolitika és Biztonság
+
+    Komplexitás: Alapértelmezetten minimum 6 karakter, amely tartalmaz legalább 1 kisbetűt, 1 nagybetűt és 1 számot vagy speciális karaktert. (Ezek az értékek az Admin felületről dinamikusan felülbírálhatók).
+
+    Munkamenet (Session): JWT token alapú hitelesítés. Opcionális "Emlékezz rám" (Remember me) funkció, amely egy 30 napos lejárati idejű frissítő tokent (Refresh Token) biztosít, elkerülve a gyakori visszajelentkeztetést.
+
+3. Cég- és Szervezetkezelés (Onboarding)
+
+    Bizalmi elv: Amíg egy új üzleti szervezet (Cég) nem kerül hivatalos adatbázisból (vagy dokumentum alapján) hitelesítésre, addig pending_verification (vázlat/függő) státuszban marad.
+
+    Csak hitelesített személy (KYC) hozhat létre vagy menedzselhet szervezeteket és küldhet meghívókat másoknak.
+
+4. Adatmegőrzés és Törlési Protokoll (Életút Biztosítás)
+
+    Nincs adatvesztés (No Hard Delete): A rendszerből semmilyen entitás (Felhasználó, Szervezet, Jármű) nem törlődik fizikailag.
+
+    Anonimizálás (Soft Delete): Törlési kérelem esetén a felhasználó személyes adatai (email, név) olvashatatlanná válnak (pl. deleted_id_date_email), státusza inaktív lesz.
+
+    Folytonosság: A felhasználó által korábban rögzített járműadatok és szerviztörténetek a rendszerben maradnak, biztosítva a járművek digitális életútjának megszakíthatatlanságát.
+
+5. Teljes Körű Audit (Sentinel)
+
+    A rendszer minden biztonsági és életciklus eseményt (regisztráció, login hiba, jelszócsere, törlés, email hitelesítés) a központi audit naplóba ír.