feat(i18n): add multilanguage support to waitlist emails and result pages

- Add 'language' column to waitlist_entries (en/it/es/fr/de, default en) - Accept 'lang' field in POST /waitlist request body - Translate confirmation email (subject, badge, heading, body, CTA, footer) - Translate confirm/unsubscribe result HTML pages - Return localized success message in WaitlistResponse - Update language preference on duplicate signups - Alembic migration 003_add_language_column
2026-04-12 10:06:35 +02:00
parent d32fc7ae30
commit b7ba18641b
5 changed files with 210 additions and 33 deletions
--- a/app/brevo.py
+++ b/app/brevo.py
@@ -15,6 +15,65 @@ logger = logging.getLogger(__name__)

 BREVO_API = "https://api.brevo.com/v3"

+# ── Translations for transactional emails ──────────────────────────────
+_EMAIL_I18N: dict[str, dict[str, str]] = {
+    "en": {
+        "subject": "Confirm your spot on the adiuvAI waitlist",
+        "preheader": "Confirm your email to secure your early access spot on the adiuvAI waitlist.",
+        "badge": "One more step",
+        "heading": "Confirm your spot on<br>the waitlist",
+        "body": "Thanks for signing up! Please confirm your email address so we can keep you in the loop when adiuvAI launches.",
+        "cta": "Confirm my email",
+        "expiry": "This link expires in {hours} hours.",
+        "footer": "If you didn't sign up, simply ignore this email.",
+    },
+    "it": {
+        "subject": "Conferma il tuo posto nella lista d'attesa di adiuvAI",
+        "preheader": "Conferma la tua email per assicurarti un accesso anticipato ad adiuvAI.",
+        "badge": "Ancora un passaggio",
+        "heading": "Conferma il tuo posto<br>nella lista d'attesa",
+        "body": "Grazie per esserti iscritto! Conferma il tuo indirizzo email così potremo aggiornarti quando adiuvAI sarà disponibile.",
+        "cta": "Conferma la mia email",
+        "expiry": "Questo link scade tra {hours} ore.",
+        "footer": "Se non ti sei iscritto, ignora semplicemente questa email.",
+    },
+    "es": {
+        "subject": "Confirma tu lugar en la lista de espera de adiuvAI",
+        "preheader": "Confirma tu correo para asegurar tu acceso anticipado a adiuvAI.",
+        "badge": "Un paso más",
+        "heading": "Confirma tu lugar en<br>la lista de espera",
+        "body": "¡Gracias por registrarte! Confirma tu dirección de correo para que podamos avisarte cuando adiuvAI esté listo.",
+        "cta": "Confirmar mi correo",
+        "expiry": "Este enlace caduca en {hours} horas.",
+        "footer": "Si no te registraste, simplemente ignora este correo.",
+    },
+    "fr": {
+        "subject": "Confirmez votre place sur la liste d'attente d'adiuvAI",
+        "preheader": "Confirmez votre e‑mail pour sécuriser votre accès anticipé à adiuvAI.",
+        "badge": "Encore une étape",
+        "heading": "Confirmez votre place sur<br>la liste d'attente",
+        "body": "Merci de vous être inscrit ! Veuillez confirmer votre adresse e‑mail pour que nous puissions vous tenir informé du lancement d'adiuvAI.",
+        "cta": "Confirmer mon e‑mail",
+        "expiry": "Ce lien expire dans {hours} heures.",
+        "footer": "Si vous ne vous êtes pas inscrit, ignorez simplement cet e‑mail.",
+    },
+    "de": {
+        "subject": "Bestätige deinen Platz auf der adiuvAI-Warteliste",
+        "preheader": "Bestätige deine E‑Mail, um dir den frühen Zugang zu adiuvAI zu sichern.",
+        "badge": "Noch ein Schritt",
+        "heading": "Bestätige deinen Platz<br>auf der Warteliste",
+        "body": "Danke für deine Anmeldung! Bitte bestätige deine E‑Mail-Adresse, damit wir dich informieren können, wenn adiuvAI startet.",
+        "cta": "Meine E‑Mail bestätigen",
+        "expiry": "Dieser Link läuft in {hours} Stunden ab.",
+        "footer": "Falls du dich nicht angemeldet hast, ignoriere diese E‑Mail einfach.",
+    },
+}
+
+
+def _t(lang: str, key: str) -> str:
+    """Get translated string, falling back to English."""
+    return _EMAIL_I18N.get(lang, _EMAIL_I18N["en"]).get(key, _EMAIL_I18N["en"][key])
+

 def _headers() -> dict[str, str]:
    return {
@@ -24,7 +83,7 @@ def _headers() -> dict[str, str]:
    }


-async def send_confirmation_email(email: str, confirm_url: str, unsubscribe_url: str = "") -> bool:
+async def send_confirmation_email(email: str, confirm_url: str, unsubscribe_url: str = "", lang: str = "en") -> bool:
    """Send a double opt-in confirmation email. Returns True on success."""
    if not settings.brevo_configured:
        logger.warning("Brevo not configured — skipping confirmation email for %s***", email[:3])
@@ -36,8 +95,8 @@ async def send_confirmation_email(email: str, confirm_url: str, unsubscribe_url:
            "email": settings.BREVO_SENDER_EMAIL,
        },
        "to": [{"email": email}],
