74 lines
4.3 KiB
Markdown
74 lines
4.3 KiB
Markdown
(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. |