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/database/customer.py

@@ -37,6 +37,10 @@ class Customer(Base, TimestampMixin):
     total_spent = Column(Numeric(10, 2), default=0)
     is_active = Column(Boolean, default=True, nullable=False)
 
+    # Language preference (NULL = use vendor storefront_language default)
+    # Supported: en, fr, de, lb
+    preferred_language = Column(String(5), nullable=True)
+
     # Relationships
     vendor = relationship("Vendor", back_populates="customers")
     addresses = relationship("CustomerAddress", back_populates="customer")

models/database/user.py

@@ -46,6 +46,10 @@ class User(Base, TimestampMixin):
     is_email_verified = Column(Boolean, default=False, nullable=False)
     last_login = Column(DateTime, nullable=True)
 
+    # Language preference (NULL = use context default: vendor dashboard_language or system default)
+    # Supported: en, fr, de, lb
+    preferred_language = Column(String(5), nullable=True)
+
     # Relationships
     marketplace_import_jobs = relationship(
         "MarketplaceImportJob", back_populates="user"

models/database/vendor.py

@@ -74,6 +74,23 @@ class Vendor(Base, TimestampMixin):
     business_address = Column(Text, nullable=True)  # Override company business address
     tax_number = Column(String(100), nullable=True)  # Override company tax number
 
+    # ========================================================================
+    # Language Settings
+    # ========================================================================
+    # Supported languages: en, fr, de, lb (Luxembourgish)
+    default_language = Column(
+        String(5), nullable=False, default="fr"
+    )  # Default language for vendor content (products, emails, etc.)
+    dashboard_language = Column(
+        String(5), nullable=False, default="fr"
+    )  # Language for vendor team dashboard UI
+    storefront_language = Column(
+        String(5), nullable=False, default="fr"
+    )  # Default language for customer-facing storefront
+    storefront_languages = Column(
+        JSON, nullable=False, default=["fr", "de", "en"]
+    )  # Array of enabled languages for storefront language selector
+
     # ========================================================================
     # Relationships
     # ========================================================================

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