Epic 3: Economy & Billing Engine (Pénzügyi Motor)

docs/v02/000_Fejlesztendő_pontok.md

@@ -0,0 +1,222 @@
+Íme a hiányzó láncszemek, amiket ki kell dolgoznunk:
+
+🔗 1. Ajánlatkérés és Időpontfoglalás (Booking & Quoting Flow)
+A V01-ben: A 01-es dokumentum említi: "Marketplace: Szervizkereső, Ajánlatkérés, Időpontfoglalás."
+
+A Hiány: Az adatbázisban van service_profiles, branches, sőt pending_actions is, de nincs dedikált tábla/logika a foglalásokra és árajánlatokra.
+
+Amit meg kell írni: Hogyan kér a User ajánlatot? (Kiválasztja az autóját a garázsból -> leírja a hibát -> a rendszer kiküldi a 10 km-en belüli megfelelő expertise_tags-el rendelkező szervizeknek -> a szerviz ajánlatot ad -> User elfogadja -> bekerül az asset_events-be, mint jövőbeli esemény).
+
+🔗 2. Költség-taxonómia és "Munkába járás" (TCO & Accounting)
+A V01-ben: TCO (Total Cost of Ownership) számítás szerepel a PREMIUM csomagnál. Említetted a munkába járás elszámolását is.
+
+A Hiány: A data.asset_costs tábla létezik, de nincs definiálva a szigorú Költségkategória fa (üzemanyag, javítás, autópálya-matrica, biztosítás, értékcsökkenés).
+
+Amit meg kell írni: Fix kategória ID-k definiálása a frontend drop-down menüjéhez, illetve a Munkába járás modul logikája (Otthon-Munkahely távolság x Munkanapok száma x Állami/NAV norma = Havi adómentes térítés kalkulációja a B2B flottáknak).
+
+🔗 3. Az "Evidence Store" és az OCR Robot (Robot 3) Folyamata
+A V01-ben: A 22-es fájl említi a Robot 3-at (OCR & Document AI), ami feldolgozza a számlákat.
+
+A Hiány: Nincs technikai leírás arról, hogyan lesz a MinIO-ba feltöltött fotóból hitelesített szervizbejegyzés.
+
+Amit meg kell írni: A fotó feltöltésre kerül a documents táblába -> A Robot 3 (Gemini 2.0 Multimodal) kiolvassa a dátumot, összeget, km-órát és szerviz nevét -> Létrehoz egy asset_events rekordot unverified státusszal -> Összeköti a számlán lévő szervizt a service_profiles táblával -> Megadja a Gamification pontokat a Usernek.
+
+🔗 4. B2B Flotta Szerepkörök (Organization Members Logika)
+A V01-ben: A "Mindenki flottatulajdonos" elv megvan (Privát vs Céges flotta).
+
+A Hiány: A data.organization_members táblád létezik, de nincsenek definiálva a Flottán belüli szerepkörök.
+
+Amit meg kell írni: Ki mit láthat egy cégen belül?
+
+Fleet Manager (Admin): Látja az összes autót, minden költséget, ő veszi a Krediteket.
+
+Driver (Sofőr): Csak a rá szignált (asset_assignments) autót látja, tud tankolást (költséget) rögzíteni, de a cég egyenlegéhez nem fér hozzá.
+
+🔗 5. Telemetria és Futásteljesítmény (Odometer Tracking)
+A V01-ben: A data.asset_telemetry tábla bent van az adatbázisban, és a Prediktív naptárhoz (Robot 2.3) kell a km-óra állás.
+
+A Hiány: Honnan jön a km-óra állás, ha nincs OBD2 hardver bedugva az autóba?
+
+Amit meg kell írni: Az "Okos becslés" (Smart Odometer) algoritmusa. Minden tankolásnál (asset_costs) és szerviznél (asset_events) kötelező megadni a km-állást. A rendszer ebből számol egy napi átlagos futást, és ha hetekig nincs új adat, a háttérben "pörgeti" az órát, hogy a Robot 2.3 tudja, mikor kell szólni az olajcsere miatt.
+
+🚀 FEJLESZTÉSI IRÁNYTŰ ÉS ÜZLETI MODELL (V2.0)
+
+Ez a dokumentum rögzíti, hogy mit építünk meg azonnal az induláshoz (MVP), és mit hagyunk a skálázódási fázisra.
+I. FÁZIS: AZ INDULÓ CSOMAG (MVP - Minimum Viable Product)
+
+Ezek kellenek ahhoz, hogy a rendszer elinduljon, pénzt termeljen, és napi szinten használják a magánszemélyek és a KKV-k.
+1. Onboarding és Garázs (Asset Creation)
+
+Az első benyomás a legfontosabb. A felhasználó itt adja hozzá a járművét és az adatait.
+
+    FREE (Ingyenes): * Maximum 1 jármű rögzítése.
+
+        Adatok manuális bevitele (Rendszám / VIN alapján keresés a katalógusban).
+
+        Okmányok lejárati dátumának manuális rögzítése.
+
+    PREMIUM:
+
+        Több jármű (pl. 3-5 db) rögzítése.
+
+        Robot 3 "Magic Scan": A forgalmi engedély és a jogosítvány lefotózása -> az AI mindent automatikusan kitölt.
+
+        Dokumentumok titkosított tárolása a MinIO "Privát Széfben" (digitalizált irattárca).
+
+2. Smart Trip Logger & Munkába járás (A napi horog)
+
+Ez adja a napi használatot (DAU) és a KKV-k számára a fő értéket.
+
+    FREE: * Kézi Start/Stop gomb az utakhoz (GPS koordináták mentése).
+
+        Alapvető havi statisztika (megtett út km-ben).
+
+    PREMIUM:
+
+        Automata Munkába Járás Riport: A megadott Otthon-Munkahely cím alapján a ledolgozott napokból a hónap végén NAV-kompatibilis, adómentes költségtérítési PDF generálása.
+
+        Adaptív GPS útvonalrögzítés (ahogy korábban átbeszéltük).
+
+        Költségek (TCO) és tankolások kézi rögzítésének analitikája.
+
+3. Guardian & Gamification (Őrangyal és Játékosítás)
+
+A bizalomépítés és a proaktív segítség.
+
+    FREE: * Értesítés az okmányok (Jogsi, Forgalmi) lejártáról 30 nappal előtte.
+
+        Alap "Clean History" Badge (ha mindent kitölt).
+
+    PREMIUM:
+
+        Okos Szerviz Naptár: A Robot 2.3 a napi átlag futásból kiszámolja (Predikció), mikor kell olajat cserélni, és időben szól.
+
+        Napi/Heti "Checklist" értesítések (Mérj guminyomást!) -> Sikeres elvégzés esetén XP és Kredit jutalom (Gamification).
+
+⚙️ A PÉNZÜGYI MOTOR (The Economy Engine) - MVP Követelmény
+
+Ahogy említetted, az elv megvan (Triple Wallet), de a motort meg kell írni. Ennek a Backendben egy atombiztos, önálló modulként kell futnia (app/services/billing_engine.py).
+
+A Pénzügyi Motor 3 fő komponense:
+
+    A Stripe Webhook Receiver: * Amikor a User kifizeti a csomagot bankkártyával, a Stripe küld egy jelet a Backendnek (checkout.session.completed).
+
+        A motor ekkor felébred.
+
+    Az Atomi Tranzakció (Double-Entry Ledger):
+
+        A motor nem csak átírja a Wallet egyenlegét, hanem először beír egy sort a data.financial_ledger táblába (Főkönyv): "+5000 HUF befizetés, Stripe_ID_xyz".
+
+        Ezután hozzáadja a Krediteket a wallets.purchased_credits mezőhöz. A két lépés egy adatbázis-tranzakcióban (SQL COMMIT) fut: ha az egyik elszáll, a másik is visszagurul (Rollback). Nincs elveszett pénz.
+
+    A Subscription Cron-Job (Az Éjjeli Őr):
+
+        Egy ütemezett feladat minden éjjel 00:01-kor végignézi a users táblában a subscription_expires_at dátumokat.
+
+        Akinél lejárt a PREMIUM, annak a rendszer automatikusan leveszi a rangját FREE-re, kikapcsolja a PDF generálást, és zárolja a 2. és 3. autóját (Read-only módba teszi).
+
+II. FÁZIS: POST-LAUNCH (A skálázódás és a Szerviz-Szimbiózis)
+
+Ezek a funkciók elengedhetetlenek a vízióhoz, de az indulás napján nem kellenek. Akkor kezdjük el fejleszteni őket, amikor már van 1000+ aktív autósunk az adatokkal.
+4. Marketplace: Ajánlatkérés és Szervizkereső
+
+    Funkció: A User a Garázsból egy gombnyomással elküldi a hibát (pl. "Fékcsere") a 20 km-es körzetben lévő megbízható szervizeknek.
+
+    PREMIUM előny: A Premium userek ajánlatkérései "VIP" jelzéssel, a lista elején jelennek meg a szervizeknek.
+
+5. Service Pro Modul (A szerelők felülete)
+
+    Funkció: A szerelő beírja a rendszámot, és a Robot 2.2 által gyűjtött "Arany Adatok" (olajmennyiség, nyomatékok) megjelennek neki (Quick-Scan).
+
+    Kölcsönhatás: A szerelő nálunk rögzíti a munkalapot, ami azonnal bekerül az autó Hitelesített Digitális Szervizkönyvébe. Ezzel az autó "Trust Score"-ja (bizalmi indexe) az egekbe szökik.
+
+6. Deep Tech: Telemetria és AI Diagnosztika
+
+    Funkció: OBDII csatlakozó integráció a valós km-óra állás és hibakódok (DTC) olvasásához.
+
+    Kísérleti: G-erő mérése telefonnal (Vezetési stílus analitika) és AI Audio Engine (indítási hangból önindító/akku hiba predikciója). Ezt külön "Add-on" csomagként lehet értékesíteni a Flottakezelőknek.
+
+    🚀 FEJLESZTÉSI IRÁNYTŰ ÉS ÜZLETI MODELL (V2.0)
+
+Ez a dokumentum rögzíti, hogy mit építünk meg azonnal az induláshoz (MVP), és mit hagyunk a skálázódási fázisra.
+I. FÁZIS: AZ INDULÓ CSOMAG (MVP - Minimum Viable Product)
+
+Ezek kellenek ahhoz, hogy a rendszer elinduljon, pénzt termeljen, és napi szinten használják a magánszemélyek és a KKV-k.
+1. Onboarding és Garázs (Asset Creation)
+
+Az első benyomás a legfontosabb. A felhasználó itt adja hozzá a járművét és az adatait.
+
+    FREE (Ingyenes): * Maximum 1 jármű rögzítése.
+
+        Adatok manuális bevitele (Rendszám / VIN alapján keresés a katalógusban).
+
+        Okmányok lejárati dátumának manuális rögzítése.
+
+    PREMIUM:
+
+        Több jármű (pl. 3-5 db) rögzítése.
+
+        Robot 3 "Magic Scan": A forgalmi engedély és a jogosítvány lefotózása -> az AI mindent automatikusan kitölt.
+
+        Dokumentumok titkosított tárolása a MinIO "Privát Széfben" (digitalizált irattárca).
+
+2. Smart Trip Logger & Munkába járás (A napi horog)
+
+Ez adja a napi használatot (DAU) és a KKV-k számára a fő értéket.
+
+    FREE: * Kézi Start/Stop gomb az utakhoz (GPS koordináták mentése).
+
+        Alapvető havi statisztika (megtett út km-ben).
+
+    PREMIUM:
+
+        Automata Munkába Járás Riport: A megadott Otthon-Munkahely cím alapján a ledolgozott napokból a hónap végén NAV-kompatibilis, adómentes költségtérítési PDF generálása.
+
+        Adaptív GPS útvonalrögzítés (ahogy korábban átbeszéltük).
+
+        Költségek (TCO) és tankolások kézi rögzítésének analitikája.
+
+3. Guardian & Gamification (Őrangyal és Játékosítás)
+
+A bizalomépítés és a proaktív segítség.
+
+    FREE: * Értesítés az okmányok (Jogsi, Forgalmi) lejártáról 30 nappal előtte.
+
+        Alap "Clean History" Badge (ha mindent kitölt).
+
+    PREMIUM:
+
+        Okos Szerviz Naptár: A Robot 2.3 a napi átlag futásból kiszámolja (Predikció), mikor kell olajat cserélni, és időben szól.
+
+        Napi/Heti "Checklist" értesítések (Mérj guminyomást!) -> Sikeres elvégzés esetén XP és Kredit jutalom (Gamification).
+
+⚙️ A PÉNZÜGYI MOTOR (The Economy Engine) - MVP Követelmény
+
+Ahogy említetted, az elv megvan (Triple Wallet), de a motort meg kell írni. Ennek a Backendben egy atombiztos, önálló modulként kell futnia (app/services/billing_engine.py).
+
+A Pénzügyi Motor 3 fő komponense:
+
+    A Stripe Webhook Receiver: * Amikor a User kifizeti a csomagot bankkártyával, a Stripe küld egy jelet a Backendnek (checkout.session.completed).
+
+        A motor ekkor felébred.
+
+    Az Atomi Tranzakció (Double-Entry Ledger):
+
+        A motor nem csak átírja a Wallet egyenlegét, hanem először beír egy sort a data.financial_ledger táblába (Főkönyv): "+5000 HUF befizetés, Stripe_ID_xyz".
+
+        Ezután hozzáadja a Krediteket a wallets.purchased_credits mezőhöz. A két lépés egy adatbázis-tranzakcióban (SQL COMMIT) fut: ha az egyik elszáll, a másik is visszagurul (Rollback). Nincs elveszett pénz.
+
+    A Subscription Cron-Job (Az Éjjeli Őr):
+
+        Egy ütemezett feladat minden éjjel 00:01-kor végignézi a users táblában a subscription_expires_at dátumokat.
+
+        Akinél lejárt a PREMIUM, annak a rendszer automatikusan leveszi a rangját FREE-re, kikapcsolja a PDF generálást, és zárolja a 2. és 3. autóját (Read-only módba teszi).
+
+II. FÁZIS: POST-LAUNCH (A skálázódás és a Szerviz-Szimbiózis)
+
+Ezek a funkciók elengedhetetlenek a vízióhoz, de az indulás napján nem kellenek. Akkor kezdjük el fejleszteni őket, amikor már van 1000+ aktív autósunk az adatokkal.
+4. Marketplace: Ajánlatkérés és Szervizkereső
+
+    Funkció: A User a Garázsból egy gombnyomással elküldi a hibát (pl. "Fékcsere") a 20 km-es körzetben lévő megbízható szervizeknek.
+
+    PREMIUM előny: A Premium userek ajánlatkérései "VIP" jelzéssel, a lista elején jelennek meg a szervizeknek.