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 = "TextSkin") -> 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 "TextSkin")) return f""" Notification
{content_html}

Regards,
{safe_app_name} Team

""" def template_email_verification_bind(payload: Dict) -> str: app_name = payload.get('app_name') or 'TextSkin' code = payload.get('code') or '' expiration_time = payload.get('expiration_time') or '10 minutes' html_content = f"""

Email Verification

You requested to link this email address to your {html.escape(app_name)} account.

Your verification code is:

{html.escape(str(code))}

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 'TextSkin' code = payload.get('code') or '' expiration_time = payload.get('expiration_time') or '10 minutes' html_content = f"""

Password Reset Code

We received a request to reset your password. Please enter the following code to continue:

{html.escape(str(code))}

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 'TextSkin' 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 Credentials

Your account has been successfully created. Here are your temporary login details:

User:{html.escape(str(username))}
Pass:{html.escape(str(password))}

Log in to your account

""" return _email_base(html_content, app_name) def template_email_slot_subscription(payload: Dict) -> str: app_name = payload.get('app_name') or 'TextSkin' 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 '#' html_content = f"""

Visa Slot Update

This is an automated update regarding your visa slot subscription.

Location: {html.escape(location)}
Visa Type: {html.escape(str(visa_type))}
Earliest Date: {html.escape(str(earliest_date))}

Check Official Website

""" return _email_base(html_content, app_name) def template_email_appointment_confirmation(payload: Dict) -> str: """预约成功确认邮件 (Anti-Spam Optimized)""" app_name = payload.get('app_name') or 'TextSkin' username = payload.get('username') or 'Customer' order_id = payload.get('order_id') or 'N/A' 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 'N/A' appointment_date = payload.get('appointment_date') or 'Confirmed' user_email = payload.get('user_email') or 'N/A' html_content = f"""

Appointment Confirmed

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 'TextSkin' 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"""

Visa Appointment Update

We have received a new update regarding your visa process for Order #{html.escape(str(order_no))}.

Update Summary:

{html.escape(str(summary))}

For your security and privacy, please log in to your dashboard to view the full message and any relevant documents.

Access Dashboard

""" return _email_base(html_content, app_name) def template_email_ticket_created(payload: Dict) -> str: """用户工单创建确认邮件""" app_name = payload.get('app_name') or 'TextSkin' 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"""

Support Ticket Received

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.

View Ticket Details

""" return _email_base(html_content, app_name) def template_email_payment_confirmed(payload: Dict) -> str: """支付成功通知邮件""" app_name = payload.get('app_name') or 'TextSkin' 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"""

Payment Receipt

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))}

View Order Status

""" return _email_base(html_content, app_name) # ========================================== # 2. WECHAT / TELEGRAM / WHATSAPP TEMPLATES # ========================================== def template_wechat_payment_confirmed(payload: Dict) -> str: """支付成功通知模板 (企业微信 Markdown)""" amount_decimal = _format_currency(payload.get('amount')) currency = payload.get('currency') or 'USD' order_id = payload.get('order_id') or 'N/A' user_email = payload.get('user_email') or 'N/A' confirmed_at = payload.get('confirmed_at') or 'N/A' return ( f"# ✅ Payment Success\n" f"--- \n" f"💰 **Amount:** {amount_decimal} {currency}\n" f"🆔 **Order ID:** `{order_id}`\n" f"📧 **User Account:** {user_email}\n" f"🕒 **Time:** {confirmed_at}\n\n" f"Your service has been activated. Please stay tuned for further updates." ) def template_wechat_appointment_confirmation(payload: Dict) -> str: """预约成功微信通知 (Markdown)""" 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" f"--- \n" f"👤 **User:** {username}\n" f"📍 **Location:** {location}\n" f"🛂 **Visa Type:** {visa_type}\n" f"📅 **Date:** `{appointment_date}`\n" f"🆔 **Order ID:** `{order_id}`\n\n" f"Your appointment is successfully booked. Please prepare your documents." ) def template_wechat_slot_snapshot(payload: Dict) -> str: """Slot 快照与变动微信通知 (Markdown)""" has_date = bool(payload.get("earliest_date")) emoji, _, status_text = _get_status_meta(payload.get("availability_status"), has_earliest_date=has_date) summary = _format_slot_summary(payload.get("availability")) country = payload.get('country') or '' city = payload.get('city') or '' location = f"{country} {city}".strip() or "Slot Update" visa_type = payload.get('visa_type') or 'Visa' earliest_date = payload.get('earliest_date') or 'N/A' website = payload.get('website') or '#' return ( f"# {emoji} {location}\n" f"> {status_text} | {visa_type}\n\n" f"📅 **Earliest Date:** `{earliest_date}`\n\n" f"🔍 **Slots Overview:**\n{summary}\n\n" f"🔗 [Book Now]({website})" ) def template_wechat_order_event_update(payload: Dict) -> str: """订单进展微信通知 (Markdown)""" order_no = payload.get('order_no') or 'N/A' summary = payload.get('summary') or 'New progress update recorded.' return ( f"# 🔔 Visa Progress Update\n" f"--- \n" f"🆔 **Order:** `#{order_no}`\n" f"📝 **Summary:** {summary}\n\n" f"🔗 [View Dashboard](https://text.skin/dashboard)" ) def template_wechat_ticket_created(payload: Dict) -> str: """工单创建微信通知 (Markdown)""" ticket_id = payload.get('ticket_id') or 'N/A' username = payload.get('username') or 'Customer' ticket_type = payload.get('ticket_type') or 'Support' created_at = payload.get('created_at') or 'N/A' return ( f"# 🎫 New Support Ticket\n" f"--- \n" f"🆔 **Ticket ID:** `#{ticket_id}`\n" f"👤 **User:** {username}\n" f"🏷️ **Type:** {ticket_type}\n" f"🕒 **Created At:** {created_at}\n\n" f"🔗 [View Ticket]({payload.get('ticket_url') or 'https://text.skin/dashboard'})" ) def template_telegram_slot_snapshot(payload: Dict) -> str: """Slot 快照 TG 通知 (HTML)""" has_date = bool(payload.get("earliest_date")) emoji, _, status_text = _get_status_meta(payload.get("availability_status"), has_earliest_date=has_date) summary = _format_slot_summary(payload.get("availability")) country = html.escape(str(payload.get('country') or '')) city = html.escape(str(payload.get('city') or '')) location = f"{country}, {city}".strip(", ") or "Slot Update" visa_type = html.escape(str(payload.get('visa_type') or 'Visa')) earliest_date = html.escape(str(payload.get('earliest_date') or 'N/A')) website = html.escape(str(payload.get('website') or '#')) return ( f"{emoji} {location}\n" f"{html.escape(status_text)} · {visa_type}\n" f"──────────────────\n" f"📅 Earliest Date: {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_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 TextSkin." ) 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." ) # ========================================== # 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"), "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, } 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, "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, "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))