frontend admin refakctorálás

2026-07-08 08:03:57 +00:00
parent 07b59032ce
commit 2e0abc62a7
455 changed files with 14428 additions and 21651 deletions
--- a/backend/app/schemas/provider.py
+++ b/backend/app/schemas/provider.py
@@ -35,8 +35,12 @@ class CategoryTreeNode(BaseModel):
    """
    id: int
    key: str
-    name_hu: Optional[str] = None
-    name_en: Optional[str] = None
+    # --- 🏗️ i18n JSONB Migration (Phase 3) ---
+    name_i18n: dict = Field(default_factory=dict, description="Lokalizált név (JSONB: {\"hu\": \"...\", \"en\": \"...\"})")
+    description_i18n: Optional[dict] = Field(None, description="Lokalizált leírás (JSONB)")
+    # --- [DEPRECATED] Old columns (Phase 3) ---
+    name_hu: Optional[str] = Field(None, description="[DEPRECATED] Use name_i18n instead")
+    name_en: Optional[str] = Field(None, description="[DEPRECATED] Use name_i18n instead")
    level: int = 0
    path: Optional[str] = None
    is_official: bool = True
@@ -53,8 +57,11 @@ class CategoryAutocompleteItem(BaseModel):
    """
    id: int
    key: str
-    name_hu: Optional[str] = None
-    name_en: Optional[str] = None
+    # --- 🏗️ i18n JSONB Migration (Phase 3) ---
+    name_i18n: dict = Field(default_factory=dict, description="Lokalizált név (JSONB: {\"hu\": \"...\", \"en\": \"...\"})")
+    # --- [DEPRECATED] Old columns (Phase 3) ---
+    name_hu: Optional[str] = Field(None, description="[DEPRECATED] Use name_i18n instead")
+    name_en: Optional[str] = Field(None, description="[DEPRECATED] Use name_i18n instead")
    level: int = 0
    path: Optional[str] = None
    parent_id: Optional[int] = None
@@ -73,8 +80,11 @@ class ExpertiseCategoryOut(BaseModel):
    """
    id: int
    key: str
-    name_hu: Optional[str] = None
-    name_en: Optional[str] = None
+    # --- 🏗️ i18n JSONB Migration (Phase 3) ---
+    name_i18n: dict = Field(default_factory=dict, description="Lokalizált név (JSONB: {\"hu\": \"...\", \"en\": \"...\"})")
+    # --- [DEPRECATED] Old columns (Phase 3) ---
+    name_hu: Optional[str] = Field(None, description="[DEPRECATED] Use name_i18n instead")
+    name_en: Optional[str] = Field(None, description="[DEPRECATED] Use name_i18n instead")
    category: Optional[str] = None
    level: int = 0
    parent_id: Optional[int] = None
@@ -91,8 +101,11 @@ class CategoryInfo(BaseModel):
    szolgáltatásokat a kártyákon.
    """
    id: int
-    name_hu: Optional[str] = None
-    name_en: Optional[str] = None
+    # --- 🏗️ i18n JSONB Migration (Phase 3) ---
+    name_i18n: dict = Field(default_factory=dict, description="Lokalizált név (JSONB: {\"hu\": \"...\", \"en\": \"...\"})")
+    # --- [DEPRECATED] Old columns (Phase 3) ---
+    name_hu: Optional[str] = Field(None, description="[DEPRECATED] Use name_i18n instead")
+    name_en: Optional[str] = Field(None, description="[DEPRECATED] Use name_i18n instead")
    level: int = 0
    key: str

@@ -109,6 +122,10 @@ class ProviderSearchResult(BaseModel):
    - A flat mezők (address_zip, address_street_name, stb.) MEGMARADNAK
      a backward compatibility miatt.
    
+    P0 PHASE 2 ADDRESS UNIFICATION (2026-07-07):
+    - address_detail: Optional[AddressOut] — first-class citizen.
+    - A flat mezők [DEPRECATED] — Phase 3-ban törlendő.
+    
    FEATURE (2026-06-17): categories mező.
    - A szolgáltatóhoz tartozó kategóriák (ExpertiseTag) listája.
    - Tartalmazza az ID-t, nevet és szintet a frontend chip megjelenítéshez.
@@ -118,12 +135,12 @@ class ProviderSearchResult(BaseModel):
    category: Optional[str] = None
    specialization: List[str] = Field(default_factory=list)
    categories: List[CategoryInfo] = Field(default_factory=list)
-    city: Optional[str] = None
-    address: Optional[str] = None
-    address_zip: Optional[str] = None
-    address_street_name: Optional[str] = None
-    address_street_type: Optional[str] = None
-    address_house_number: Optional[str] = None
+    city: Optional[str] = Field(None, description="[DEPRECATED] Use address_detail.city instead")
+    address: Optional[str] = Field(None, description="[DEPRECATED] Use address_detail.full_address_text instead")
+    address_zip: Optional[str] = Field(None, description="[DEPRECATED] Use address_detail.zip instead")
+    address_street_name: Optional[str] = Field(None, description="[DEPRECATED] Use address_detail.street_name instead")
+    address_street_type: Optional[str] = Field(None, description="[DEPRECATED] Use address_detail.street_type instead")
+    address_house_number: Optional[str] = Field(None, description="[DEPRECATED] Use address_detail.house_number instead")
    plus_code: Optional[str] = None
    contact_phone: Optional[str] = None
    contact_email: Optional[str] = None
@@ -134,7 +151,7 @@ class ProviderSearchResult(BaseModel):
    rating: Optional[float] = None
    supported_vehicle_classes: Optional[List[str]] = None
    specializations: Optional[dict] = None
