feat: add multi-language (i18n) support for vendor dashboard and storefront

- Add database fields for language preferences:
  - Vendor: dashboard_language, storefront_language, storefront_languages
  - User: preferred_language
  - Customer: preferred_language

- Add language middleware for request-level language detection:
  - Cookie-based persistence
  - Browser Accept-Language fallback
  - Vendor storefront language constraints

- Add language API endpoints (/api/v1/language/*):
  - POST /set - Set language preference
  - GET /current - Get current language info
  - GET /list - List available languages
  - DELETE /clear - Clear preference

- Add i18n utilities (app/utils/i18n.py):
  - JSON-based translation loading
  - Jinja2 template integration
  - Language resolution helpers

- Add reusable language selector macros for templates
- Add languageSelector() Alpine.js component
- Add translation files (en, fr, de, lb) in static/locales/
- Add architecture rules documentation for language implementation
- Update marketplace-product-detail.js to use native language names

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

models/schema/auth.py

@@ -25,6 +25,7 @@ class UserResponse(BaseModel):
     username: str
     role: str
     is_active: bool
+    preferred_language: str | None = None
     last_login: datetime | None = None
     created_at: datetime
     updated_at: datetime
@@ -58,6 +59,9 @@ class UserUpdate(BaseModel):
     role: str | None = Field(None, pattern="^(admin|vendor)$")
     is_active: bool | None = None
     is_email_verified: bool | None = None
+    preferred_language: str | None = Field(
+        None, description="Preferred language (en, fr, de, lb)"
+    )
 
     @field_validator("username")
     @classmethod
@@ -78,6 +82,9 @@ class UserCreate(BaseModel):
     first_name: str | None = Field(None, max_length=100)
     last_name: str | None = Field(None, max_length=100)
     role: str = Field(default="vendor", pattern="^(admin|vendor)$")
+    preferred_language: str | None = Field(
+        None, description="Preferred language (en, fr, de, lb)"
+    )
 
     @field_validator("username")
     @classmethod

models/schema/customer.py

@@ -24,6 +24,9 @@ class CustomerRegister(BaseModel):
     last_name: str = Field(..., min_length=1, max_length=100)
     phone: str | None = Field(None, max_length=50)
     marketing_consent: bool = Field(default=False)
+    preferred_language: str | None = Field(
+        None, description="Preferred language (en, fr, de, lb)"
+    )
 
     @field_validator("email")
     @classmethod
@@ -52,6 +55,9 @@ class CustomerUpdate(BaseModel):
     last_name: str | None = Field(None, min_length=1, max_length=100)
     phone: str | None = Field(None, max_length=50)
     marketing_consent: bool | None = None
+    preferred_language: str | None = Field(
+        None, description="Preferred language (en, fr, de, lb)"
+    )
 
     @field_validator("email")
     @classmethod
@@ -76,6 +82,7 @@ class CustomerResponse(BaseModel):
     phone: str | None
     customer_number: str
     marketing_consent: bool
+    preferred_language: str | None
     last_order_date: datetime | None
     total_orders: int
     total_spent: Decimal
@@ -169,7 +176,9 @@ class CustomerPreferencesUpdate(BaseModel):
     """Schema for updating customer preferences."""
 
     marketing_consent: bool | None = None
-    language: str | None = Field(None, max_length=10)
+    preferred_language: str | None = Field(
+        None, description="Preferred language (en, fr, de, lb)"
+    )
     currency: str | None = Field(None, max_length=3)
     notification_preferences: dict[str, bool] | None = None
 
@@ -206,6 +215,7 @@ class CustomerDetailResponse(BaseModel):
     phone: str | None = None
     customer_number: str | None = None
     marketing_consent: bool | None = None
+    preferred_language: str | None = None
     last_order_date: datetime | None = None
     total_orders: int | None = None
     total_spent: Decimal | None = None

models/schema/vendor.py

@@ -59,6 +59,20 @@ class VendorCreate(BaseModel):
     business_address: str | None = Field(None, description="Override company business address")
     tax_number: str | None = Field(None, description="Override company tax number")
 
+    # Language Settings
+    default_language: str | None = Field(
+        "fr", description="Default language for content (en, fr, de, lb)"
+    )
+    dashboard_language: str | None = Field(
+        "fr", description="Vendor dashboard UI language"
+    )
+    storefront_language: str | None = Field(
+        "fr", description="Default storefront language for customers"
+    )
+    storefront_languages: list[str] | None = Field(
+        default=["fr", "de", "en"], description="Enabled languages for storefront"
+    )
+
     @field_validator("subdomain")
     @classmethod
     def validate_subdomain(cls, v):
@@ -110,6 +124,20 @@ class VendorUpdate(BaseModel):
         None, description="If true, reset all contact fields to inherit from company"
     )
 
+    # Language Settings
+    default_language: str | None = Field(
+        None, description="Default language for content (en, fr, de, lb)"
+    )
+    dashboard_language: str | None = Field(
+        None, description="Vendor dashboard UI language"
+    )
+    storefront_language: str | None = Field(
+        None, description="Default storefront language for customers"
+    )
+    storefront_languages: list[str] | None = Field(
+        None, description="Enabled languages for storefront"
+    )
+
     @field_validator("subdomain")
     @classmethod
     def subdomain_lowercase(cls, v):
@@ -148,6 +176,12 @@ class VendorResponse(BaseModel):
     is_active: bool
     is_verified: bool
 
+    # Language Settings (optional with defaults for backward compatibility)
+    default_language: str = "fr"
+    dashboard_language: str = "fr"
+    storefront_language: str = "fr"
+    storefront_languages: list[str] = ["fr", "de", "en"]
+
     # Timestamps
     created_at: datetime
     updated_at: datetime