Files
service-finder/docs/V01_gemini/17_DEVELOPER_NOTES_AND_PITFALLS.md
Kincses 714de9dd93 Refactor: Auth & Identity System v1.4
- 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.
2026-02-06 00:14:17 +00:00

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 .value property-t vagy kényszerítsd a kisbetűs stringet: role="user".

Tábla oszlopok frissítése

  • Probléma: A Base.metadata.create_all nem 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ális ALTER TABLE parancsot kell futtatni vagy Alembic migrációt generálni.

2. BACKEND API HIBÁK

ImportError: create_access_token

  • Ok: A app.core.security modulban hiányzott a funkció, vagy elavult volt az import az endpoints/auth.py-ban.
  • Javítás: A security.py-nak tartalmaznia kell a jose kö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 logs kimenetét indításkor, keresd a MapperConfigurationError vagy ImportError sorokat.