-    # P3: Egységes cím objektum (a flat mezők mellett)
+    # P0 PHASE 2: Egységes cím objektum (first-class citizen)
    address_detail: Optional[AddressOut] = None

    model_config = ConfigDict(from_attributes=True)
@@ -159,6 +176,10 @@ class ProviderQuickAddIn(BaseModel):
    - A flat mezők (address_zip, address_street_name, stb.) MEGMARADNAK
      a backward compatibility miatt.

+    P0 PHASE 2 ADDRESS UNIFICATION (2026-07-07):
+    - address_detail: Optional[AddressIn] — first-class citizen.
+    - A flat mezők [DEPRECATED] — Phase 3-ban törlendő.
+
    P0 CRITICAL BUGFIX (2026-06-17): category_id most már opcionális.
    - A 4-level kategória rendszer bevezetésével a frontend a category_ids
      tömböt használja a kategóriák kiválasztására, nem a régi category_id-t.
@@ -170,11 +191,11 @@ class ProviderQuickAddIn(BaseModel):
    category_id: Optional[int] = Field(None, ge=1, description="Elsődleges kategória ID (opcionális, backward compatibility)")
    category_ids: Optional[List[int]] = Field(None, description="Kiválasztott kategória ID-k (Szint 0-3 checkboxokból)")
    new_tags: Optional[List[str]] = Field(None, description="User által gépelt új címkenevek (is_official=False, level=3)")
-    city: Optional[str] = Field(None, max_length=100, description="Város")
-    address_zip: Optional[str] = Field(None, max_length=20, description="Irányítószám")
-    address_street_name: Optional[str] = Field(None, max_length=150, description="Utca neve (pl. Egressy)")
-    address_street_type: Optional[str] = Field(None, max_length=50, description="Közterület jellege (pl. utca, út, tér)")
-    address_house_number: Optional[str] = Field(None, max_length=20, description="Házszám (pl. 4/b)")
+    city: Optional[str] = Field(None, max_length=100, description="[DEPRECATED] Use address_detail.city instead")
+    address_zip: Optional[str] = Field(None, max_length=20, description="[DEPRECATED] Use address_detail.zip instead")
+    address_street_name: Optional[str] = Field(None, max_length=150, description="[DEPRECATED] Use address_detail.street_name instead")
+    address_street_type: Optional[str] = Field(None, max_length=50, description="[DEPRECATED] Use address_detail.street_type instead")
+    address_house_number: Optional[str] = Field(None, max_length=20, description="[DEPRECATED] Use address_detail.house_number instead")
    plus_code: Optional[str] = Field(None, max_length=20, description="Google Plus Code (pl. 8FVC9X8V+XV)")
    contact_phone: Optional[str] = Field(None, max_length=50, description="Telefonszám")
    contact_email: Optional[str] = Field(None, max_length=255, description="Email cím")
@@ -186,7 +207,7 @@ class ProviderQuickAddIn(BaseModel):
    specializations: Optional[dict] = Field(
        None, description="Specializációk (pl. {'brands': ['Volvo'], 'propulsion': ['EV']})"
    )
-    # P3: Egységes cím objektum (a flat mezők mellett)
+    # P0 PHASE 2: Egységes cím objektum (first-class citizen)
    address_detail: Optional[AddressIn] = None


@@ -211,16 +232,20 @@ class ProviderUpdateIn(BaseModel):
    - A flat mezők (address_zip, address_street_name, stb.) MEGMARADNAK
      a backward compatibility miatt.
    
+    P0 PHASE 2 ADDRESS UNIFICATION (2026-07-07):
+    - address_detail: Optional[AddressIn] — first-class citizen.
+    - A flat mezők [DEPRECATED] — Phase 3-ban törlendő.
+    
    4-Level Category (2026-06-17):
    - category_ids: A kiválasztott kategória ID-k listája (Szint 0-3)
    - new_tags: A user által gépelt, új (még nem létező) címkék listája
    """
    name: str = Field(..., min_length=2, max_length=200, description="Szolgáltató neve")
-    city: Optional[str] = Field(None, max_length=100, description="Város")
-    address_zip: Optional[str] = Field(None, max_length=20, description="Irányítószám")
-    address_street_name: Optional[str] = Field(None, max_length=150, description="Utca neve (pl. Egressy)")
-    address_street_type: Optional[str] = Field(None, max_length=50, description="Közterület jellege (pl. utca, út, tér)")
-    address_house_number: Optional[str] = Field(None, max_length=20, description="Házszám (pl. 4/b)")
+    city: Optional[str] = Field(None, max_length=100, description="[DEPRECATED] Use address_detail.city instead")
+    address_zip: Optional[str] = Field(None, max_length=20, description="[DEPRECATED] Use address_detail.zip instead")
+    address_street_name: Optional[str] = Field(None, max_length=150, description="[DEPRECATED] Use address_detail.street_name instead")
+    address_street_type: Optional[str] = Field(None, max_length=50, description="[DEPRECATED] Use address_detail.street_type instead")
+    address_house_number: Optional[str] = Field(None, max_length=20, description="[DEPRECATED] Use address_detail.house_number instead")
    plus_code: Optional[str] = Field(None, max_length=20, description="Google Plus Code (pl. 8FVC9X8V+XV)")
    contact_phone: Optional[str] = Field(None, max_length=50, description="Telefonszám")
    contact_email: Optional[str] = Field(None, max_length=255, description="Email cím")
@@ -238,7 +263,7 @@ class ProviderUpdateIn(BaseModel):
    specializations: Optional[dict] = Field(
        None, description="Specializációk (pl. {'brands': ['Volvo'], 'propulsion': ['EV']})"
    )
-    # P3: Egységes cím objektum (a flat mezők mellett)
+    # P0 PHASE 2: Egységes cím objektum (first-class citizen)
    address_detail: Optional[AddressIn] = None