service-finder/docs/V01_gemini/15_Changelog.md

(Változásnapló.)

📜 CHANGELOG

[1.0.1] - 2026-02-06

Hozzáadva

• Unified Auth Module: Integrált Belépés, Lite Regisztráció és Elfelejtett jelszó kezelés.
• Email Rendszer: SendGrid integráció SMTP fallback lehetőséggel.
• KYC Előkészítés: is_active flag bevezetése a User és Person modellekben a 2-lépcsős folyamathoz.

Javítva

• SQLAlchemy Mapper Fix: Megszűnt az owned_organizations körkörös függőségi hiba.
• Típus Szinkron: Person.id javítva BigInteger típusra a Postgres sémával összhangban.
• Import Fixek: app.db.base_class -> app.db.base útvonalak egységesítve.

Technikai adatok

• Konténer állapot: Stabil (running)
• Regisztrációs folyamat: Step 1 (Lite) tesztelve, sikeres.

[1.0.0] - 2026-02-03

• Init: Grand Master Book létrehozása.
• Arch: Átköltözés a 80 magos szerverre.
• Spec: Kredit rendszer, Tiers, Soft Delete és Person logika véglegesítése.

[2026-02-04] - Identity & Company Sync (v1.2)

• Modell Konszolidáció: Az app.models.identity lett a központi identitáskezelő (User, Person, Wallet).
• Master Book v1.2 Implementáció: Bevezetésre került a céges verifikációs logika (is_verified) és a 30 napos türelmi idő kezelése.
• Integritás javítás: Az Organization tábla bővítve lett is_transferable és hitelesítési mezőkkel.
• Bugfix: security.py IndentationError javítva, auth_service.py atomikus regisztrációs flow Master Book szinkronizálva.
• Security: PostgreSQL tábla-tulajdonosi jogosultságok felülvizsgálata a migrációs hibák elhárításához.

[2026-02-05] - Identity & Company Sync (v1.2)

• Database Security: Javítva a user_vehicle_equipment tábla tulajdonosi jogosultsága (shared-postgres környezetben).
• Core Fix: A security.py állomány behúzási hibái (IndentationError) véglegesen elhárítva.
• Organization v1.2: Implementálva az is_transferable, is_verified és verification_expires_at mezők a flották hitelesítéséhez.
• AuthService Logic: - Az INDIVIDUAL típusú flották mostantól alapértelmezetten nem átruházhatóak.
  • Beépítve a 30 napos türelmi idő (grace_period) kalkulációja a cégellenőrzéshez.
  • Atomikus regisztráció kiterjesztve a privát flották automatikus létrehozására.
• Infrastructure: Alembic migrációs lánc szinkronizálva az új modellekkel.

[2026-02-05] - Admin & Economy Finalization (v1.0)

• Admin Management: Teljes hiearchia és területi felosztás kidolgozva (L0-L3).
• Security: "Kill-switch" anomália-figyelés és 2FA kényszerítés rögzítve.
• Economy: 10-5-2% jutalékrendszer és Voucher/Coupon logika specifikálva.
• Synergy: Céges VIP és privát flotta közötti kedvezmény-szinergia kidolgozva.
• Invitations: Meghívó limitációs és anti-spam logika rögzítve.

📓 CHANGELOG - SERVICE FINDER

[1.2.1] - 2026-02-05

✅ Hozzáadva (Added)

• Multi-step Social Auth: User modell bővítve social_provider és social_id mezőkkel.
• Flotta Tulajdonjog: Organization modellben is_transferable flag implementálva (Individual flotta zárolva).
• Referral Snapshot: Előkészítve a 10-5-2%-os jutalékrendszer adatmodellje.

🛠️ Javítva (Fixed)

• SQLAlchemy Mapper: Megszűnt a UserVehicle KeyError hiba a string-alapú hivatkozásokkal.
• Duplikáció: Vehicle osztály duplikációja eltávolítva a vehicle.py-ból.
• Indentation Error: security.py bcrypt indentációs hiba javítva.

⚠️ Megjegyzés

• Alembic migráció szükséges az új Organization és User mezőkhöz.

📓 CHANGELOG (Rögzítendő változások)

Mivel kérted, itt van a változások listája, amit a teszt után beírhatunk:

Fixed: UserRole enum validációs hiba (Postgres userrole típus mostantól kisbetűs értéket kap).

Added: Teljes banki KYC integráció a regisztrációba (Személyi, Jogosítvány, Speciális engedélyek).

Added: Atomi tranzakció részeként automatikus OrganizationMember létrehozás a privát flottához.

Added: Audit log rögzítése minden sikeres regisztrációról.

Added: Dinamikus paraméterkezelés (system_settings) a 14 napos jutalomhoz.

Elvárt eredmény: A tranzakció végén létrejön a Person, a Wallet (0 Coin) és a Private Fleet (is_transferable=False). A User is_active értéke True lesz.

3. Debugging Checklist

   500 Error? Ellenőrizd a docker logs -f service_finder_api kimenetét. Ha "UndefinedColumn", akkor hiányzik egy SQL mező. Ha "InvalidTextRepresentation", akkor Enum hiba (nagybetűs string).

   Üres Swagger? Ellenőrizd az importokat a security.py-ban és a sémákat az endpoints/auth.py-ban.

---

💡 Javaslatom a dokumentáció kiegészítésére:

A fejlesztések rendben tartásához javaslom a 17_DEVELOPER_NOTES_AND_PITFALLS.md fájl aktív használatát is, amit az előző körben küldtem. Ez segít megelőzni, hogy a fejlesztőcsapat újra belefusson a Postgres Enum vagy a Base.metadata.create_all korlátaiba.

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.

[0.3.0] - 2026-02-07

✨ Hozzáadva (Added)

• Asset DNS Modell: Új, univerzális eszközkezelő rendszer (Assets, VehicleCatalog, AssetEvents, AssetRatings).
• Harvester Robot: Automata adatgyűjtő rendszer, amely külső forrásokból tölti fel a globális járműkatalógust.
• UUID Implementáció: Az eszközök (Assets) és események (Events) mostantól biztonságos UUID azonosítókat használnak.

⚙️ Adatbázis Változások (Database)

• data.vehicle_catalog tábla létrehozva a globális specifikációknak.
• data.assets tábla létrehozva a konkrét példányok (VIN/HIN alapú) tárolására.
• data.asset_events és data.asset_ratings táblák az életút és közösségi visszajelzések kezelésére.

🛠️ Refaktor (Refactor)

• Modell Konszolidáció: A korábbi Vehicle és VehicleBrand modellek beolvasztva az új Asset és VehicleCatalog struktúrába.
• Kapcsolati Térkép: Az Organization és User modellek frissítve az új Asset logikához.