🗄️ DATABASE GUIDE

🗄️ DATABASE GUIDE & DATA INTEGRITY (v1.0)

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 is_deleted = FALSE, az email nem használható újra.
- Ha a felhasználó törli magát (is_deleted = TRUE), az email felszabadul.
- Új regisztrációkor a rendszer új user_id-t generál, de ha a KYC adatok egyeznek, ugyanahhoz a person_id-hoz kapcsolja az új fiókot.

A data.persons tábla tárolja a banki szintű azonosításhoz szükséges adatokat:

Szétválasztott nevek: last_name és first_name a pontos azonosításhoz.
JSONB mezők: Rugalmas adatszerkezet az okmányokhoz (identity_docs) és vészhelyzeti adatokhoz (medical_emergency).
Jutalom Trigger: A profil 100%-os kitöltése (név, szül. adatok, okmányok) automatikusan aktiválja a 14 napos PRÉMIUM csomagot.

Wallet: Minden regisztrációkor létrejön egy rekord a data.wallets táblában (0 Coin, 0 XP).
Referral Snapshot: A jutalékok kifizetésekor a rendszer rögzíti a tranzakció pillanatában érvényes százalékot (commission_percentage), így a későbbi admin módosítások nem érintik a múltbeli elszámolásokat.

Fleet: vehicles, user_vehicles, vehicle_events, engine_specs.
Marketplace: service_providers, service_specialties, organization_locations.
Economy: wallets, transactions, shop_items.
Identity: users, persons, companies.

Eszköz: Alembic.
Current Head: 10b73fee8967.
Hiányzó láncszem: A persons tábla létrehozása és a meglévő users tábla migrációja (Ba

A rendszer fel van készítve az EU-s piacra:

data.regional_settings: Tárolja az országkódokat (ISO 3166-1), az alapértelmezett nyelvet és a helyi pénznemet.
data.exchange_rates: Napi frissítésű váltószámok (Base: EUR).
Valuta Logika: - Minden költséget a rögzítéskori helyi pénznemben (currency_code) és az akkori váltószámmal átszámított EUR-ban is elmentünk.
- Képlet: Cost_{EUR} = Cost_{Local} \cdot ExchangeRate
- Ez biztosítja, hogy a nemzetközi flották egységes kimutatást kapjanak.

Opcionális Járművek: Egy flotta (Organization) létezhet járművek nélkül is. A rendszer nem kényszeríti a jármű rögzítését (pl. Flotta menedzser szerepkör esetén).
Átruházhatóság (Transferability):
- INDIVIDUAL flotta: Nem átruházható, a felhasználóhoz kötött.
- FLEET_OWNER / SERVICE flotta: Átruházható (eladható), új tulajdonos (owner_id) rendelhető hozzá.
Cég Megszűnése: Soft delete alkalmazása. A cég is_active státusza False lesz, a tulajdonosi viszony megszűnik, de a járművek életútjában (history) az adatok megmaradnak a visszakövethetőség miatt.

Gamification Korlát: Csak INDIVIDUAL típusú flottákhoz tartozó Person-ok vehetnek részt a gamifikációban (XP gyűjtés).
Validációs Korlát: Cég mint identitás nem validálhat szervizpontot, ezt mindig egy hozzárendelt, azonosított Person (alkalmazott/technikus) végzi.

Identitás Elkülönítés: A Company (Szervezet) entitás nem kap XP_Ledger és Coin_Wallet rekordot a gamifikációhoz. Ezek kizárólag a Person (valós személy) szintjén léteznek.
Automatizált Felügyelet: Egy ütemezett feladat (Cron/Celery) havonta ellenőrzi a cégek státuszát a külső adatbázisokban.
Értékelési rendszer (Rating):
- Person: Egyéni teljesítmény, megbízhatóság.
- Service (Szerviz): Szolgáltatási minőség.
- Vehicle (Jármű): Műszaki állapot és előélet.
- Megjegyzés: A Cég (mint flotta) nem kap önálló értékelést, a hírneve a tagjai és járművei minősítéséből adódik össze.