feat: Robot ecosystem v1.2.6 - Google Search RAG & Master-Merge logic stabilized

docs/V01_gemini/13_Roadmap_Tech_Debt.md

@@ -30,4 +30,45 @@
 ## 📅 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.
+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.