service-finder/docs/V01_gemini/18_ASSET_AND_FLEET_SPECIFICATION.md

🏎️ Asset és Flotta Specifikáció: A Járművek DNS-e

Ez a dokumentum írja le a rendszer magját képező "széf" logikát, ahol minden közlekedési eszköz (Asset) egyedi életutat és digitális lenyomatot kap.

1. Az Alapelv: "Mindenki Flottatulajdonos"

A rendszerben nincs különbség egy magánszemély és egy cég között a technikai rétegben.

• Privát Flotta: A regisztráció (Step 2) során automatikusan létrejövő szervezet (Organization).
• Széf (Safe Deposit): A flotta része, ahol az eszközök (járművek) és azok bizalmas okmányai laknak.

2. Eszköz Típusok és Speciális Azonosítók

Minden eszköz rendelkezik egy Univerzális Állandó Azonosítóval (UAI), ami az életútja során soha nem változik.

Típus	Elsődleges Azonosító (UAI)	Speciális Adatpontok
Közúti	VIN (Alvázszám)	Rendszám, Motorkód, Sebességváltó kód
Vízi	HIN (Hull ID / Testszám)	MMSI kód, IMO szám, Név
Légi	Serial Number (Gyári szám)	Lajstromjel (Registration), Típusjelzés
Egyéb	Egyedi sorozatszám	Gyártó, Teljesítmény

Kiegészítő mérőszámok:

• Futásteljesítmény (Odometer): Közúti járműveknél (km/mérföld).
• Üzemóra (Operating Hours): Hajók, repülők, munkagépek és versenytechnika esetén kritikus.

3. A Jármű DNS (Deep Data Structure)

Az adatbázisnak ismernie kell a járművet "gyári" állapotában és annak minden módosítását.

A) Gyári Konfiguráció (Factory Specs)

• Trim Level: Felszereltségi csomag (pl. S-Line, AMG Pack, Comfortline).
• Technikai paraméterek: Motorválaszték, kW/LE, nyomaték, gyári felni- és gumiméret (ET számmal), folyadékmennyiségek.
• Szervizintervallumok: Gyártó által előírt periodikus karbantartások (idő vagy távolság alapú).

B) Aktuális Állapot és Módosítások (Modifications)

• Gyári extrák: Mi az, ami benne maradt? (pl. bőrbelső, napfénytető).
• Utólagos (Aftermarket): Mi került bele? (pl. vonóhorog, gázszett).
• Hiányzó: Mi került ki belőle? (pl. kiszerelt gyári hifi).

4. Digitális Szervizkönyv (Digital Service Book)

Nem csak egy lista, hanem egy Eseményalapú Idővonal (Timeline). Minden bejegyzés megváltoztathatatlan (immutable-szerű) logként rögzül.

• Típusok: Karbantartás, Javítás, Műszaki Vizsga, Baleset, Tulajdonosváltás.
• Csatolmányok: Fotók az alkatrészekről, számlák PDF-ben, munkalapok.

5. Jármű Minősítés és Értékelés

A jármű két különálló, de egymást kiegészítő minősítést kap:

A) Technikai Minősítés (AI Health Score)

• Algoritmus alapú: A szerviztörténet, az üzemóra/futás aránya és a gyári specifikációk betartása alapján kalkulált pontszám.

B) Emocionális és Közösségi Értékelés (Driver Rating)

A járművet használó sofőrök értékelhetik az eszközt szubjektív szempontok alapján:

• Komfort: Mennyire kényelmes hosszú távon?
• Vezetési élmény: "Lelke van", vagy csak egy gép?
• Praktikum: Mennyire használható a mindennapokban?
• Megbízhatóság érzet: Mennyire érzi magát benne biztonságban a sofőr?

Ez a kettős mérőszám adja meg a jármű valós "piaci és használati értékét".

6. Az Adat-Gondnok (Harvester Robot)

A rendszer integritásáért és az adatok pontosságáért egy automata Robot felel.

Funkciók:

1. Initial Load: A legnépszerűbb 1000 európai járműtípus alapértelmezett feltöltése.
2. On-Demand Fetch: Ha egy felhasználó ismeretlen típust keres, a Robot prioritással kutatja fel és rögzíti azt.
3. Deep Data Scrape: A Robot nemcsak a típust, hanem a gyári specifikációkat (olajmennyiség, guminyomás, szervizintervallum) is gyűjti.
4. Maintenance: Negyedévente frissíti a meglévő adatokat (új modellévek, módosított gyári előírások).

Adatforrások hierarchiája:

1. Hivatalos gyártói API-k (ahol elérhető).
2. Nyilvános műszaki adatbázisok (Auto-Data, UltimateSpecs).
3. VIN/HIN dekóder algoritmusok.

7. Kivételkezelés: Ismeretlen és Egyedi Járművek

