Refactor: Auth & Identity System v1.4

- Fix: Resolved SQLAlchemy Mapper error for 'UserVehicle' using string-based relationships.
- Fix: Fixed Postgres Enum case sensitivity issue for 'userrole' (forcing lowercase 'user').
- Fix: Resolved ImportError for 'create_access_token' in security module.
- Feature: Implemented 2-step registration protocol (Lite Register -> KYC Step).
- Data: Added bank-level KYC fields (mother's name, ID/Driver/Boat/Pilot license expiry and categories).
- Business: Applied private fleet isolation (is_transferable=False for individual orgs).
- Docs: Updated Grand Master Book to v1.4 and added Developer Pitfalls guide.

docs/V01_gemini/06_Database_Guide.md

@@ -1,5 +1,35 @@
 (Az Adatbázis Bibliája.)
 # 🗄️ DATABASE GUIDE
+# 🗄️ DATABASE GUIDE & DATA INTEGRITY (v1.4)
+
+## 1. Soft Delete & Újraregisztráció Logika
+A rendszerben nincs fizikai törlés. A `data.users` tábla az alábbi módon kezeli a visszatérő felhasználókat:
+- **Indexelés:** Az `email` mezőn egy *Partial Unique Index* (`idx_user_email_active_only`) található.
+- **Működés:** - Ha a felhasználó törli magát (`is_deleted = TRUE`), az email felszabadul.
+    - Új regisztrációkor, ha a KYC adatok egyeznek, az új technikai User a régi `person_id`-hoz kapcsolódik.
+
+## 2. Person (Identitás) - Banki KYC & Safety
+A `data.persons` tábla a valós identitást tárolja. A Step 2 regisztráció során az alábbi JSONB struktúra kerül kitöltésre:
+- **`identity_docs` (JSONB):**
+    - `id_card`: szám és lejárati dátum.
+    - `driver_license`: szám, lejárat és kategóriák (pl. ["A", "B", "C"]).
+    - `special_permits`: hajóvezetői és repülőgép-vezetői engedélyek.
+- **`medical_emergency` (JSONB):** Vércsoport, allergiák, krónikus betegségek.
+- **Jutalom Trigger:** A profil 100%-os kitöltése után aktiválódik a `system_settings`-ben megadott PRÉMIUM időszak.
+
+## 3. Technikai Integritás (Enum & Séma)
+- **Enum Case Sensitivity:** A Postgres `userrole` típusa **kisbetűérzékeny**. A Python kódból érkező értékeket (pl. `user`, `admin`) kényszerítve kisbetűvel kell rögzíteni.
+- **Séma Frissítés:** Mivel a `metadata.create_all` nem frissíti a meglévő táblákat, új oszlopok esetén (pl. `social_provider`, `mothers_name`) manuális `ALTER TABLE` vagy Alembic migráció szükséges.
+
+## 4. Dinamikus Paraméterezés (`data.system_settings`)
+Minden üzleti változó Admin UI-ról állítható:
+- `auth.reward_days`: Regisztrációs prémium hossza (alapértelmezett: 14).
+- `referral.l1`: Első szintű jutalék % (alapértelmezett: 10).
+
+## 5. Flotta Tulajdonjog Szabályok (v1.1)
+- **`INDIVIDUAL` flotta:** Nem átruházható (`is_transferable = False`), a felhasználóhoz kötött.
+- **`FLEET_OWNER / SERVICE` flotta:** Átruházható, új tulajdonoshoz rendelhető.
+
 
 # 🗄️ DATABASE GUIDE & DATA INTEGRITY (v1.0)