service-finder/docs/V01_gemini/13_Roadmap_Tech_Debt.md

(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.