- 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.
1.2 KiB
1.2 KiB
🛠️ DEVELOPER NOTES & TROUBLESHOOTING
1. ADATBÁZIS ÉS SQL FIXEK
Postgres Enum Case Sensitivity
- Probléma: Az SQLAlchemy Enum típusa és a Postgres Enum típusa ütközhet, ha a Python kódban nagybetűs stringet (
USER) küldünk. - Megoldás: Mindig használd a
.valueproperty-t vagy kényszerítsd a kisbetűs stringet:role="user".
Tábla oszlopok frissítése
- Probléma: A
Base.metadata.create_allnem adja hozzá az új oszlopokat a már meglévő táblákhoz. - Megoldás: Új mező esetén (pl.
social_provider,mothers_name) manuálisALTER TABLEparancsot kell futtatni vagy Alembic migrációt generálni.
2. BACKEND API HIBÁK
ImportError: create_access_token
- Ok: A
app.core.securitymodulban hiányzott a funkció, vagy elavult volt az import azendpoints/auth.py-ban. - Javítás: A
security.py-nak tartalmaznia kell ajosekönyvtárat használó tokengenerálást.
Üres Swagger (OpenAPI) felület
- Ok: Ha az SQLAlchemy Mapper vagy egy Pydantic séma importja hibás, a FastAPI nem tudja legenerálni a dokumentációt.
- Javítás: Ellenőrizd a
docker logskimenetét indításkor, keresd aMapperConfigurationErrorvagyImportErrorsorokat.