refaktor címtár

backend/app/schemas/provider.py

@@ -6,6 +6,12 @@ P1 CRITICAL ALIGN (2026-06-17): Atomizált címmezők bevezetése.
 - street -> address_street_name, address_street_type, address_house_number
 - A ProviderSearchResult is tartalmazza az atomizált címmezőket.
 
+P3 UNIFIED ADDRESS REFACTOR (2026-07-01): Egységes AddressIn/AddressOut.
+- ProviderSearchResult: address_detail: Optional[AddressOut] a meglévő flat mezők mellett
+- ProviderQuickAddIn: address_detail: Optional[AddressIn] a meglévő flat mezők mellett
+- ProviderUpdateIn: address_detail: Optional[AddressIn] a meglévő flat mezők mellett
+- A flat mezők (address_zip, address_street_name, stb.) MEGMARADNAK a backward compatibility miatt
+
 4-Level Category Architecture (2026-06-17):
 ===========================================
 - CategoryTreeNode: Hierarchikus fa struktúra a frontend checkboxaihoz
@@ -15,6 +21,7 @@ P1 CRITICAL ALIGN (2026-06-17): Atomizált címmezők bevezetése.
 
 from pydantic import BaseModel, Field, ConfigDict
 from typing import Optional, List
+from app.schemas.address import AddressIn, AddressOut
 
 
 # ──────────────────────────────────────────────
@@ -97,6 +104,11 @@ class ProviderSearchResult(BaseModel):
     - address_street_name, address_street_type, address_house_number
     - A frontend ezeket intelligensen fűzi össze megjelenítéskor.
     
+    P3 UNIFIED ADDRESS REFACTOR (2026-07-01): address_detail mező.
+    - address_detail: Optional[AddressOut] — egységes cím objektum.
+    - A flat mezők (address_zip, address_street_name, stb.) MEGMARADNAK
+      a backward compatibility miatt.
+    
     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.
@@ -122,6 +134,8 @@ 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)
+    address_detail: Optional[AddressOut] = None
 
     model_config = ConfigDict(from_attributes=True)
 
@@ -140,6 +154,11 @@ class ProviderQuickAddIn(BaseModel):
     P1 CRITICAL ALIGN (2026-06-17): Atomizált címmezők.
     - street ELTÁVOLÍTVA, helyette address_street_name, address_street_type, address_house_number
 
+    P3 UNIFIED ADDRESS REFACTOR (2026-07-01): address_detail mező.
+    - address_detail: Optional[AddressIn] — egységes cím objektum.
+    - A flat mezők (address_zip, address_street_name, stb.) MEGMARADNAK
+      a backward compatibility miatt.
+
     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.
@@ -167,6 +186,8 @@ 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)
+    address_detail: Optional[AddressIn] = None
 
 
 class ProviderQuickAddResponse(BaseModel):
@@ -185,6 +206,11 @@ class ProviderUpdateIn(BaseModel):
     - street ELTÁVOLÍTVA, helyette address_street_name, address_street_type, address_house_number
     - Tartalmazza a contact_phone, contact_email, website és tags mezőket is.
     
+    P3 UNIFIED ADDRESS REFACTOR (2026-07-01): address_detail mező.
+    - address_detail: Optional[AddressIn] — egységes cím objektum.
+    - A flat mezők (address_zip, address_street_name, stb.) MEGMARADNAK
+      a backward compatibility miatt.
+    
     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
@@ -212,6 +238,8 @@ 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)
+    address_detail: Optional[AddressIn] = None
 
 
 class ProviderUpdateResponse(BaseModel):