Ha egy jármű nem található a globális katalógusban, a rendszer kétlépcsős mentőövet nyújt:

A) On-Demand Harvester (Robot hívása)

1. A felhasználó jelzi, hogy hiányzik a típus.
2. A Robot utasítást kap egy mélyebb keresésre (Deep Web Search).
3. Ha találat van, a Robot rögzíti a katalógusba, és a felhasználó folytathatja a rögzítést.

B) Custom Asset (Egyedi/Sport jármű rögzítése)

Ha a jármű sehol nem szerepel (pl. épített versenyautó, egyedi yacht):

1. Manuális nyilatkozat: A felhasználó rögzíti az adatokat.
2. Dokumentum alapú validáció: A forgalmi engedély vagy sportigazolvány fotóját kötelező feltölteni.
3. AI Verifikáció: A rendszer OCR-rel (szövegfelismerés) kiolvassa az adatokat a fotóról, és összeveti a manuális bevitelével.
4. "Unverified Model" jelzés: A katalógusban egyedi azonosítót kap, amíg egy admin vagy a Robot más forrásból meg nem erősíti.

8. Multi-Robot Harvester Architektúra

A rendszer kategóriánként különálló kutató robotokat használ az erőforrások optimalizálása és az adatok pontossága érdekében.

A) Működési elv

• Ütemezett futás: Minden kategória (Autó, Motor, Teher, Hajó) saját időablakban frissít, elkerülve a szerver túlterhelését.
• Hiányos adatok kezelése: A Robot köteles rögzíteni a járművet akkor is, ha csak részleges információt talál (pl. csak márka és típus).
• Státusz jelölések (verification_status):
  • verified: Teljes DNS adatsor (Robot által hitelesítve).
  • incomplete: Alapadatok megvannak, de hiányoznak technikai részletek (pl. guminyomás, olaj).
  • pending: Felhasználó által felvett, Robot általi ellenőrzésre váró egyedi típus.

B) On-Demand prioritás

Amikor a felhasználó olyan típust keres, ami nem szerepel a katalógusban, a rendszer egy "Priority Trigger"-t küld az adott kategória Robotjának, amely soron kívül megkezdi a célzott adatgyűjtést.

9. OCR és Dokumentum Validációs Stratégia

A rendszer a járműokmányok (forgalmi engedély, hajólevél, lajstrom) feldolgozására hibrid OCR (Optical Character Recognition) technológiát alkalmaz.

A) Hibrid Feldolgozási Sorrend (Failover Logic)

A költséghatékonyság és a pontosság érdekében a rendszer az alábbi sorrendben próbálkozik:

1. Tier 1 (External Free/Limited APIs): Ingyenes keretű felhő szolgáltatások (pl. Google Vision API, Azure Form Recognizer). A rendszer figyeli a havi limiteket, és azok elérésekor automatikusan vált a következő szolgáltatóra.
2. Tier 2 (Saját Erőforrás - Fallback): Ha minden ingyenes külső keret elfogyott, a rendszer a saját szerveren futó PaddleOCR (AI alapú) modult használja.

B) Monetizáció és Jogosultságok

A dokumentum alapú automata rögzítés és validáció prémium funkció:

• Free/Lite: Manuális rögzítés (limitált mezők).
• VIP: Automata rögzítés (OCR) 1-2 eszközre.
• VIP + / Premium +: Korlátlan okmányfelismerés, automata lejárati figyelmeztetések és hivatalos adat-összevetés.

10. Multi-Robot Harvester (Moduláris Felépítés)

A járműkatalógus feltöltését egy bázis-osztályra (BaseHarvester) épülő, kategória-specifikus robotcsalád végzi.

• Autó Robot: Közúti gépjárművekre optimalizálva.
• Motor Robot: Kétkerekű és hobbi járművekre.
• Heavy Duty Robot: Teherautók, kamionok és munkagépek specifikációira.
• Specialty Robot: Vízi és légi járművek egyedi azonosítóihoz (MMSI, Lajstrom).

🏎️ Asset és Flotta Specifikáció: A Járművek DNS-e (v1.2)

7. Kivételkezelés: Ismeretlen és Egyedi Járművek

• On-Demand Harvester: Ha a katalógus hiányos, a Robot kérésre (Trigger) indítja a mélykeresést.
• Custom Asset: Egyedi/Sport eszközök rögzítése dokumentum alapú validációval.

8. Multi-Robot Harvester Architektúra

A rendszer kategória-specifikus (Car, Bike, Truck, Specialty) robotokat használ.

• Ütemezés: Éjszakai batch-futás a szerver terhelésének minimalizálására.
• Státuszok: verified (teljes), incomplete (részleges), pending (ellenőrzésre vár).

9. VIN (Alvázszám) és Validáció

