STABLE: KYC and Auth working, before Asset refactor

docs/V01_gemini/15_Changelog.md

@@ -93,3 +93,28 @@ A fejlesztések rendben tartásához javaslom a **`17_DEVELOPER_NOTES_AND_PITFAL
 
 **Holnap reggel frissíted a GEM beállításokat is?** Ha igen, a következő lépésben elkészíthetem neked a Step 2 (KYC) végleges Pydantic sémáját és a `complete-kyc` végpont vázlatát!
 
+## [0.2.0] - 2026-02-07
+
+### ✨ Hozzáadva (Added)
+- **Step 2 (KYC) Folyamat:** Teljes körű identitás-kezelés (telefonszám, születési adatok, okmányok, ICE kontakt).
+- **Automata Privát Flotta:** Minden felhasználóhoz automatikusan létrejön egy `individual` típusú szervezet (Privát Széf).
+- **Automata Wallet:** Minden validált felhasználó kap egy üres pénztárcát (Coin és XP egyenleggel).
+- **Trust Tiers:** Bevezetésre került a fokozatos bizalmi szint (Tier 1: Email, Tier 2: KYC/Active).
+
+### 🛠️ Javítva (Fixed)
+- **SQLAlchemy Async Fix:** `joinedload` alkalmazása a User-Person kapcsolathoz (MissingGreenlet hiba elhárítva).
+- **JSON Serialization:** Pydantic `model_dump(mode='json')` használata a JSONB mezőkhöz (dátum-konverziós hiba javítva).
+- **Postgres Schema:** `data.organizations` tábla bővítve hiányzó oszlopokkal (`is_verified`, `updated_at`, stb.).
+- **Auth Endpoint:** `/complete-kyc` végpont hozzáadva és JWT védelemmel ellátva.
+
+### ⚙️ Adatbázis Változások (Database)
+- Új Enum típus: `data.orgtype` ('individual', 'company').
+- `data.persons` bővítve: `phone`, `birth_place`, `birth_date`, `mothers_name`, `identity_docs`, `ice_contact`.
+- `data.organizations` bővítve: `is_verified`, `is_transferable`, `verification_expires_at`, `updated_at`.
+
+## [0.2.0] - 2026-02-07
+### ✅ Step 2 KYC & Activation Complete
+- **Funkció:** Teljes körű személyazonosság-kezelés és fiókaktiválás.
+- **Automatizálás:** Regisztrációkor automatikusan létrejön a "Privát Flotta" (Organization) és a digitális pénztárca (Wallet).
+- **Adatvédelem:** Elkészült a "Digitális Széf" logika az okmányok és vészhelyzeti adatok biztonságos tárolására.
+- **Technikai fix:** SQLAlchemy `joinedload` integráció az aszinkron adatkezeléshez és JSON-safe dátumkezelés.

docs/V01_gemini/18_ASSET_AND_FLEET_SPECIFICATION.md

@@ -0,0 +1,69 @@
+# 🏎️ 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.