Improve onboarding

services/tenant/app/schemas/tenants.py

@@ -197,8 +197,102 @@ class TenantStatsResponse(BaseModel):
     last_training_date: Optional[datetime]
     subscription_plan: str
     subscription_status: str
-    
-    @field_validator('tenant_id', mode='before')
+
+
+# ============================================================================
+# ENTERPRISE CHILD TENANT SCHEMAS
+# ============================================================================
+
+class ChildTenantCreate(BaseModel):
+    """Schema for creating a child tenant in enterprise hierarchy"""
+    name: str = Field(..., min_length=2, max_length=200, description="Child tenant name (e.g., 'Madrid - Salamanca')")
+    city: str = Field(..., min_length=2, max_length=100, description="City where the outlet is located")
+    zone: Optional[str] = Field(None, max_length=100, description="Zone or neighborhood")
+    address: str = Field(..., min_length=10, max_length=500, description="Full address of the outlet")
+    postal_code: str = Field(..., pattern=r"^\d{5}$", description="5-digit postal code")
+    location_code: str = Field(..., min_length=1, max_length=10, description="Short location code (e.g., MAD, BCN)")
+
+    # Optional coordinates (can be geocoded from address if not provided)
+    latitude: Optional[float] = Field(None, ge=-90, le=90, description="Latitude coordinate")
+    longitude: Optional[float] = Field(None, ge=-180, le=180, description="Longitude coordinate")
+
+    # Optional contact info (inherits from parent if not provided)
+    phone: Optional[str] = Field(None, min_length=9, max_length=20, description="Contact phone")
+    email: Optional[str] = Field(None, description="Contact email")
+
+    @field_validator('location_code')
+    @classmethod
+    def validate_location_code(cls, v):
+        """Ensure location code is uppercase and alphanumeric"""
+        if not v.replace('-', '').replace('_', '').isalnum():
+            raise ValueError('Location code must be alphanumeric (with optional hyphens/underscores)')
+        return v.upper()
+
+    @field_validator('phone')
+    @classmethod
+    def validate_phone(cls, v):
+        """Validate Spanish phone number if provided"""
+        if v is None:
+            return v
+        phone = re.sub(r'[\s\-\(\)]', '', v)
+        patterns = [
+            r'^(\+34|0034|34)?[6789]\d{8}$',  # Mobile
+            r'^(\+34|0034|34)?9\d{8}$',       # Landline
+        ]
+        if not any(re.match(pattern, phone) for pattern in patterns):
+            raise ValueError('Invalid Spanish phone number')
+        return v
+
+
+class BulkChildTenantsCreate(BaseModel):
+    """Schema for bulk creating child tenants during onboarding"""
+    parent_tenant_id: str = Field(..., description="ID of the parent (central baker) tenant")
+    child_tenants: List[ChildTenantCreate] = Field(
+        ...,
+        min_length=1,
+        max_length=50,
+        description="List of child tenants to create (1-50)"
+    )
+
+    # Optional: Auto-configure distribution routes
+    auto_configure_distribution: bool = Field(
+        True,
+        description="Whether to automatically set up distribution routes between parent and children"
+    )
+
+    @field_validator('child_tenants')
+    @classmethod
+    def validate_unique_location_codes(cls, v):
+        """Ensure all location codes are unique within the batch"""
+        location_codes = [ct.location_code for ct in v]
+        if len(location_codes) != len(set(location_codes)):
+            raise ValueError('Location codes must be unique within the batch')
+        return v
+
+
+class ChildTenantResponse(TenantResponse):
+    """Response schema for child tenant - extends TenantResponse"""
+    location_code: Optional[str] = None
+    zone: Optional[str] = None
+    hierarchy_path: Optional[str] = None
+
+    class Config:
+        from_attributes = True
+
+
+class BulkChildTenantsResponse(BaseModel):
+    """Response schema for bulk child tenant creation"""
+    parent_tenant_id: str
+    created_count: int
+    failed_count: int
+    created_tenants: List[ChildTenantResponse]
+    failed_tenants: List[Dict[str, Any]] = Field(
+        default_factory=list,
+        description="List of failed tenants with error details"
+    )
+    distribution_configured: bool = False
+
+    @field_validator('parent_tenant_id', mode='before')
     @classmethod
     def convert_uuid_to_string(cls, v):
         """Convert UUID objects to strings for JSON serialization"""