(Mit csinálunk most?)
# 🗺️ ROADMAP & TECH DEBT

# 🗺️ ROADMAP & TECH DEBT (v1.4)

## 🚧 SPRINT 1 (Azonnali - Stabilitás)
1.  **Frontend Config:** Hardkódolt IP-k cseréje `.env` változókra.
2.  **Step 1 Regisztráció Fix:** A meglévő endpoint átalakítása "Lite" regisztrációra (csak User létrehozás, `is_active=False`).
3.  **Enum Case Sensitivity:** Minden DB query felülvizsgálata, hogy a `role` mező kényszerítve kisbetűs legyen.
4.  **Security Module:** `create_access_token` és `verify_password` funkciók véglegesítése a `core/security.py`-ban.

## 🚧 SPRINT 2 (KYC & Onboarding)
1.  **Step 2 KYC Endpoint:** `POST /api/v1/auth/complete-kyc` megvalósítása.
2.  **Atomi Tranzakció Logic:** A Person, Wallet és Private Org egyidejű létrehozása a KYC beküldésekor.
3.  **Verification Email:** Aktiváló link generálása és kiküldése hash kóddal.
4.  **Admin UI Settings:** Felület a `system_settings` tábla kezeléséhez.

## 📅 SPRINT 3 (Marketplace MVP)
1.  **OCR Pipeline:** Számla/Okmány fotó feltöltés MinIO-ba + AI validáció teszt.
2.  **Service Request:** Frontend űrlap ajánlatkéréshez.


# ROADMAP & TECH DEBT (v1.0)
## 🚧 SPRINT 1 (Azonnali)
1. **Frontend Config:** Hardkódolt IP-k cseréje `.env` változókra.
2. **Person Migráció:** DB szkript futtatása (User -> Person).
3. **API Fix:** `/api/v1/users/me` 404 javítása.
4. **Soft Delete:** Ellenőrzés, hogy minden `SELECT` tartalmazza-e a `deleted_at IS NULL` feltételt.

## 📅 SPRINT 2 (Marketplace MVP)
1. **OCR Pipeline:** MinIO feltöltés + Tesseract teszt.
2. **Service Request:** Frontend űrlap ajánlatkéréshez.
3. **Ranking Engine:** Távolság + Súlyozás algoritmus implementálása.

# 13. Roadmap és Technikai Adósság (v1.2.6)

Ez a dokumentum rögzíti a rendszer fejlesztési fázisait és azokat a technikai kompromisszumokat, amelyeket a gyors haladás érdekében hoztunk, de később felülvizsgálatot igényelnek.

## 13.1 Rövid távú Roadmap (Q1-Q2)

### 1. Intelligens Kereső API (Fuzzy Search)
- **Cél:** A `synonyms` mezőben tárolt alternatív nevek kihasználása.
- **Megvalósítás:** PostgreSQL `tsvector` és `GIN` indexek használata, hogy a kereső akkor is találjon eredményt, ha a felhasználó "Tracer"-t ír be "Yamaha MT-09 Tracer" helyett.


### 2. Média Kezelés & MinIO Integráció
- **Cél:** Járműfotók automatikus beszerzése.
- **Megvalósítás:** Új bot fejlesztése, amely a dúsított `marketing_name` alapján hivatalos sajtófotókat keres, és azokat a már futó MinIO objektumtárba menti.

### 3. Robot 4: Service Hunter (Szerviz-logika)
- **Cél:** Karbantartási tervek generálása.
- **Megvalósítás:** A `specifications` (olajmennyiség, gyertya típus) mezőkből kiindulva szerviz-csomagok és árak kalkulálása.

## 13.2 Technikai Adósság (Tech Debt)

### 1. Adattípus Optimalizálás: JSON vs. JSONB
- **Helyzet:** A `synonyms` és `specifications` mezők jelenleg `JSON` típusúak.
- **Adósság:** A Postgres függvények (pl. `jsonb_array_length`) használatához folyamatos casting (`::jsonb`) szükséges, ami lassítja a lekérdezéseket.
- **Megoldás:** Egy Alembic migráció keretében az összes JSON oszlopot át kell állítani `JSONB` típusra.


### 2. "N/A-{id}" és "UNKNOWN-{id}" Kódok Tisztítása
- **Helyzet:** A NOT NULL és UNIQUE kényszerek miatt a robot egyedi ál-kódokat generál, ha az AI nem talál gyári kódot.
- **Adósság:** Ezek nem valódi technikai kódok.
- **Megoldás:** Szükséges egy manuális felülvizsgálati (Manual Review) felület, ahol az operátorok a `N/A` kódú rekordokat ellenőrizhetik vagy egyesíthetik.

### 3. AI Response Parsing (Regex Workaround)
- **Helyzet:** A Gemini Search Tool letiltja a kényszerített JSON választ, ezért Regex-szel bányásszuk ki a JSON-t a nyers szövegből.
- **Adósság:** Ez a megoldás törékeny, ha az AI stílusa jelentősen megváltozik.
- **Megoldás:** Monitorozni kell az AI API frissítéseit; amint a Google engedélyezi a Search + Controlled Generation kombinációt, vissza kell térni a natív JSON módra.

## 13.3 Hosszú távú Vízió (Q3+)
- **Trust Engine:** A járművek történetének és szervizadatainak hitelesítése.
- **Global Fleet Insight:** Flottaszintű elemzések készítése a dúsított MDM adatok alapján.