• Algoritmus: Minden közúti járműnél kötelező a VIN Checksum (MOD 11) ellenőrzése a beíráskor.
• Auto-Fill: Érvényes alvázszám esetén a rendszer felajánlja a gyártói adatok (gyártási év, üzem, motorverzió) automatikus kitöltését.

10. Dokumentum Kezelés és Tárolás (NAS)

Minden eszközhöz csatolt dokumentum (forgalmi, fotók, számlák) központi NAS tárolón kerül rögzítésre.

• Elérési út: /mnt/nas/app_data/assets/{asset_id}/
• Archiválás: /mnt/nas/git_vault/ (Adatbázis mentések és konfigurációk).

11. OCR és Üzleti Logika (Tier-based)

A dokumentumfelismerés (OCR) prioritása a felhasználói csomagtól függ:

• VIP+ / Premium+: Azonnali (Real-time) OCR feldolgozás. A felhasználó a feltöltés után 3-5 másodperccel már látja az előtöltött adatokat.
• Alap csomag: Háttérfolyamat (Background task). A feldolgozás sorban állítás után történik, a felhasználó értesítést kap a befejezésről.
• Failover: Külső API-k (Google/Azure) és saját erőforrás (PaddleOCR) hibrid használata a költségkontroll érdekében.

12. OCR Monetizáció és Kreditszabályok (Admin Kontroll)

A rendszer az OCR alapú adatbeolvasást kvótákhoz és kreditekhez köti.

A) Csomag alapú kvóták (Admin beállítás)

Az Admin felületen csomagonként (Lite, VIP, VIP+) meghatározható egy ingyenes havi dokumentum-beolvasási keret:

• Lite: 0-1 scan/hó.
• VIP: 10 scan/hó.
• VIP+: Korlátlan vagy magas limit (pl. 100).

B) Kreditalapú túllépés

Ha a felhasználó kimerítette a keretét, minden további beolvasás kreditért vásárolható meg.

• Egységár: Admin felületről állítható (pl. 1 beolvasás = 10 kredit).
• Tranzakció: A rendszer levonja a kreditet a felhasználó Wallet-jéből a sikeres OCR feldolgozás után.

C) Egyedi engedélyek (Permissions)

Lehetőség van egyedi felhasználóknak vagy flottáknak "OCR_Override" jogot adni, amivel a csomagtól függetlenül ingyenes vagy kedvezményes beolvasást kapnak (pl. tesztelők vagy stratégiai partnerek).

13. Kiterjesztett Jármű Kategóriák

A rendszer az alábbi kategóriákat különbözteti meg az életút- és költségkövetéshez:

• Bus: Tömegközlekedési és távolsági buszok.
• Motorhome: Lakóautók és speciális lakókocsik.
• Trailer: Utánfutók, pótkocsik, trélerek.
• Construction: Munkagépek (markolók, daruk).
• Agriculture: Mezőgazdasági vontatók, kombájnok.
• Micro-mobility: E-roller, e-bike flották.

18. ASSET ÉS FLOTTA SPECIFIKÁCIÓ (v1.1)

1. Dokumentum Tárolási és Feldolgozási Stratégia

A rendszer a tárhelyköltségek optimalizálása és a gyors elérés érdekében hibrid tárolást alkalmaz:

A) Tárolási típusok

• Vault (Tartós): Jogilag kritikus okmányok (Alapító okirat, Forgalmi, Adásvételi).
  • Tárolás: NAS, hash-elt fájlnévvel.
  • Elérhetőség: Korlátlan ideig, amíg az Asset/Szervezet aktív.
• Ephemeral (Ideiglenes): Napi bizonylatok (Parkolási jegy, Tankolási nyugta).
  • Folyamat: Feltöltés -> OCR adatkinyerés -> Adatbázis rögzítés -> Kép törlése (90 nap után).

B) Képoptimalizálási Motor

Minden feltöltött dokumentum (JPG/PNG) automata feldolgozáson esik át:

• Átmretezés: Max 1600px szélesség.
• Formátum konverzió: WebP (veszteségmentes tömörítés).
• Eredmény: ~80-90%-os tárhely megtakarítás olvashatóság vesztése nélkül.

2. Címkezelési Protokoll (Atomizált Adatok)

A pontos szűrés és a hivatalos iratok generálása érdekében a címeket az alábbi bontásban tároljuk:

• Irányítószám (IRSZ)

• Település (Város)

• Közterület neve

• Közterület jellege (utca, út, tér, stb. - választható listából)

• Házszám (emelet, ajtó, lépcsőház kiegészítéssel)

  Címkezelés (v2.0): Minden magánszemély és szervezet címét atomizált formában tároljuk (IRSZ, Város, Utca, Házszám, HRSZ). Ez alapfeltétele a későbbi flotta-riportoknak és a pontos térképi megjelenítésnek.