(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. ## [0.3.5] - 2026-02-07 ### ✨ Robot Technológia & Adatbiztonság - **Multi-Robot Architektúra:** Előkészítve a kategória-specifikus (Car, Bike, Truck) Harvester robotok szétválasztása. - **Status Tracking:** Bevezetve a `verification_status` a katalógus elemekhez a hiányos adatok kezelésére. - **SQL Optimalizálás:** Új indexek és kategória alapú szűrések hozzáadva a globális katalógushoz. ## [0.4.0] - 2026-02-07 ### ✨ Multi-Robot System - **Kategória Robotok:** Elkészült a Car, Bike és Truck harvester moduláris szerkezete. - **Robot Manager:** Központi vezérlő az ütemezett és sorrendi adatgyűjtéshez. - **Katalógus Kereső:** Üzembe helyezve a `/catalog/search` végpont a Swaggerben. ## [0.4.5] - 2026-02-07 ### ✨ Asset Management & Infrastructure - **Asset Endpoint:** `POST /api/v1/assets/` élesítve VIN validációval. - **NAS Integration:** Automata mappastruktúra létrehozása az eszközöknek (`/assets/{uuid}`). - **Data Model:** `privacy_level` és `status` mezők hozzáadva az Asset modellhez. - **Bugfix:** SQLAlchemy `TypeError` javítva a modell és a séma szinkronizálásával. ## [0.5.0] - 2026-02-07 ### ✨ Corporate & CRM Foundation - **Corporate Onboarding:** `POST /api/v1/organizations/onboard` végpont élesítve. - **Validation:** Magyar adószám (HU) formátum ellenőrzés beépítve. - **Status Management:** Bevezetve a `pending_verification` állapot a szervezetekhez. - **Database:** PostgreSQL `orgtype` Enum szinkronizálva a Python modellel (kisbetűs mapping). - **NAS:** Automata szervezeti mappa-izoláció (`/organizations/{id}`). [0.5.1] - 2026-02-07 FIX: ModuleNotFoundError javítva az importok szinkronizálásával. DATA: Atomizált címmezők hozzáadva a data.organizations táblához. LOGIC: Háromszintű névkezelés (Hivatalos, Rövid, Display) bevezetve.