+
+
+ Send test email to:
+
+
+
+ A test email will be sent using sample data for template variables.
+
+
+
+ Cancel
+
+
+ Send Test
+ Sending...
+
+
+
"
+ )
+
+ @classmethod
+ def get_override(
+ cls,
+ db: Session,
+ vendor_id: int,
+ template_code: str,
+ language: str,
+ ) -> "VendorEmailTemplate | None":
+ """
+ Get vendor's template override if it exists.
+
+ Args:
+ db: Database session
+ vendor_id: Vendor ID
+ template_code: Template code to look up
+ language: Language code (en, fr, de, lb)
+
+ Returns:
+ VendorEmailTemplate if override exists, None otherwise
+ """
+ return (
+ db.query(cls)
+ .filter(
+ cls.vendor_id == vendor_id,
+ cls.template_code == template_code,
+ cls.language == language,
+ cls.is_active == True, # noqa: E712
+ )
+ .first()
+ )
+
+ @classmethod
+ def get_all_overrides_for_vendor(
+ cls,
+ db: Session,
+ vendor_id: int,
+ ) -> list["VendorEmailTemplate"]:
+ """
+ Get all template overrides for a vendor.
+
+ Args:
+ db: Database session
+ vendor_id: Vendor ID
+
+ Returns:
+ List of VendorEmailTemplate objects
+ """
+ return (
+ db.query(cls)
+ .filter(
+ cls.vendor_id == vendor_id,
+ cls.is_active == True, # noqa: E712
+ )
+ .order_by(cls.template_code, cls.language)
+ .all()
+ )
+
+ @classmethod
+ def create_or_update(
+ cls,
+ db: Session,
+ vendor_id: int,
+ template_code: str,
+ language: str,
+ subject: str,
+ body_html: str,
+ body_text: str | None = None,
+ name: str | None = None,
+ ) -> "VendorEmailTemplate":
+ """
+ Create or update a vendor email template override.
+
+ Args:
+ db: Database session
+ vendor_id: Vendor ID
+ template_code: Template code
+ language: Language code
+ subject: Email subject
+ body_html: HTML body content
+ body_text: Optional plain text body
+ name: Optional custom name
+
+ Returns:
+ Created or updated VendorEmailTemplate
+ """
+ existing = cls.get_override(db, vendor_id, template_code, language)
+
+ if existing:
+ existing.subject = subject
+ existing.body_html = body_html
+ existing.body_text = body_text
+ existing.name = name
+ existing.updated_at = datetime.utcnow()
+ return existing
+
+ new_template = cls(
+ vendor_id=vendor_id,
+ template_code=template_code,
+ language=language,
+ subject=subject,
+ body_html=body_html,
+ body_text=body_text,
+ name=name,
+ )
+ db.add(new_template)
+ return new_template
+
+ @classmethod
+ def delete_override(
+ cls,
+ db: Session,
+ vendor_id: int,
+ template_code: str,
+ language: str,
+ ) -> bool:
+ """
+ Delete a vendor's template override (revert to platform default).
+
+ Args:
+ db: Database session
+ vendor_id: Vendor ID
+ template_code: Template code
+ language: Language code
+
+ Returns:
+ True if deleted, False if not found
+ """
+ deleted = (
+ db.query(cls)
+ .filter(
+ cls.vendor_id == vendor_id,
+ cls.template_code == template_code,
+ cls.language == language,
+ )
+ .delete()
+ )
+ return deleted > 0
diff --git a/models/schema/__init__.py b/models/schema/__init__.py
index 96e127a3..cdb71410 100644
--- a/models/schema/__init__.py
+++ b/models/schema/__init__.py
@@ -5,6 +5,7 @@
from . import (
auth,
base,
+ email,
inventory,
invoice,
marketplace_import_job,
@@ -21,6 +22,7 @@ from .base import * # Base Pydantic models
__all__ = [
"base",
"auth",
+ "email",
"invoice",
"marketplace_product",
"message",
diff --git a/models/schema/email.py b/models/schema/email.py
new file mode 100644
index 00000000..edfd248f
--- /dev/null
+++ b/models/schema/email.py
@@ -0,0 +1,247 @@
+# models/schema/email.py
+"""
+Email template Pydantic schemas for API responses and requests.
+
+Provides schemas for:
+- EmailTemplate: Platform email templates
+- VendorEmailTemplate: Vendor-specific template overrides
+"""
+
+from datetime import datetime
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class EmailTemplateBase(BaseModel):
+ """Base schema for email templates."""
+
+ code: str = Field(..., description="Template code (e.g., 'password_reset')")
+ language: str = Field(default="en", description="Language code (en, fr, de, lb)")
+ name: str = Field(..., description="Human-readable template name")
+ description: str | None = Field(None, description="Template description")
+ category: str = Field(..., description="Template category (auth, orders, billing, etc.)")
+ subject: str = Field(..., description="Email subject (supports Jinja2 variables)")
+ body_html: str = Field(..., description="HTML email body")
+ body_text: str | None = Field(None, description="Plain text fallback")
+ variables: list[str] = Field(default_factory=list, description="Available variables")
+
+
+class EmailTemplateCreate(EmailTemplateBase):
+ """Schema for creating an email template."""
+
+ required_variables: list[str] = Field(
+ default_factory=list, description="Required variables"
+ )
+ is_platform_only: bool = Field(
+ default=False, description="Cannot be overridden by vendors"
+ )
+
+
+class EmailTemplateUpdate(BaseModel):
+ """Schema for updating an email template."""
+
+ name: str | None = Field(None, description="Human-readable template name")
+ description: str | None = Field(None, description="Template description")
+ subject: str | None = Field(None, description="Email subject")
+ body_html: str | None = Field(None, description="HTML email body")
+ body_text: str | None = Field(None, description="Plain text fallback")
+ variables: list[str] | None = Field(None, description="Available variables")
+ required_variables: list[str] | None = Field(None, description="Required variables")
+ is_active: bool | None = Field(None, description="Template active status")
+
+
+class EmailTemplateResponse(BaseModel):
+ """Schema for email template API response."""
+
+ model_config = ConfigDict(from_attributes=True)
+
+ id: int
+ code: str
+ language: str
+ name: str
+ description: str | None
+ category: str
+ subject: str
+ body_html: str
+ body_text: str | None
+ variables: list[str] = Field(default_factory=list)
+ required_variables: list[str] = Field(default_factory=list)
+ is_active: bool
+ is_platform_only: bool
+ created_at: datetime
+ updated_at: datetime
+
+ @classmethod
+ def from_db(cls, template) -> "EmailTemplateResponse":
+ """Create response from database model."""
+ return cls(
+ id=template.id,
+ code=template.code,
+ language=template.language,
+ name=template.name,
+ description=template.description,
+ category=template.category,
+ subject=template.subject,
+ body_html=template.body_html,
+ body_text=template.body_text,
+ variables=template.variables_list,
+ required_variables=template.required_variables_list,
+ is_active=template.is_active,
+ is_platform_only=template.is_platform_only,
+ created_at=template.created_at,
+ updated_at=template.updated_at,
+ )
+
+
+class EmailTemplateSummary(BaseModel):
+ """Summary schema for template list views."""
+
+ model_config = ConfigDict(from_attributes=True)
+
+ id: int
+ code: str
+ name: str
+ category: str
+ languages: list[str] = Field(default_factory=list)
+ is_platform_only: bool
+ is_active: bool
+
+ @classmethod
+ def from_db_list(cls, templates: list) -> list["EmailTemplateSummary"]:
+ """
+ Create summaries from database models, grouping by code.
+
+ Args:
+ templates: List of EmailTemplate models
+
+ Returns:
+ List of EmailTemplateSummary grouped by template code
+ """
+ # Group templates by code
+ by_code: dict[str, list] = {}
+ for t in templates:
+ if t.code not in by_code:
+ by_code[t.code] = []
+ by_code[t.code].append(t)
+
+ summaries = []
+ for code, group in by_code.items():
+ first = group[0]
+ summaries.append(
+ cls(
+ id=first.id,
+ code=code,
+ name=first.name,
+ category=first.category,
+ languages=[t.language for t in group],
+ is_platform_only=first.is_platform_only,
+ is_active=first.is_active,
+ )
+ )
+
+ return summaries
+
+
+# Vendor Email Template Schemas
+
+
+class VendorEmailTemplateCreate(BaseModel):
+ """Schema for creating a vendor email template override."""
+
+ template_code: str = Field(..., description="Template code to override")
+ language: str = Field(default="en", description="Language code")
+ name: str | None = Field(None, description="Custom name (uses platform default if None)")
+ subject: str = Field(..., description="Custom email subject")
+ body_html: str = Field(..., description="Custom HTML body")
+ body_text: str | None = Field(None, description="Custom plain text body")
+
+
+class VendorEmailTemplateUpdate(BaseModel):
+ """Schema for updating a vendor email template override."""
+
+ name: str | None = Field(None, description="Custom name")
+ subject: str | None = Field(None, description="Custom email subject")
+ body_html: str | None = Field(None, description="Custom HTML body")
+ body_text: str | None = Field(None, description="Custom plain text body")
+ is_active: bool | None = Field(None, description="Override active status")
+
+
+class VendorEmailTemplateResponse(BaseModel):
+ """Schema for vendor email template override API response."""
+
+ model_config = ConfigDict(from_attributes=True)
+
+ id: int
+ vendor_id: int
+ template_code: str
+ language: str
+ name: str | None
+ subject: str
+ body_html: str
+ body_text: str | None
+ is_active: bool
+ created_at: datetime
+ updated_at: datetime
+
+
+class EmailTemplateWithOverrideStatus(BaseModel):
+ """
+ Schema showing template with vendor override status.
+
+ Used in vendor UI to show which templates have been customized.
+ """
+
+ model_config = ConfigDict(from_attributes=True)
+
+ code: str
+ name: str
+ category: str
+ languages: list[str]
+ is_platform_only: bool
+ has_override: bool = Field(
+ default=False, description="Whether vendor has customized this template"
+ )
+ override_languages: list[str] = Field(
+ default_factory=list,
+ description="Languages with vendor overrides",
+ )
+
+
+# Email Preview/Test Schemas
+
+
+class EmailPreviewRequest(BaseModel):
+ """Schema for requesting an email preview."""
+
+ template_code: str = Field(..., description="Template code")
+ language: str = Field(default="en", description="Language code")
+ variables: dict[str, str] = Field(
+ default_factory=dict, description="Variables to inject"
+ )
+
+
+class EmailPreviewResponse(BaseModel):
+ """Schema for email preview response."""
+
+ subject: str
+ body_html: str
+ body_text: str | None
+
+
+class EmailTestRequest(BaseModel):
+ """Schema for sending a test email."""
+
+ template_code: str = Field(..., description="Template code")
+ language: str = Field(default="en", description="Language code")
+ to_email: str = Field(..., description="Recipient email address")
+ variables: dict[str, str] = Field(
+ default_factory=dict, description="Variables to inject"
+ )
+
+
+class EmailTestResponse(BaseModel):
+ """Schema for test email response."""
+
+ success: bool
+ message: str
+ email_log_id: int | None = None
diff --git a/scripts/seed_email_templates.py b/scripts/seed_email_templates.py
index 3871103d..9031af7f 100644
--- a/scripts/seed_email_templates.py
+++ b/scripts/seed_email_templates.py
@@ -896,6 +896,363 @@ Dëse Link leeft an {{ expiry_hours }} Stonn(en) of. Wann Dir dës Passwuertzrec
Mat beschte Gréiss,
D'Team
+""",
+ },
+ # -------------------------------------------------------------------------
+ # PLATFORM-ONLY BILLING TEMPLATES
+ # -------------------------------------------------------------------------
+ {
+ "code": "subscription_welcome",
+ "language": "en",
+ "name": "Subscription Welcome",
+ "description": "Sent to vendors when they subscribe to a paid plan",
+ "category": EmailCategory.BILLING.value,
+ "is_platform_only": True,
+ "required_variables": json.dumps(["vendor_name", "tier_name", "billing_cycle", "amount"]),
+ "variables": json.dumps([
+ "vendor_name", "tier_name", "billing_cycle", "amount",
+ "next_billing_date", "dashboard_url"
+ ]),
+ "subject": "Welcome to {{ tier_name }} - Subscription Confirmed",
+ "body_html": """
+
+
+
+
Subscription Confirmed!
+
+
+
+
Hi {{ vendor_name }},
+
+
Thank you for subscribing to Wizamart! Your {{ tier_name }} subscription is now active.
+
+
+
Subscription Details
+
Plan: {{ tier_name }}
+
Billing Cycle: {{ billing_cycle }}
+
Amount: {{ amount }}
+
Next Billing Date: {{ next_billing_date }}
+
+
+
+
+
+ If you have any questions about your subscription, please contact our support team.
+
+
+
Best regards,The Wizamart Team
+
+
© 2024 Wizamart. All rights reserved.
+
+
Payment Failed
+
+
+
+
Hi {{ vendor_name }},
+
+
We were unable to process your payment of {{ amount }} for your {{ tier_name }} subscription.
+
+
+
What happens next?
+
We'll automatically retry the payment on {{ retry_date }}.
+
To avoid any service interruption, please update your payment method.
+
+
+
+
+
+ If you need assistance, please contact us at {{ support_email }}.
+
+
+
Best regards,The Wizamart Team
+
+
Subscription Cancelled
+
+
+
+
Hi {{ vendor_name }},
+
+
Your {{ tier_name }} subscription has been cancelled as requested.
+
+
+
What happens now?
+
You'll continue to have access to your {{ tier_name }} features until {{ end_date }} .
+
After that date, your account will be downgraded to the Free tier.
+
+
+
Changed your mind? You can reactivate your subscription at any time:
+
+
+
+
+ We're sorry to see you go. If there's anything we could have done better, please let us know.
+
+
+
Best regards,The Wizamart Team
+
+
Your Trial is Ending Soon
+
+
+
+
Hi {{ vendor_name }},
+
+
Your {{ tier_name }} trial ends in {{ days_remaining }} days ({{ trial_end_date }}).
+
+
+
Don't lose these features:
+
{{ features_list }}
+
+
+
Subscribe now to continue using all {{ tier_name }} features without interruption:
+
+
+
+
+ Have questions? Reply to this email and we'll help you choose the right plan.
+
+
+
Best regards,The Wizamart Team
+
+
You've Been Invited!
+
+
+
+
Hi {{ invitee_name }},
+
+
{{ inviter_name }} has invited you to join {{ vendor_name }} as a team member on Wizamart.
+
+
+
Invitation Details
+
Vendor: {{ vendor_name }}
+
Role: {{ role }}
+
Invited by: {{ inviter_name }}
+
+
+
+
+
+ This invitation will expire in {{ expires_in_days }} days.
+
+
+
+ If you weren't expecting this invitation, you can safely ignore this email.
+
+
+
Best regards,The Wizamart Team
+