Cleanup: MB 2.0 Gap Analysis előtti állapot (adatok kizárva)
This commit is contained in:
222
docs/V02/000_Fejlesztendő_pontok.md
Normal file
222
docs/V02/000_Fejlesztendő_pontok.md
Normal file
@@ -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.
|
||||
25
docs/V02/04_TCO_Költség-Taxonómia_&_Telemetria.md
Normal file
25
docs/V02/04_TCO_Költség-Taxonómia_&_Telemetria.md
Normal file
@@ -0,0 +1,25 @@
|
||||
# 24. TCO, Költség-Taxonómia & Telemetria (v2.0)
|
||||
|
||||
Ez a dokumentum a járművek üzemeltetési költségeinek (Total Cost of Ownership), a telemetriai adatoknak és a speciális elszámolásoknak (pl. munkába járás) a logikáját rögzíti.
|
||||
|
||||
## 24.1 Költség-Taxonómia (`data.asset_costs`)
|
||||
A rendszer szigorú kategóriarendszert használ a kiadások követésére. A frontend számára ezek a kategóriák fix azonosítóval (ID) rendelkeznek:
|
||||
|
||||
1. **Üzemanyag & Töltés (Fuel & EV):** Tankolások, villámtöltések.
|
||||
2. **Karbantartás (Maintenance):** Kötelező szervizek, alkatrészek, munkadíjak.
|
||||
3. **Adók & Díjak (Taxes & Fees):** Gépjárműadó, autópálya-matrica, biztosítás (KGFB, CASCO).
|
||||
4. **Bírságok & Parkolás (Legal & Parking):** Parkolási díjak, gyorshajtás, pótdíjak.
|
||||
5. **Értékcsökkenés (Depreciation):** Rendszer által becsült, vagy manuálisan megadott értékvesztés (csak PREMIUM/VIP szinten).
|
||||
|
||||
## 24.2 "Munkába Járás" Modul (Commuting Allowance)
|
||||
A rendszer automatikusan számolja a munkavállalók adómentes költségtérítését a magánjármű céges használata után.
|
||||
- **Bemenet:** A `users` táblában rögzített Otthoni és Munkahelyi cím távolsága (Google Maps API / OSM alapján).
|
||||
- **Triggelés:** A felhasználó a naptárban (vagy gombnyomással) kijelöli az adott hónapban ledolgozott munkanapokat.
|
||||
- **Kalkuláció:** `Napi oda-vissza távolság (km) × Ledolgozott napok × Állami Norma (HUF/km)`.
|
||||
- **Kimenet:** Hó végén egy automatikus, exportálható PDF riport a bérszámfejtésnek.
|
||||
|
||||
## 24.3 Smart Odometer (Okos Futásteljesítmény)
|
||||
Mivel nincs kötelező OBD2 hardver, a rendszer a `data.asset_telemetry` táblában egy okos algoritmust használ a kilométeróra állás (ODO) követésére:
|
||||
- **Horgonypontok:** Minden tankolás, szerviz vagy vizsga alkalmával kötelező/ajánlott megadni az aktuális km-állást.
|
||||
- **Napi Átlag (Daily Average):** A rendszer kiszámolja a két horgonypont között megtett napi átlagos távolságot.
|
||||
- **Predikció (Ghost Telemetry):** Ha 14 napig nincs új adat, a rendszer a Napi Átlag alapján "láthatatlanul pörgeti" az órát, hogy a Robot 2.3 (Guardian) időben tudja küldeni a szervizértesítéseket.
|
||||
@@ -1,7 +1,7 @@
|
||||
# 06. Economy, Fleet Ecosystem & Marketplace (v2.0)
|
||||
|
||||
Ez a dokumentum a rendszer bevételi logikáját, az eszközök (Assets) életútját és a szervizkereső (Service Finder) működési szabályait rögzíti.
|
||||
|
||||
|
||||
## 6.1 A Gazdasági Motor (The Triple Wallet)
|
||||
A pénzügyi stabilitást és a B2B/B2C szétválasztást a háromszintű pénztárca-modell biztosítja.
|
||||
|
||||
|
||||
19
docs/V02/08_Marketplace_Ajánlatkérés_és_Időpontfoglalás.md
Normal file
19
docs/V02/08_Marketplace_Ajánlatkérés_és_Időpontfoglalás.md
Normal file
@@ -0,0 +1,19 @@
|
||||
# 25. Marketplace: Ajánlatkérés és Időpontfoglalás (v2.0)
|
||||
|
||||
Ez a modul írja le a Szervizkeresőből kiinduló tranzakciós folyamatot, amely összeköti a járműtulajdonost a szolgáltatókkal.
|
||||
|
||||
## 25.1 A Foglalási Folyamat (Booking Flow)
|
||||
A kommunikáció aszinkron, és a `data.pending_actions` táblára épül.
|
||||
|
||||
1. **Igény (Service Request):** - A User kiválasztja az autóját a Garázsból (`asset_id`).
|
||||
- Kiválasztja a probléma típusát (pl. "Fékcsere", "Éves szerviz") a `service_specialties` fa alapján.
|
||||
- Csatolhat fotót vagy hangüzenetet (MinIO).
|
||||
2. **Geofenced Broadcast:** - A rendszer megkeresi a User által megadott sugáron belül (pl. 20 km) lévő, a megfelelő `expertise_tags`-el rendelkező szervizeket (`branches`).
|
||||
- A szervizek (Providers) push/email értesítést kapnak: "Új ajánlatkérés a közeledben".
|
||||
3. **Ajánlatadás (Quoting):** - A Provider megad egy árat, egy időpontot és egy validálási lejárati időt.
|
||||
4. **Elfogadás & Esemény (Acceptance):** - A User elfogadja az egyik ajánlatot.
|
||||
- Létrejön egy jövőbeli `asset_events` bejegyzés `status='scheduled'` jelzéssel.
|
||||
|
||||
## 25.2 Trust és Lemondási Logika
|
||||
- **No-Show védelem:** Ha a User nem jelenik meg, a szerviz "No-show" gombot nyomhat. Ez 1 Penalty Point-ot ad a Person rekordhoz (csökkenti a Trust Score-t).
|
||||
- **Service Cancellation:** Ha a szerviz mondja le az utolsó pillanatban, a szerviz kap levonást az értékeléséből, a User pedig kompenzációs Kreditet kap.
|
||||
18
docs/V02/09_Evidence_Store_&_Robot 3_(OCR_AI).md
Normal file
18
docs/V02/09_Evidence_Store_&_Robot 3_(OCR_AI).md
Normal file
@@ -0,0 +1,18 @@
|
||||
# 26. Evidence Store & Robot 3 (OCR AI) (v2.0)
|
||||
|
||||
A jármű történetének hitelesítése (Digitális Szervizkönyv) a bizonyítékokon (Evidence) alapul.
|
||||
|
||||
## 26.1 A Bizonyítékok Életciklusa
|
||||
1. **Feltöltés:** A User lefotózza a számlát/munkalapot. A fájl titkosítva bekerül a MinIO objektumtárba, az adatbázisban pedig létrejön egy rekord a `data.documents` táblában.
|
||||
2. **Feldolgozás (Robot 3):** A feltöltés egy eseményt (Webhook) indít az n8n felé, ami felébreszti a Robot 3-at (Gemini 2.0 Multimodal).
|
||||
3. **Kinyerés (Extraction):** Az AI az alábbi adatokat bányássza ki a képből:
|
||||
- `date`: A szerviz dátuma.
|
||||
- `total_cost`: Bruttó végösszeg.
|
||||
- `odometer`: Kilométeróra állása.
|
||||
- `service_name / tax_number`: A szolgáltató adószáma vagy neve.
|
||||
|
||||
## 26.2 Validációs Háló (Trust Matching)
|
||||
Miután a Robot 3 kinyerte az adatokat, a rendszer megpróbálja összekötni azokat a meglévő adatbázissal:
|
||||
- **Partner Match:** Ha a kibányászott adószám/név szerepel a `data.organizations` táblában (Regisztrált Szerviz), a rendszer azonnal értesíti a szervizt. Ha a szerviz jóváhagyja ("Igen, nálunk járt"), a bejegyzés **High Trust (Verified)** státuszt kap.
|
||||
- **Sufni / Non-Partner Match:** Ha a szerviz nincs a rendszerben, a bejegyzés **Medium Trust** státuszt kap (bizonyíték van, de nem partner).
|
||||
- **Gamification Jutalmazás:** Ha a feltöltés sikeres adatkinyerést eredményezett, a User +10 XP-t (Earned Credits) kap az adatrögzítésért.
|
||||
20
docs/V02/11_B2B_Flotta_és_Szervezeti_Szerepkörök.md
Normal file
20
docs/V02/11_B2B_Flotta_és_Szervezeti_Szerepkörök.md
Normal file
@@ -0,0 +1,20 @@
|
||||
# 27. B2B Flotta és Szervezeti Szerepkörök (v2.0)
|
||||
|
||||
A rendszerben a privát flotta és a több ezer autós céges flotta technológiailag azonos (`data.organizations`), a különbséget a `data.organization_members` táblában lévő jogosultsági szintek adják.
|
||||
|
||||
## 27.1 Céges Szerepkörök (Roles)
|
||||
Egy szervezeten (Company) belül az alábbi három fő szerepkör értelmezett:
|
||||
|
||||
1. **Owner (Cégtulajdonos / CEO):**
|
||||
- Mindenhez hozzáfér, ő kötheti össze a céget a Stripe (fizetési) fiókkal.
|
||||
- Látja a cég teljes egyenlegét (`wallets`), vehet Krediteket és oszthat ki Fleet Manager jogokat.
|
||||
2. **Fleet Manager (Flottakezelő):**
|
||||
- Látja a céghez rendelt összes járművet (`asset_assignments`).
|
||||
- Látja a telemetriát, a költségeket (`asset_costs`) és a jövőbeli karbantartásokat.
|
||||
- Új autót vehet fel a flottába, de Krediteket (pénzt) alapértelmezetten nem vásárolhat.
|
||||
3. **Driver (Sofőr):**
|
||||
- Kizárólag azokat az autókat látja, amelyek kifejezetten hozzá vannak rendelve az `asset_assignments` táblában (`driver_id`).
|
||||
- Rögzíthet tankolást, feltölthet számlát (Evidence), de nem látja a cég többi autóját, és nincs hozzáférése a cég Pénztárcájához.
|
||||
|
||||
## 27.2 Privát Szféra Izolációja
|
||||
Ha egy felhasználó (User) Driver-ként van hozzárendelve egy céges autóhoz, az ő saját, személyes autói (Privát Széf) teljesen láthatatlanok maradnak a Fleet Manager és a cégtulajdonos számára. A céges és privát adatok szigorú falakkal vannak elválasztva az API szintjén.
|
||||
@@ -30,4 +30,64 @@ A robotok az adatbázist használják "jelzőtáblának", elkerülve az ütköz
|
||||
1. **R1** rögzíti az alapot.
|
||||
2. **R2** dúsít és validál.
|
||||
3. **R3** (OCR) bizonyítékokat csatol a jármű életútjához.
|
||||
4. Minden művelet a `ProcessLog` táblában kerül rögzítésre az auditálhatóság érdekében.
|
||||
4. Minden művelet a `ProcessLog` táblában kerül rögzítésre az auditálhatóság érdekében.
|
||||
|
||||
|
||||
2026.02.18 Frissített Robot 2.0 Dúsítés több példányban
|
||||
# 🤖 TechEnricher Robot (v1.2.6) - Dokumentáció
|
||||
|
||||
## 1. Célkitűzés
|
||||
A TechEnricher feladata a `data.vehicle_model_definitions` táblában található nyers, tisztítatlan járműadatok automatizált dúsítása technikai adatokkal (CCM, kW, Évjárat, Szervizintervallumok) és a duplikációk intelligens felszámolása.
|
||||
|
||||
## 2. Technikai Architektúra
|
||||
- **Motor:** Python 3.10+ Asynchronous IO
|
||||
- **AI Integráció:** Google Gemini 2.0 Flash
|
||||
- **Adatbázis Logika:** SQLAlchemy 2.0 + PostgreSQL Row Level Locking
|
||||
- **Deduplikációs Kulcs:** `make` + `technical_code` + `vehicle_type`
|
||||
|
||||
|
||||
|
||||
## 3. Kulcsfunkciók
|
||||
|
||||
### 🛡️ Manuális Védelem (Manual Override)
|
||||
A robot soha nem írja felül a manuálisan rögzített adatokat. Ha a rekord `is_manual` mezője `true`, a folyamat érintetlenül hagyja azt.
|
||||
|
||||
### 🔗 Intelligens Összefűzés (Smart Merge)
|
||||
Az egyediségi kényszerek (Unique Constraints) megsértése helyett a robot felismeri az ütközéseket:
|
||||
- Ha a technikai kód alapján már létezik rekord, az új bejegyzést `duplicate` státuszba helyezi.
|
||||
- Létrehozza a kapcsolatot a `parent_id` mezőn keresztül.
|
||||
- A Master rekord `synonyms` mezőjét automatikusan bővíti az új elnevezéssel.
|
||||
|
||||
### 🛑 Anti-Loop és Hibakezelés
|
||||
- **Attempts:** Minden rekord maximum 3 esélyt kap.
|
||||
- **Last Error:** A hibás tranzakciók okát a robot elmenti a rekordhoz.
|
||||
- **Circuit Breaker:** 10 egymást követő kritikus hiba esetén a robot 15 percre "alvó üzemmódba" vált az API-kvóta védelme érdekében.
|
||||
|
||||
|
||||
|
||||
## 4. Működési Sorrend (Logic Flow)
|
||||
1. **Fetch:** 20 rekord lekérése `SKIP LOCKED` módban.
|
||||
2. **Pre-Map:** Adatok kimentése memóriába (Greenlet védelem).
|
||||
3. **Group:** Csoportosítás márkák/modellek szerint.
|
||||
4. **Enrich:** AI vagy Belső Cache hívás.
|
||||
5. **Validate:** Sanity check a technikai adatokra.
|
||||
6. **Commit:** Tranzakció mentése (Master/Duplicate logika szerint).
|
||||
|
||||
## 5. Skálázás
|
||||
A robot felkészített a horizontális skálázásra:
|
||||
```bash
|
||||
docker compose up -d --scale enricher_robot=3
|
||||
|
||||
🤖 22.0 Robot 0: The Strategist (Market Prioritizer)Cél: A feldolgozási sorrend optimalizálása a piaci relevancia alapján.Logika: Lekéri a külső források (pl. RDW) statisztikáit, és darabszám szerint rangsorolja a márkákat.Működés: 1. Kategóriákra bont (Személyautó > Motor > Teherautó > Egyéb).2. Feltölti/Frissíti a data.catalog_discovery táblát.3. Biztosítja, hogy a Robot 1 a legnépszerűbb modellekkel kezdjen.
|
||||
|
||||
🤖 22.1 Robot 1: The Hunter (Paginator v2.4)Cél: Strukturált jármű-variánsok tömeges importálása.Működés: - Recon: Megszámolja az adott márkához tartozó összes rekordot ($select=count(*)).Paging: 1000-es csomagokban, módszeresen végiglapozza a teljes adatbázist.Deduplikáció: Csak az egyedi technikai variánsokat (Márka + Modell + ccm + kW) menti el a data.vehicle_model_definitions táblába.
|
||||
|
||||
🤖 22.2 Robot 2.1: The Researcher (Industrial-v2.1)Cél: Technikai kontextus és szervizspecifikációk "porszívózása" az internetről.Működés:DuckDuckGo/Google Search segítségével adatokat gyűjt: olajmennyiség, viszkozitás, gumiabroncs nyomás, vezérlés csereperiódus, gyújtógyertya típus.A nyers szöveget a raw_search_context mezőben tárolja el a későbbi feldolgozáshoz.
|
||||
|
||||
🤖 22.3 Robot 2.2: The Alchemist (AI-Gold v2.2)Cél: A kutatott szövegek strukturált JSON-ná (Arannyá) alakítása.Működés:LLM (Ollama/Gemini) segítségével kinyeri a technikai adatokat a kutatási kontextusból.Factory Data Mapping: Betölti a data.vehicle_catalog táblába a végleges adatokat.Validation: Ha az adat ellentmondásos, manual_review státuszba helyezi a rekordot.
|
||||
|
||||
🤖 22.4 Robot 2.3: The Guardian (Predictive Notifier)Cél: Napi monitorozás és prediktív értesítések generálása (07:00-08:00 UTC).Logika: - Okmányfigyelő: Figyeli a data.assets és data.persons táblák lejárati dátumait (Műszaki, Biztosítás, Adó, Orvosi).Karbantartási Naptár: Összeveti az utolsó szerviz óta eltelt időt/kilométert a factory_data intervallumaival.Értesítési Mátrix: - 30 nappal / 1000 km-rel előbb: Emlékeztető (Lite).7 nappal / 200 km-rel előbb: Sürgető (Action Required).Lejárat napján: Kritikus riasztás.Kimenet: Bejegyzés a data.notification_queue táblába (Email/Push).
|
||||
|
||||
🛠 22.5 Adatminőség & Validációs RangsorA rendszer megkülönbözteti az adatok forrását, ami befolyásolja a jármű "Trust Score"-ját:ForrásHitelességi szintHatása az Asset-rePartner SzervizHigh (Verified)Digitális szervizkönyv pecsétet kap.User (Számlával)MediumFeltöltött dokumentumhoz kötött, admin jóváhagyásra várhat.User (Csak adat)LowTájékoztató jellegű, a jármű értékét nem növeli hivatalosan.
|
||||
|
||||
💰 22.6 Költségcsoportosítás & Elszámolás (TCO)A költségek a data.asset_costs táblában rögzülnek az alábbi csoportosításban:Üzemanyag: Tankolások, fogyasztásmérés.Karbantartás: Alkatrész, munkadíj.Adók & Díjak: Biztosítás, adó, matrica.Munkába járás: Automatikus kalkuláció a munkanapok és a rögzített távolság alapján (NAV/Helyi norma szerinti térítés).
|
||||
Reference in New Issue
Block a user