-        "subject": "Confirm your spot on the adiuvAI waitlist",
-        "htmlContent": _confirmation_html(confirm_url, unsubscribe_url),
+        "subject": _t(lang, "subject"),
+        "htmlContent": _confirmation_html(confirm_url, unsubscribe_url, lang),
    }

    try:
@@ -78,18 +137,27 @@ async def add_contact_to_list(email: str) -> bool:
        return False


-def _confirmation_html(confirm_url: str, unsubscribe_url: str = "") -> str:
+def _confirmation_html(confirm_url: str, unsubscribe_url: str = "", lang: str = "en") -> str:
    """Email template aligned with the adiuvAI landing page brand."""
+    html_lang = lang if lang in ("en", "it", "es", "fr", "de") else "en"
+    badge = _t(lang, "badge")
+    heading = _t(lang, "heading")
+    body = _t(lang, "body")
+    cta = _t(lang, "cta")
+    expiry = _t(lang, "expiry").format(hours=settings.CONFIRM_TOKEN_EXPIRY_HOURS)
+    preheader = _t(lang, "preheader")
+    footer = _t(lang, "footer")
+    unsub_label = {"en": "Unsubscribe", "it": "Annulla iscrizione", "es": "Cancelar suscripción", "fr": "Se désabonner", "de": "Abmelden"}.get(lang, "Unsubscribe")
    return f"""\
 <!DOCTYPE html>
-<html lang="en" xmlns="http://www.w3.org/1999/xhtml">
+<html lang="{html_lang}" xmlns="http://www.w3.org/1999/xhtml">
 <head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width,initial-scale=1">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="color-scheme" content="light">
  <meta name="supported-color-schemes" content="light">
-  <title>Confirm your spot — adiuvAI</title>
+  <title>{_t(lang, "subject")} — adiuvAI</title>
  <!--[if mso]><style>table,td{{font-family:Arial,sans-serif!important;}}</style><![endif]-->
 </head>
 <body style="margin:0;padding:0;width:100%;background-color:#f4edf3;
@@ -98,7 +166,7 @@ def _confirmation_html(confirm_url: str, unsubscribe_url: str = "") -> str:

  <!-- Preheader (hidden text for inbox preview) -->
  <div style="display:none;font-size:1px;color:#f4edf3;line-height:1px;max-height:0;max-width:0;opacity:0;overflow:hidden;">
-    Confirm your email to secure your early access spot on the adiuvAI waitlist.
+    {preheader}
  </div>

  <!-- Outer wrapper -->
@@ -156,21 +224,20 @@ def _confirmation_html(confirm_url: str, unsubscribe_url: str = "") -> str:
              border:1px solid rgba(251,200,129,0.2);
              font-size:11px;font-weight:600;letter-spacing:0.06em;
              text-transform:uppercase;color:#e5a94e;">
-              &#9679;&ensp;One more step
+              &#9679;&ensp;{badge}
            </td></tr>
          </table>

          <!-- Heading -->
          <h1 style="margin:0 0 16px;font-size:24px;font-weight:600;
            letter-spacing:-0.03em;line-height:1.2;color:#040404;text-align:center;">
-            Confirm your spot on<br>the waitlist
+            {heading}
          </h1>

          <!-- Paragraph -->
          <p style="margin:0 0 28px;font-size:15px;line-height:1.7;color:#8a8ea9;
            text-align:center;">
-            Thanks for signing up! Please confirm your email address
-            so we can keep you in the loop when adiuvAI launches.
+            {body}
          </p>

          <!-- CTA Button -->
@@ -184,14 +251,14 @@ def _confirmation_html(confirm_url: str, unsubscribe_url: str = "") -> str:
                   color:#fbfbfb;text-decoration:none;
                   border-radius:50px;
                   font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;">
-                Confirm my email
+                {cta}
              </a>
            </td></tr>
          </table>

          <!-- Expiry note -->
          <p style="margin:20px 0 0;font-size:13px;color:#c8c3cd;text-align:center;">
-            This link expires in {settings.CONFIRM_TOKEN_EXPIRY_HOURS} hours.
+            {expiry}
          </p>

        </td></tr>
@@ -206,12 +273,12 @@ def _confirmation_html(confirm_url: str, unsubscribe_url: str = "") -> str:
        <!-- Footer -->
        <tr><td style="padding:20px 40px 32px;text-align:center;">
          <p style="margin:0;font-size:12px;color:#c8c3cd;line-height:1.5;">
-            If you didn't sign up, simply ignore this email.
+            {footer}
          </p>
          <p style="margin:8px 0 0;font-size:12px;color:#c8c3cd;">
            <a href="https://adiuvai.com" style="color:#8a8ea9;text-decoration:underline;
              text-underline-offset:2px;">adiuvai.com</a>
-            {f'&ensp;·&ensp;<a href="{unsubscribe_url}" style="color:#8a8ea9;text-decoration:underline;text-underline-offset:2px;">Unsubscribe</a>' if unsubscribe_url else ''}
+            {f'&ensp;·&ensp;<a href="{unsubscribe_url}" style="color:#8a8ea9;text-decoration:underline;text-underline-offset:2px;">{unsub_label}</a>' if unsubscribe_url else ''}
          </p>
        </td></tr>