feat(phase-9): email dispatcher — HTML templates, delivery log, test endpoint
Backend: - app/models/email_log.py: EmailLog table (school_id, to, subject, type, status, error, sent_at) with EmailType + EmailStatus enums - migrations/002_phase9_email_logs.py: Alembic migration for email_logs table - app/templates/email/: 6 Jinja2 HTML templates — base layout, invoice, low_credit, license_expiry, overdue_warning, suspension - app/services/email.py: enhanced send_email() — accepts template_name+context for HTML rendering, logs every attempt to email_logs, retries up to 3x on transient SMTP failure with exponential backoff - app/routers/email.py: GET /api/email/logs (paginated, filterable by type/status/school), POST /api/email/test (send test email, super admin) - tasks/billing.py: invoice + overdue warning + suspension emails now use HTML templates - tasks/sms.py: low credit alert now uses HTML template - tasks/license.py: expiry warning now uses HTML template - app/main.py + migrations/env.py: wire in email_log model + email router Frontend: - EmailLogsPage.vue: table with to/subject/type badge/status badge/sent_at/error, type+status filters, pagination, Send Test Email modal - router/index.ts: /email-logs route - AppSidebar.vue: Email Logs nav item - api.ts: getEmailLogs, sendTestEmail
This commit is contained in:
kevin-asprec
45
backend/app/templates/email/base.html
Normal file
45
backend/app/templates/email/base.html
Normal file
@@ -0,0 +1,45 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>{{ subject }}</title>
|
||||
<style>
|
||||
body { margin: 0; padding: 0; background: #f1f5f9; font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; }
|
||||
.wrapper { max-width: 600px; margin: 32px auto; background: #ffffff; border-radius: 12px; overflow: hidden; box-shadow: 0 2px 12px rgba(0,0,0,0.08); }
|
||||
.header { background: #1e40af; padding: 24px 32px; }
|
||||
.header h1 { color: #ffffff; font-size: 18px; font-weight: 700; margin: 0; letter-spacing: -0.3px; }
|
||||
.header p { color: #93c5fd; font-size: 12px; margin: 4px 0 0; }
|
||||
.body { padding: 32px; color: #334155; font-size: 14px; line-height: 1.7; }
|
||||
.body h2 { color: #0f172a; font-size: 18px; font-weight: 700; margin: 0 0 16px; }
|
||||
.body p { margin: 0 0 14px; }
|
||||
.body a { color: #2563eb; }
|
||||
.info-box { background: #f8fafc; border: 1px solid #e2e8f0; border-radius: 8px; padding: 16px 20px; margin: 20px 0; }
|
||||
.info-box .row { display: flex; justify-content: space-between; padding: 5px 0; border-bottom: 1px solid #f1f5f9; font-size: 13px; }
|
||||
.info-box .row:last-child { border-bottom: none; }
|
||||
.info-box .label { color: #64748b; }
|
||||
.info-box .value { font-weight: 600; color: #0f172a; }
|
||||
.btn { display: inline-block; background: #2563eb; color: #ffffff !important; text-decoration: none; padding: 10px 24px; border-radius: 8px; font-weight: 600; font-size: 13px; margin: 8px 0; }
|
||||
.alert-red { background: #fef2f2; border: 1px solid #fecaca; border-radius: 8px; padding: 14px 18px; margin: 20px 0; color: #991b1b; font-size: 13px; }
|
||||
.alert-amber { background: #fffbeb; border: 1px solid #fde68a; border-radius: 8px; padding: 14px 18px; margin: 20px 0; color: #92400e; font-size: 13px; }
|
||||
.alert-green { background: #f0fdf4; border: 1px solid #bbf7d0; border-radius: 8px; padding: 14px 18px; margin: 20px 0; color: #14532d; font-size: 13px; }
|
||||
.footer { background: #f8fafc; border-top: 1px solid #e2e8f0; padding: 20px 32px; text-align: center; color: #94a3b8; font-size: 12px; }
|
||||
.footer a { color: #64748b; }
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<div class="wrapper">
|
||||
<div class="header">
|
||||
<h1>TapTrack Hub</h1>
|
||||
<p>Cloud Control Plane for TapTrack Deployments</p>
|
||||
</div>
|
||||
<div class="body">
|
||||
{% block content %}{% endblock %}
|
||||
</div>
|
||||
<div class="footer">
|
||||
<p>TapTrack Hub · <a href="mailto:support@taptrack.io">support@taptrack.io</a></p>
|
||||
<p style="margin-top:4px">You are receiving this email because you are registered as a school administrator.</p>
|
||||
</div>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
20
backend/app/templates/email/invoice.html
Normal file
20
backend/app/templates/email/invoice.html
Normal file
@@ -0,0 +1,20 @@
|
||||
{% extends "email/base.html" %}
|
||||
{% block content %}
|
||||
<h2>Invoice {{ invoice_number }}</h2>
|
||||
<p>Dear {{ contact_name }},</p>
|
||||
<p>Your invoice for <strong>{{ school_name }}</strong> has been generated for the period
|
||||
<strong>{{ period_start }}</strong> to <strong>{{ period_end }}</strong>.</p>
|
||||
|
||||
<div class="info-box">
|
||||
<div class="row"><span class="label">Invoice Number</span><span class="value">{{ invoice_number }}</span></div>
|
||||
<div class="row"><span class="label">Billing Period</span><span class="value">{{ period_start }} — {{ period_end }}</span></div>
|
||||
<div class="row"><span class="label">Amount Due</span><span class="value">PHP {{ amount }}</span></div>
|
||||
<div class="row"><span class="label">Due Date</span><span class="value">{{ due_date }}</span></div>
|
||||
</div>
|
||||
|
||||
<p>Please log in to your school portal to view and download your invoice.</p>
|
||||
<p><a class="btn" href="{{ portal_url }}/portal/billing">View Invoice</a></p>
|
||||
|
||||
<p>If you have any questions, please contact us at <a href="mailto:support@taptrack.io">support@taptrack.io</a>.</p>
|
||||
<p>Thank you,<br><strong>TapTrack Hub Team</strong></p>
|
||||
{% endblock %}
|
||||
23
backend/app/templates/email/license_expiry.html
Normal file
23
backend/app/templates/email/license_expiry.html
Normal file
@@ -0,0 +1,23 @@
|
||||
{% extends "email/base.html" %}
|
||||
{% block content %}
|
||||
<h2>License Expiring in {{ days_left }} Days</h2>
|
||||
<p>Dear {{ contact_name }},</p>
|
||||
|
||||
<div class="alert-amber">
|
||||
<strong>Your TapTrack license for {{ school_name }} expires on {{ expires_at }}.</strong>
|
||||
</div>
|
||||
|
||||
<div class="info-box">
|
||||
<div class="row"><span class="label">School</span><span class="value">{{ school_name }}</span></div>
|
||||
<div class="row"><span class="label">License Key</span><span class="value" style="font-family:monospace;font-size:12px">{{ license_key }}</span></div>
|
||||
<div class="row"><span class="label">Expires On</span><span class="value">{{ expires_at }}</span></div>
|
||||
<div class="row"><span class="label">Days Remaining</span><span class="value" style="color:#b45309">{{ days_left }} days</span></div>
|
||||
</div>
|
||||
|
||||
<p>When your license expires, SMS notifications will be disabled and your on-prem TapTrack
|
||||
instance will enter read-only mode. Please contact us to renew your license before it expires.</p>
|
||||
|
||||
<p><a class="btn" href="mailto:support@taptrack.io?subject=License Renewal — {{ school_name }}">Contact Us to Renew</a></p>
|
||||
|
||||
<p>Thank you,<br><strong>TapTrack Hub Team</strong></p>
|
||||
{% endblock %}
|
||||
23
backend/app/templates/email/low_credit.html
Normal file
23
backend/app/templates/email/low_credit.html
Normal file
@@ -0,0 +1,23 @@
|
||||
{% extends "email/base.html" %}
|
||||
{% block content %}
|
||||
<h2>Low SMS Credits — Action Required</h2>
|
||||
<p>Dear {{ contact_name }},</p>
|
||||
|
||||
<div class="alert-amber">
|
||||
<strong>Your SMS credit balance for {{ school_name }} is running low.</strong>
|
||||
</div>
|
||||
|
||||
<div class="info-box">
|
||||
<div class="row"><span class="label">School</span><span class="value">{{ school_name }}</span></div>
|
||||
<div class="row"><span class="label">Current Balance</span><span class="value" style="color:#b45309">{{ credits_remaining }} credits</span></div>
|
||||
<div class="row"><span class="label">Low Credit Threshold</span><span class="value">{{ threshold }} credits</span></div>
|
||||
</div>
|
||||
|
||||
<p>SMS notifications to parents and guardians will stop working when your credit balance reaches zero.
|
||||
Please top up your credits to ensure uninterrupted service.</p>
|
||||
|
||||
<p><a class="btn" href="{{ portal_url }}/portal/billing">Request Credit Top-Up</a></p>
|
||||
|
||||
<p>If you need assistance, contact us at <a href="mailto:support@taptrack.io">support@taptrack.io</a>.</p>
|
||||
<p>Thank you,<br><strong>TapTrack Hub Team</strong></p>
|
||||
{% endblock %}
|
||||
26
backend/app/templates/email/overdue_warning.html
Normal file
26
backend/app/templates/email/overdue_warning.html
Normal file
@@ -0,0 +1,26 @@
|
||||
{% extends "email/base.html" %}
|
||||
{% block content %}
|
||||
<h2>Overdue Invoice — Immediate Action Required</h2>
|
||||
<p>Dear {{ contact_name }},</p>
|
||||
|
||||
<div class="alert-red">
|
||||
<strong>Invoice {{ invoice_number }} is overdue. Please settle this immediately to avoid account suspension.</strong>
|
||||
</div>
|
||||
|
||||
<div class="info-box">
|
||||
<div class="row"><span class="label">Invoice Number</span><span class="value">{{ invoice_number }}</span></div>
|
||||
<div class="row"><span class="label">Amount</span><span class="value">PHP {{ amount }}</span></div>
|
||||
<div class="row"><span class="label">Was Due On</span><span class="value" style="color:#dc2626">{{ due_date }}</span></div>
|
||||
<div class="row"><span class="label">Days Overdue</span><span class="value" style="color:#dc2626">{{ days_overdue }} days</span></div>
|
||||
</div>
|
||||
|
||||
<p>If this invoice is not settled within <strong>{{ days_until_suspension }} days</strong>, your TapTrack
|
||||
account will be automatically suspended. This will disable SMS notifications for your school.</p>
|
||||
|
||||
<p><a class="btn" style="background:#dc2626" href="{{ portal_url }}/portal/billing">View & Settle Invoice</a></p>
|
||||
|
||||
<p>If you believe this is an error or need to discuss payment arrangements, please contact us
|
||||
at <a href="mailto:support@taptrack.io">support@taptrack.io</a> immediately.</p>
|
||||
|
||||
<p>Thank you,<br><strong>TapTrack Hub Team</strong></p>
|
||||
{% endblock %}
|
||||
32
backend/app/templates/email/suspension.html
Normal file
32
backend/app/templates/email/suspension.html
Normal file
@@ -0,0 +1,32 @@
|
||||
{% extends "email/base.html" %}
|
||||
{% block content %}
|
||||
<h2>Account Suspended</h2>
|
||||
<p>Dear {{ contact_name }},</p>
|
||||
|
||||
<div class="alert-red">
|
||||
<strong>Your TapTrack account for {{ school_name }} has been suspended due to an unpaid invoice.</strong>
|
||||
</div>
|
||||
|
||||
<div class="info-box">
|
||||
<div class="row"><span class="label">School</span><span class="value">{{ school_name }}</span></div>
|
||||
<div class="row"><span class="label">Invoice</span><span class="value">{{ invoice_number }}</span></div>
|
||||
<div class="row"><span class="label">Amount</span><span class="value">PHP {{ amount }}</span></div>
|
||||
<div class="row"><span class="label">Original Due Date</span><span class="value">{{ due_date }}</span></div>
|
||||
</div>
|
||||
|
||||
<p>The following services are now <strong>disabled</strong>:</p>
|
||||
<ul style="margin:8px 0 16px;padding-left:20px;color:#334155">
|
||||
<li>SMS notifications to parents and guardians</li>
|
||||
<li>Automated monthly reports</li>
|
||||
<li>License validation (on-prem may enter warning mode)</li>
|
||||
</ul>
|
||||
|
||||
<p>Attendance recording on your on-prem TapTrack instance continues to function.</p>
|
||||
|
||||
<p>To restore full service, please settle the overdue invoice immediately and contact us at
|
||||
<a href="mailto:support@taptrack.io">support@taptrack.io</a> to lift the suspension.</p>
|
||||
|
||||
<p><a class="btn" style="background:#dc2626" href="mailto:support@taptrack.io?subject=Account Suspension — {{ school_name }}">Contact Support to Restore</a></p>
|
||||
|
||||
<p>Thank you,<br><strong>TapTrack Hub Team</strong></p>
|
||||
{% endblock %}
|
||||
Reference in New Issue
Block a user