Notifications System

Architecture

Order state change
    ↓
Event dispatcher
    ├── Email channel (Postmark/SMTP)
    ├── Webhook channel (HTTP POST)
    ├── SMS channel (Twilio)
    └── Analytics channel

Notification service

pub struct NotificationService {
    email_channel: EmailChannel,
    sms_channel: SmsChannel,
    webhook_channel: WebhookChannel,
    db: Database,
}

Email

Postmark

[notifications.email]
postmark_token = "your-server-token"
from_email = "shop@example.com"
from_name = "Your Store"

SMTP

[notifications.email]
smtp_host = "smtp.example.com"
smtp_port = 465
smtp_user = "user@example.com"
smtp_pass = "password"
smtp_tls = true

Templates

HTML templates with brand styling:

• order_confirmation.html — order confirmed
• order_shipped.html — fulfillment created
• password_reset.html — password reset link
• welcome.html — new account

Templates use {{ variable }} substitution.

Webhooks

Events are dispatched to registered webhook URLs:

{
  "event": "order.paid",
  "timestamp": "2024-01-01T12:00:00Z",
  "data": { "order_id": "uuid", "total": 150.00 }
}

Signed with HMAC-SHA256. Failed webhooks retried with exponential backoff.

Event types

Event	Trigger
order.created	Order placed
order.paid	Payment confirmed
order.shipped	Fulfillment created
order.completed	Order marked complete
order.cancelled	Order cancelled
order.refunded	Refund processed
payment.succeeded	Payment confirmed
payment.failed	Payment declined
product.created	Product added
product.updated	Product modified
customer.created	Customer registered