Regards,
{safe_app_name} Team
import html from typing import Dict, Tuple, Any, List # ========================================== # 0. Internal Helpers # ========================================== def _format_slot_summary(availability: Any) -> str: """格式化槽位可用日期摘要""" if not isinstance(availability, list) or not availability: return "No specific time slots recorded." items = [] for day in availability[:4]: if isinstance(day, dict): date = day.get("date") or "" if date: items.append(f"- {date}") elif isinstance(day, str) and day: items.append(f"- {day}") return "\n".join(items) if items else "No specific time slots recorded." def _format_currency(amount_in_cents: Any) -> str: """将分转换为元,保留两位小数;若为 None 或空则返回 0.00""" if amount_in_cents is None or amount_in_cents == "": return "0.00" try: value = float(amount_in_cents) / 100.0 return f"{value:.2f}" except (ValueError, TypeError): return str(amount_in_cents) def _get_status_meta(status: Any, has_earliest_date: bool = False) -> Tuple[str, str, str]: """ 智能解析状态,忽略大小写,并支持根据最早日期回退 """ if not status: if has_earliest_date: return "READY", "#16a34a", "Available" return "NONE", "#dc2626", "No Slots" s = str(status).strip().lower() if s in ("available", "ready", "ok", "open"): return "READY", "#16a34a", "Available" if s in ("waitlist", "wait", "pending"): return "WAIT", "#ca8a04", "Waitlist Only" if s in ("none", "unavailable", "closed", "full"): return "NONE", "#dc2626", "No Slots" # 若状态未知但有最早日期,默认作为 Available if has_earliest_date: return "READY", "#16a34a", str(status) return "NONE", "#dc2626", str(status) # ========================================== # 1. EMAIL TEMPLATES (Anti-Spam Optimized) # ========================================== def _email_base(content_html: str, app_name: str = "STRATA") -> str: """ Ultra-clean HTML structure. Uses standard fonts and minimal CSS to pass through ESP filters. """ safe_app_name = html.escape(str(app_name or "STRATA")) return f"""
Regards,
{safe_app_name} Team
You requested to link this email address to your {html.escape(app_name)} account.
Your verification code is:
This code will expire in {html.escape(str(expiration_time))}.
If you did not make this request, you can safely ignore this email.
""" return _email_base(html_content, app_name) def template_email_password_reset(payload: Dict) -> str: app_name = payload.get('app_name') or 'STRATA' code = payload.get('code') or '' expiration_time = payload.get('expiration_time') or '10 minutes' html_content = f"""We received a request to reset your password. Please enter the following code to continue:
Valid for {html.escape(str(expiration_time))}. For security reasons, do not share this code.
""" return _email_base(html_content, app_name) def template_email_login_credentials(payload: Dict) -> str: app_name = payload.get('app_name') or 'STRATA' username = payload.get('username') or '' password = payload.get('password') or '' login_url = payload.get('login_url') or 'https://text.skin/login' html_content = f"""Your account has been successfully created. Here are your temporary login details:
| User: | {html.escape(str(username))} |
| Pass: | {html.escape(str(password))} |
This is an automated update regarding your visa slot subscription.
Dear {html.escape(str(username))},
We are pleased to inform you that your visa appointment has been successfully booked.
| Order ID: | {html.escape(str(order_id))} |
| Location: | {html.escape(location)} |
| Visa Type: | {html.escape(str(visa_type))} |
| Appointment Date: | {html.escape(str(appointment_date))} |
| Account Email: | {html.escape(str(user_email))} |
Please ensure you prepare all required documents well in advance of your appointment date. If you have any questions, feel free to contact our support team.
""" return _email_base(html_content, app_name) def template_email_order_event_update(payload: Dict) -> str: """订单事件进度更新邮件""" app_name = payload.get('app_name') or 'STRATA' order_no = payload.get('order_no') or 'N/A' summary = payload.get('summary') or 'No summary available.' dashboard_url = payload.get('dashboard_url') or 'https://text.skin/dashboard' html_content = f"""We have received a new update regarding your visa process for Order #{html.escape(str(order_no))}.
{html.escape(str(summary))}
For your security and privacy, please log in to your dashboard to view the full message and any relevant documents.
""" return _email_base(html_content, app_name) def template_email_ticket_created(payload: Dict) -> str: """用户工单创建确认邮件""" app_name = payload.get('app_name') or 'STRATA' username = payload.get('username') or 'Customer' ticket_id = payload.get('ticket_id') or 'N/A' ticket_type = payload.get('ticket_type') or 'Support' ticket_url = payload.get('ticket_url') or 'https://text.skin/dashboard' created_at = payload.get('created_at') or 'N/A' html_content = f"""Dear {html.escape(str(username))},
Thank you for contacting us. We have received your support request and assigned it Ticket #{html.escape(str(ticket_id))}.
| Ticket ID: | #{html.escape(str(ticket_id))} |
| Type: | {html.escape(str(ticket_type))} |
| Created At: | {html.escape(str(created_at))} |
Our support team will review your inquiry and get back to you as soon as possible.
""" return _email_base(html_content, app_name) def template_email_ticket_resolved(payload: Dict) -> str: """用户工单处理完成提醒邮件""" app_name = payload.get('app_name') or 'STRATA' username = payload.get('username') or 'Customer' ticket_id = payload.get('ticket_id') or 'N/A' ticket_type = payload.get('ticket_type') or 'Support' resolution_comment = payload.get('resolution_comment') or payload.get('comment') or 'Your ticket has been marked as resolved by our customer support team.' ticket_url = payload.get('ticket_url') or 'https://text.skin/dashboard' resolved_at = payload.get('resolved_at') or 'N/A' html_content = f"""Dear {html.escape(str(username))},
Your support request Ticket #{html.escape(str(ticket_id))} has been marked as Resolved by our support team.
| Ticket ID: | #{html.escape(str(ticket_id))} |
| Type: | {html.escape(str(ticket_type))} |
| Status: | Resolved |
| Resolution / Notes: | {html.escape(str(resolution_comment))} |
| Resolved At: | {html.escape(str(resolved_at))} |
If you have any further questions or need additional assistance, you can view the full details or reply directly via the dashboard.
""" return _email_base(html_content, app_name) def template_email_payment_confirmed(payload: Dict) -> str: """支付成功通知邮件""" app_name = payload.get('app_name') or 'STRATA' amount_decimal = _format_currency(payload.get('amount')) currency = payload.get('currency') or 'USD' order_id = payload.get('order_id') or 'N/A' confirmed_at = payload.get('confirmed_at') or 'N/A' html_content = f"""Thank you for your payment. Your order has been confirmed.
| Order ID: | {html.escape(str(order_id))} |
| Amount: | {html.escape(amount_decimal)} {html.escape(str(currency))} |
| Time: | {html.escape(str(confirmed_at))} |
{earliest_date}\n\n"
f"📊 Availability:\n{html.escape(summary)}\n"
f"──────────────────\n"
f"🔗 Official Website ➜\n\n"
)
def template_telegram_appointment_confirmation(payload: Dict) -> str:
"""预约成功 TG 通知 (HTML)"""
username = html.escape(str(payload.get('username') or 'Customer'))
country = html.escape(str(payload.get('country') or ''))
city = html.escape(str(payload.get('city') or ''))
location = f"{country}, {city}".strip(", ") or "N/A"
visa_type = html.escape(str(payload.get('visa_type') or 'Visa'))
appointment_date = html.escape(str(payload.get('appointment_date') or 'Confirmed'))
order_id = html.escape(str(payload.get('order_id') or 'N/A'))
user_email = html.escape(str(payload.get('user_email') or 'N/A'))
return (
f"🎉 Appointment Confirmed\n"
f"──────────────────\n"
f"👤 Name: {username}\n"
f"📍 Location: {location}\n"
f"🛂 Visa Type: {visa_type}\n"
f"📅 Date: {appointment_date}\n"
f"──────────────────\n"
f"🆔 Order: {order_id}\n"
f"📧 Email: {user_email}"
)
def template_telegram_order_event_update(payload: Dict) -> str:
"""订单进展 TG 通知 (HTML)"""
summary = html.escape(str(payload.get('summary') or 'New status update received.'))
order_no = html.escape(str(payload.get('order_no') or 'N/A'))
return (
f"🔔 Visa Progress Update\n"
f"──────────────────\n"
f"🆔 Order: #{order_no}\n"
f"📊 Summary:\n{summary}\n"
f"──────────────────\n"
f"🔗 View Dashboard ➜"
)
def template_telegram_payment_confirmed(payload: Dict) -> str:
"""支付成功 TG 通知 (HTML)"""
amount_decimal = html.escape(_format_currency(payload.get('amount')))
currency = html.escape(str(payload.get('currency') or 'USD'))
order_id = html.escape(str(payload.get('order_id') or 'N/A'))
return (
f"✅ Payment Received\n"
f"──────────────────\n"
f"💰 Amount: {amount_decimal} {currency}\n"
f"🆔 Order: #{order_id}\n"
f"──────────────────\n"
f"🔗 Dashboard ➜"
)
def template_telegram_ticket_created(payload: Dict) -> str:
"""工单创建 TG 通知 (HTML)"""
ticket_id = html.escape(str(payload.get('ticket_id') or 'N/A'))
ticket_type = html.escape(str(payload.get('ticket_type') or 'Support'))
username = html.escape(str(payload.get('username') or 'Customer'))
return (
f"🎫 Support Ticket #{ticket_id}\n"
f"──────────────────\n"
f"👤 User: {username}\n"
f"🏷️ Type: {ticket_type}\n"
f"──────────────────\n"
f"🔗 View Details ➜"
)
def template_telegram_ticket_resolved(payload: Dict) -> str:
"""工单解决 TG 通知 (HTML)"""
ticket_id = html.escape(str(payload.get('ticket_id') or 'N/A'))
ticket_type = html.escape(str(payload.get('ticket_type') or 'Support'))
username = html.escape(str(payload.get('username') or 'Customer'))
comment = html.escape(str(payload.get('resolution_comment') or payload.get('comment') or 'Resolved'))
return (
f"✅ Support Ticket #{ticket_id} Resolved\n"
f"──────────────────\n"
f"👤 User: {username}\n"
f"🏷️ Type: {ticket_type}\n"
f"📝 Note: {comment}\n"
f"──────────────────\n"
f"🔗 View Details ➜"
)
def template_whatsapp_slot_snapshot(payload: Dict) -> str:
"""Slot 快照 WhatsApp 通知 (Clean Text)"""
has_date = bool(payload.get("earliest_date"))
emoji, _, _ = _get_status_meta(payload.get("availability_status"), has_earliest_date=has_date)
country = payload.get('country') or ''
city = payload.get('city') or ''
location = f"{country}, {city}".strip(", ") or "Specified Location"
visa_type = payload.get('visa_type') or 'Visa'
earliest_date = payload.get('earliest_date') or 'Available now'
website = payload.get('website') or '#'
return (
f"{emoji} *VISA SLOT UPDATE*\n\n"
f"📍 *Location:* {location}\n"
f"🛂 *Type:* {visa_type}\n"
f"📅 *Earliest:* {earliest_date}\n\n"
f"🌐 *Book Now:* {website}"
)
def template_whatsapp_appointment_confirmation(payload: Dict) -> str:
"""预约成功 WhatsApp 通知 (Clean Text)"""
username = payload.get('username') or 'Customer'
country = payload.get('country') or ''
city = payload.get('city') or ''
location = f"{country}, {city}".strip(", ") or "N/A"
visa_type = payload.get('visa_type') or 'Visa'
appointment_date = payload.get('appointment_date') or 'Confirmed'
order_id = payload.get('order_id') or 'N/A'
return (
f"✅ *APPOINTMENT CONFIRMED*\n\n"
f"Dear {username},\n"
f"Your visa appointment has been successfully booked.\n\n"
f"📍 *Location:* {location}\n"
f"🛂 *Visa Type:* {visa_type}\n"
f"📅 *Date:* {appointment_date}\n"
f"🆔 *Order ID:* {order_id}\n\n"
f"Please ensure all required documents are prepared. Thank you for choosing STRATA."
)
def template_whatsapp_order_event_update(payload: Dict) -> str:
"""WhatsApp 进展通知"""
order_no = payload.get('order_no') or 'N/A'
message = payload.get('message')
if not message:
summary = payload.get('summary') or 'New status update received.'
message = (
f"🔔 *VISA PROGRESS UPDATE*\n\n"
f"Order: #{order_no}\n\n"
f"Latest Update:\n"
f"_{summary}_\n\n"
f"Please log in to your dashboard or check your email for full details."
)
return message
def template_whatsapp_payment_confirmed(payload: Dict) -> str:
"""支付成功 WhatsApp 通知"""
amount_decimal = _format_currency(payload.get('amount'))
currency = payload.get('currency') or 'USD'
order_id = payload.get('order_id') or 'N/A'
return (
f"✅ *PAYMENT RECEIVED*\n\n"
f"Order: #{order_id}\n"
f"Amount: {amount_decimal} {currency}\n\n"
f"Your service is active. Thank you!"
)
def template_whatsapp_ticket_created(payload: Dict) -> str:
"""工单创建 WhatsApp 通知"""
ticket_id = payload.get('ticket_id') or 'N/A'
ticket_type = payload.get('ticket_type') or 'Support'
return (
f"🎫 *SUPPORT TICKET CREATED*\n\n"
f"Ticket ID: #{ticket_id}\n"
f"Type: {ticket_type}\n\n"
f"Our team will contact you shortly."
)
def template_whatsapp_ticket_resolved(payload: Dict) -> str:
"""工单解决 WhatsApp 通知"""
ticket_id = payload.get('ticket_id') or 'N/A'
ticket_type = payload.get('ticket_type') or 'Support'
comment = payload.get('resolution_comment') or payload.get('comment') or 'Resolved'
return (
f"✅ *SUPPORT TICKET RESOLVED*\n\n"
f"Ticket ID: #{ticket_id}\n"
f"Type: {ticket_type}\n"
f"Note: {comment}\n\n"
f"Thank you for contacting support."
)
# ==========================================
# 3. Dispatchers & Maps
# ==========================================
EMAIL_MAP = {
"email_verification_for_bind": (template_email_verification_bind, "Verification code for your account"),
"email_verification_for_reset": (template_email_password_reset, "Password reset code"),
"login_credentials": (template_email_login_credentials, "Your login credentials"),
"slot_subscription": (template_email_slot_subscription, "Update: Visa availability change"),
"appointment_confirmation": (template_email_appointment_confirmation, "Your Visa Appointment Confirmation"),
"order_event_update": (template_email_order_event_update, "Notification: Visa Appointment Update"),
"ticket_created": (template_email_ticket_created, "Support Ticket Received"),
"ticket_resolved": (template_email_ticket_resolved, "Support Ticket Resolved"),
"payment_user_confirmed": (template_email_payment_confirmed, "Payment Confirmation Receipt"),
"payment_confirmed": (template_email_payment_confirmed, "Payment Confirmation Receipt"),
}
WECHAT_MAP = {
"slot_snapshot": template_wechat_slot_snapshot,
"slot_subscription": template_wechat_slot_snapshot,
"payment_user_confirmed": template_wechat_payment_confirmed,
"payment_confirmed": template_wechat_payment_confirmed,
"appointment_confirmation": template_wechat_appointment_confirmation,
"order_event_update": template_wechat_order_event_update,
"ticket_created": template_wechat_ticket_created,
"ticket_resolved": template_wechat_ticket_resolved,
}
WHATSAPP_MAP = {
"slot_subscription": template_whatsapp_slot_snapshot,
"slot_snapshot": template_whatsapp_slot_snapshot,
"appointment_confirmation": template_whatsapp_appointment_confirmation,
"order_event_update": template_whatsapp_order_event_update,
"ticket_created": template_whatsapp_ticket_created,
"ticket_resolved": template_whatsapp_ticket_resolved,
"payment_user_confirmed": template_whatsapp_payment_confirmed,
"payment_confirmed": template_whatsapp_payment_confirmed,
}
TELEGRAM_MAP = {
"slot_snapshot": template_telegram_slot_snapshot,
"slot_subscription": template_telegram_slot_snapshot,
"appointment_confirmation": template_telegram_appointment_confirmation,
"order_event_update": template_telegram_order_event_update,
"ticket_created": template_telegram_ticket_created,
"ticket_resolved": template_telegram_ticket_resolved,
"payment_user_confirmed": template_telegram_payment_confirmed,
"payment_confirmed": template_telegram_payment_confirmed,
}
def render_email(tid: str, payload: Dict) -> str:
if tid in EMAIL_MAP:
return EMAIL_MAP[tid][0](payload)
return _email_base(f"{html.escape(str(payload))}
") def get_email_meta(tid: str) -> Tuple[str, str]: sender = "hujiarui8@gmail.com" if tid in EMAIL_MAP: return (sender, EMAIL_MAP[tid][1]) return (sender, "Notification") def render_wechat_markdown(tid: str, payload: Dict) -> str: if tid in WECHAT_MAP: return WECHAT_MAP[tid](payload) return str(payload) def render_whatsapp_text(tid: str, payload: Dict) -> str: if tid in WHATSAPP_MAP: return WHATSAPP_MAP[tid](payload) return str(payload) def render_telegram_html(tid: str, payload: Dict) -> str: if tid in TELEGRAM_MAP: return TELEGRAM_MAP[tid](payload) return html.escape(str(payload))