nyelvi refaktorálás előtt

2026-06-19 09:09:24 +00:00
parent 9ba2d9180d
commit 5b437b220d
17 changed files with 1007 additions and 1088 deletions
--- a/docs/i18n_duplicate_key_analysis.md
+++ b/docs/i18n_duplicate_key_analysis.md
@@ -0,0 +1,242 @@
+# 🌐 i18n Duplikált Kulcsok Összehasonlító Elemzése
+
+**Dátum:** 2026-06-19
+**Készítette:** Rendszer-Architect
+**Cél:** Nyelvi modulok (i18n) kulcsainak felmérése, duplikációk azonosítása, optimalizálási javaslat
+
+---
+
+## 1. Feltárt Fájlok Áttekintése
+
+Összesen **8 i18n fájl** található a projektben, két elkülönült rendszerben:
+
+### 1.1 Frontend (vue-i18n, TypeScript) — `frontend/src/i18n/`
+
+| Fájl | Sorok | Hatókör | Státusz |
+|------|-------|---------|---------|
+| en.ts | ~1603 | Teljes (25 szekció) | ✅ Teljes |
+| hu.ts | ~1600 | Teljes (25 szekció) | ✅ Teljes |
+| de.ts | ~83 | Részleges: menu, header, dashboard, zen, auth | ⚠️ Hiányos |
+| ro.ts | ~83 | Részleges: menu, header, dashboard, zen, auth | ⚠️ Hiányos |
+| cz.ts | ~83 | Részleges: menu, header, dashboard, zen, auth | ⚠️ Hiányos |
+| sk.ts | ~83 | Részleges: menu, header, dashboard, zen, auth | ⚠️ Hiányos |
+
+### 1.2 Backend (statikus JSON) — `backend/static/locales/`
+
+| Fájl | Sorok | Hatókör | Státusz |
+|------|-------|---------|---------|
+| en.json | ~76 | AUTH, SENTINEL, EMAIL, ORGANIZATION | ✅ Teljes |
+| hu.json | ~83 | AUTH, SENTINEL, EMAIL, ORGANIZATION | ⚠️ Aszimmetrikus |
+
+> **⚠️ Fontos:** A frontend és backend rendszerek **teljesen elkülönülnek**. Más kulcs-sémát használnak (dot-notation vs UPPER_SNAKE_CASE), így közöttük NINCS duplikáció.
+
+---
+
+## 2. Frontend Kulcsok Hierarchikus Szerkezete
+
+A frontend i18n rendszer 25 gyökér-szekcióra tagolódik:
+
+```
+common (9 kulcs)        — Általános (cancel, save, select, year, mileage, stb.)
+subscription (11)       — Előfizetések
+landing (20+)           — Nyitóoldal
+menu (8)                — Navigációs menü
+garage (18)             — Garázs felület
+vehicleDetail (20+)     — Jármű részletek
+header (35+)            — Fejléc
+dashboard (40+)         — Irányítópult
+finance (25+)           — Pénzügyi motor
+zen (2)                 — Zen mód
+auth (50+)              — Bejelentkezés, regisztráció
+profile (60+)           — Felhasználói profil
+kyc (20+)               — KYC
+verifyEmail (15+)       — E-mail megerősítés
+company (70+)           — Cég műveletek
+organization (2)        — Szervezeti név
+address (7)             — Cím komponensek
+servicebook (15+)       — Szervizkönyv
+vehicle (200+)          — Jármű adatok
+serviceFinder (30+)     — Szervizkereső
+provider (60+)          — Szolgáltató adatok
+categories (4)          — Kategóriák
+gamification (2)        — Gamifikáció
+admin.services (20+)    — Admin: szolgáltatások
+admin.packages (30+)    — Admin: csomagok
+admin.users (30+)       — Admin: felhasználók
+```
+
+---
+
+## 3. Duplikált Kulcsok Kategorizált Listája
+
+### 3.1 ✅ Pontos Egyezések (Biztonságosan Összevonható)
+
+Ezek a kulcsok **angolban és magyarban is azonos értéket** adnak vissza. Egyetlen közös kulccsá vonhatók össze.
+
+| # | Érintett Kulcsok | EN érték | HU érték | Előfordulás |
+|---|-----------------|----------|----------|-------------|
+| 1 | common.cancel / profile.cancel / servicebook.cancel | "Cancel" | "Mégse" | **3 helyen** |
+| 2 | common.save / profile.save | "Save" | "Mentés" | **2 helyen** |
+| 3 | common.saving / servicebook.saving / vehicle.saving / admin.services.saving / admin.packages.saving | "Saving..." | "Mentés..." | **5 helyen** |
+| 4 | common.back / kyc.back / company.back | "Back" | "Vissza" | **3 helyen** |
+| 5 | common.mileage / garage.mileage / vehicleDetail.mileage | "Mileage" | "Futásteljesítmény" | **3 helyen** |
+| 6 | common.year / garage.year | "Year" | "Évjárat" | **2 helyen** |
+| 7 | common.retry / dashboard.errorRetry | "Retry" | "Újrapróbálkozás" | **2 helyen** |
+| 8 | garage.noPlate / vehicleDetail.noPlate | "No Plate" | "Nincs rendszám" | **2 helyen** |
+| 9 | garage.nextService / vehicleDetail.nextService / vehicle.nextService | "Next Service" | "Következő Szerviz" | **3 helyen** |
+| 10 | vehicleDetail.noData / vehicle.noData | "No data" | "Nincs adat" | **2 helyen** |
+| 11 | header.subtitle / dashboard.subtitle | "Your dashboard and vehicle overview" | "Irányítópultod és járműveid áttekintése" | **2 helyen ⭐** |
+| 12 | garage.backToGarage / profile.backToGarage | "Back to Garage" | "Vissza a Garázsba" | **2 helyen** |
+| 13 | header.profile / profile.title | "Profile Settings" | "Profil beállítások" | **2 helyen** |
+| 14 | dashboard.statusActive / company.fleetActive / admin.users.status_active | "Active" | "Aktív" | **3 helyen** |
+| 15 | vehicleDetail.vin / vehicle.label_vin | "VIN (Chassis Number)" | "Alvázszám (VIN)" | **2 helyen** |
+| 16 | kyc.country / company.country / profile.country | "Country" | "Ország" | **3 helyen** |
+| 17 | kyc.zipCode / company.zipCode / profile.zipCode | "ZIP Code" | "Irányítószám" | **3 helyen** |
+| 18 | kyc.city / company.city / profile.city | "City" | "Város" | **3 helyen** |
+| 19 | kyc.houseNumber / company.houseNumber / profile.houseNumber | "House Number" | "Házszám" | **3 helyen** |
+| 20 | profile.stairwell / company.stairwell | "Stairwell" | "Lépcsőház" | **2 helyen** |
+| 21 | profile.floor / company.floor | "Floor" | "Emelet" | **2 helyen** |
+| 22 | profile.door / company.door | "Door" | "Ajtó" | **2 helyen** |
+| 23 | profile.parcelId / company.parcelId | "Parcel ID" | "Helyrajzi szám" | **2 helyen** |
+| 24 | kyc.streetName / company.streetName / provider.streetNameLabel | "Street Name" | "Utca neve" | **3 helyen** |
+| 25 | kyc.streetType / company.streetType | "Type" | "Típus" | **2 helyen** |
+
+> ⭐ A **#11** (header.subtitle = dashboard.subtitle) a legszembetűnőbb: **teljesen azonos mondat**, mindkét nyelven. Egyértelműen összevonandó.
+
+### 3.2 ⚠️ Kis Eltéréssel (Egyedi Kontextus, Megfontolandó)
+
+| # | Érintett Kulcsok | EN érték | HU érték(ek) | Megjegyzés |
+|---|-----------------|----------|-------------|------------|
+| 26 | common.cancel vs company.cancel vs admin.services.cancel | "Cancel" | "Mégse" / "Mégsem" | "Mégsem" elütés? |
+| 27 | finance.retry vs common.retry vs dashboard.errorRetry | "Retry" | "Újra" / "Újrapróbálkozás" | finance.retry rövidebb |
+| 28 | vehicleDetail.vin vs vehicle.label_vin | "VIN" / "VIN (Chassis Number)" | "Alvázszám (VIN)" | EN nem azonos |
+| 29 | company.streetType vs profile.streetType | "Type" / "Street Type" | "Típus" / "Közterület jellege" | Profile formalisabb |
+| 30 | company.email vs provider.emailLabel | "Email" / "Email" | "E-mail" / "E-mail cím" | Provider explicitabb |
+| 31 | company.phone vs provider.phoneLabel | "Phone" / "Phone" | "Telefonszám" / "Telefon" | Különböző hossz |
+| 32 | dashboard.addVehicle vs menu.addVehicle | "+ Add Vehicle" / "+ Add New Vehicle" | "+ Jármű Hozzáadása" / "+ Új Jármű Hozzáadása" | Menü-ben "New" |
+
+### 3.3 🔄 Jármű Funkciók Átfedései
+
+A vehicle.features (~130), vehicle.motorcycleFeatures (~70), vehicle.lcvFeatures (~40) és vehicle.hgvFeatures (~90) között jelentős átfedés.
+
+#### Pontos egyezések (összevonható):
+
+| Kulcs | EN | HU | Érintett szekciók |
+|-------|----|----|------------------|
+| cruise_control | "Cruise Control" | "Tempomat" | features, motorcycleFeatures, lcvFeatures |
+| alloy_wheels | "Alloy Wheels" | "Könnyűfém felni" | features, lcvFeatures |
+| garage_kept | "Garage Kept" | "Garázsban tartott" | features, motorcycleFeatures |
+| xenon_headlights | "Xenon Headlights" | "Xenon fényszóró" | features, lcvFeatures |
+| fog_lights | "Fog Lights" | "Ködlámpa" | features, lcvFeatures |
+| sunroof | "Sunroof" | "Napfénytető" | features, lcvFeatures |
+| heated_seat | "Heated Seat" | "Fűthető ülés" | motorcycleFeatures, lcvFeatures |
+| navigation | "Navigation (GPS)" | "Navigáció (GPS)" | features, hgvFeatures |
+| apple_carplay | "Apple CarPlay" | "Apple CarPlay" | features, hgvFeatures |
+| android_auto | "Android Auto" | "Android Auto" | features, hgvFeatures |
+| bluetooth | "Bluetooth" | "Bluetooth" | features, hgvFeatures |
+| wireless_charging | "Wireless Charging" | "Vezeték nélküli töltő" | features, hgvFeatures |
+| dab_radio | "DAB+ Digital Radio" | "DAB+ digitális rádió" | features, hgvFeatures |
+| premium_sound | "Premium Sound System" | "Prémium hangrendszer" | features, hgvFeatures |
+| wifi_hotspot | "WiFi Hotspot" | "WiFi Hotspot" | features, hgvFeatures |
+| adaptive_cruise | "Adaptive Cruise Control (ACC)" | "Adaptív tempomat (ACC)" | features, hgvFeatures |
+| 360_camera | "360° Camera" | "360°-os kamera" | features, hgvFeatures |
+| parking_sensors_rear | "Rear Parking Sensors" | "Hátsó parkolóérzékelők" | features, lcvFeatures |
+
+#### Eltérő magyar fordítás (manuális átgondolást igényel):
+
+| Kulcs | EN (features) | EN (másik) | HU (features) | HU (másik) | Forrás |
+|-------|--------------|------------|---------------|------------|--------|
+| abs | "ABS" | "ABS" | "ABS" | "ABS (blokkolásgátló)" | motorcycleFeatures |
+| gps_tracker | "GPS Tracker" | "GPS Tracker" | "GPS követő" | "GPS nyomkövető" | lcvFeatures, hgvFeatures |
+| alarm | "Alarm System" | "Alarm" | "Riasztórendszer" | "Riasztó" | motorcycleFeatures, lcvFeatures |
+| first_owner | "First Owner" | "First Owner" | "Első tulajdonos" | "Első tulajdonostól" | motorcycleFeatures |
+| service_book | "Service Book" | "Service Book" | "Szervizkönyvvel" | "Szervizkönyv" | motorcycleFeatures |
+| isofix | "ISOFIX" | "ISOFIX Child Seat Anchors" | "Isofix" | "Isofix gyerekülés rögzítés" | lcvFeatures |
+| tow_bar | "Tow Bar" | "Tow Bar" | "Vontatóhorog (vonóhorog)" | "Vontatóhorog" | lcvFeatures |
+| usb_charging | "USB Charging" | "USB Charging" | "USB töltőcsatlakozó" | "USB töltő" | hgvFeatures |
+| subwoofer | "Subwoofer" | "Subwoofer" | "Mélynyomó (Subwoofer)" | "Mélynyomó" | hgvFeatures |
+| rear_entertainment | "Rear Entertainment" | "Rear Entertainment System" | "Hátsó szórakoztató rendszer" | "Hátsó szórakoztató rendszer" | hgvFeatures |
+| traction_control | "Traction Control (TCS)" | "Traction Control" | "Kipörgésgátló (TCS)" | "Kipörgésgátló" | hgvFeatures |
+
+---
+
+## 4. Backend JSON Aszimmetria
+
+### en.json vs hu.json
+
+| Kulcs | en.json | hu.json | Státusz |
+|-------|---------|---------|---------|
+| AUTH.ERROR.UNAUTHORIZED | ✅ "Unauthorized access" | ❌ **HIÁNYZIK** | Pótlandó hu.json-ban |
+| COMMON.SAVE_SUCCESS | ❌ **HIÁNYZIK** | ✅ "Sikeres mentés!" | Pótlandó en.json-ban |
+| SENTINEL.APPROVAL.REQUIRED | ❌ **HIÁNYZIK** | ✅ "A kérelem jóváhagyása szükséges" | Pótlandó en.json-ban |
+
+A fennmaradó ~40 kulcs mindkét fájlban azonos szerkezetű.
+
+---
+
+## 5. Hiányos Fordítások (de, ro, cz, sk)
+
+A 4 részleges fájl mindegyike **csak 5 szekciót** fed le a 25-ből:
+
+| Szekció | de.ts | ro.ts | cz.ts | sk.ts |
+|---------|-------|-------|-------|-------|
+| menu | ✅ | ✅ | ✅ | ✅ |
+| header | ✅ | ✅ | ✅ | ✅ |
+| dashboard | ✅ | ✅ | ✅ | ✅ |
+| zen | ✅ | ✅ | ✅ | ✅ |
+| auth | ✅ | ✅ | ✅ | ✅ |
+| Többi 20 szekció | ❌ | ❌ | ❌ | ❌ |
+
+**Hiányzó:** common, subscription, landing, garage, vehicleDetail, finance, profile, kyc, verifyEmail, company, organization, address, servicebook, vehicle, serviceFinder, provider, categories, gamification, admin
+
+---
+
+## 6. Statisztikai Összesítés
+
+| Mérőszám | Érték |
+|----------|-------|
+| Összes i18n fájl | **8 db** (6 frontend + 2 backend) |
+| Frontend teljes kulcsok (en.ts) | **~900+** egyedi kulcs |
+| Frontend hiányos fájlok | **4 db** (de, ro, cz, sk) — csak 20% lefedettség |
+| Backend teljes kulcsok | **~55** db |
+| **Pontos duplikációk (összevonható)** | **25 csoport**, ~60 kulcs érintett |
+| **Közel-duplikációk (felülvizsgálandó)** | **7 csoport**, ~15 kulcs érintett |
+| **Jármű feature átfedések (pontos)** | **18 csoport**, ~50 kulcs érintett |
+| **Jármű feature átfedések (eltérő)** | **11 csoport**, ~25 kulcs érintett |
+| **Backend hiányzó kulcsok** | **3 db** |
+| **Összes optimalizálható kulcs** | **~150+** (a ~900-ból) ≈ **16-17%** |
+
+---
+
+## 7. Optimalizálási Javaslat
+
+### 7.1 Azonnal összevonható (25 csoport)
+
+Javasolt elnevezési konvenció: A leggyakrabban használt kulcsot tartsuk meg (pl. common), a többit alias-ként hivatkozzuk rá.
+
+### 7.2 Jármű feature-ök konszolidációja
+
+Javasolt struktúra: egy központi `vehicle.features` szekció, a motorcycleFeatures/lcvFeatures/hgvFeatures pedig hivatkozzon rá. Az eltérő magyar fordításokat egységesíteni kell.
+
+### 7.3 Backend hiányzó kulcsok pótlása
+
+- AUTH.ERROR.UNAUTHORIZED → hozzáadandó a hu.json-hoz
+- COMMON.SAVE_SUCCESS → hozzáadandó az en.json-hoz
+- SENTINEL.APPROVAL.REQUIRED → hozzáadandó az en.json-hoz
+
+### 7.4 Várakozó lista (nem sürgős)
+
+A 4 hiányos fordítást (de, ro, cz, sk) csak az optimalizálás után érdemes bővíteni.
+
+---
+
+## 8. Összefoglaló
+
+A frontend i18n rendszerben **~150 kulcs (16-17%)** duplikált vagy átfedő. Összevonásukkal:
+
+- **Karbantarthatóság javul:** egy helyen módosítandó fordítás
+- **Konzisztencia nő:** nem jelenhet meg kétféleképp ugyanaz
+- **Fájlméret csökken:** ~5-10% méretcsökkenés
+- **Backend hiba javul:** 3 hiányzó kulcs pótlása
+
+**A véglegesítéshez kérjük a felhasználó jóváhagyását.**