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

(Változásnapló.)

📜 CHANGELOG

[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!