# MAIL-02 · Transaktionale Mail-Sprache und Plaintext vollständig ausliefern | | | | ----------------- | ------------------------------------------- | | **Typ** | Launch-Härtung · Mail-UX / Accessibility | | **Owner** | Raffael | | **Phase** | Pilot-Härtung | | **Cycle/Fenster** | gestartet 2026-08-01 | | **Status** | Done | | **Plane** | HIVEGRID-238 | ## Abhängigkeiten & Parallelität - **Blocked by:** kein technischer Blocker. `MAIL-01` ist Done und belegt den funktionierenden Signup-, Queue-, Mailjet- und Inbox-Pfad. - **Blocks:** barriereärmere, sprachkonsistente transaktionale Pilot-Mails. - **Abhängigkeitsschutz:** Provider, Sender, Queue-Namen, Retry, Idempotenz, Signup-Replay und Marketingversand bleiben unverändert. ## Was / Warum Der reale deutsche Welcome-Proof aus `MAIL-01` wurde zugestellt, deklariert das HTML-Dokument aber als Englisch und zeigt im Footer englische Legal-/Support- Texte. Zudem erzeugt der kanonische Renderer bereits eine Plaintext-Version, die der Web-Wrapper vor Queue und Mailjet verwirft. Der einzelne Bindestrich in der Signatur wird als eigene sichtbare Zeile gerendert. Dieser Slice führt die vorhandene Locale und die bestehenden de/en-Mailtexte als expliziten Chrome-Vertrag bis in das React-Template. HTML und Plaintext werden gemeinsam durch den unveränderten Outbox-/Queue-Vertrag transportiert; Mailjet erhält den Text über das bereits unterstützte `TextPart`. ## Nicht im Scope - Kein neuer Welcome-Inhalt, Workspace-Text, Onboarding-Schritt oder CTA-Ziel. - Kein Branding-/Logo-Adapter und keine White-Label-Erweiterung. - Kein neuer Delivery-Status, Alarm oder Operator-Dashboard. - Keine Provider-, Sender-, Secret-, Retry-, Idempotenz- oder Marketingänderung. ## Definition of Done - [x] Transaktionale Templates erhalten eine normalisierte `de`-/`en`-Sprache und setzen das passende `lang`-Attribut am HTML-Dokument. - [x] Legal-Links, Supportzeile und optionaler Abmeldelink verwenden die vorhandenen de/en-Übersetzungen; kein englischer Footer bleibt in der deutschen Welcome-Mail. - [x] Der einzelne Signatur-Bindestrich entfällt, ohne Absendername oder bestehenden Signoff-Text zu verändern. - [x] Die bereits erzeugte Plaintext-Version wird im Template-Resultat, im Welcome-Outbox-Payload und im Mailjet-`TextPart` unverändert erhalten. - [x] Fokus-Tests decken deutsche und englische Sprache, Footer, Plaintext, Welcome-Outbox, Replay-Stabilität und den finalen Provider-Payload ab. - [x] Typecheck, Lint, vollständige PR-CI, normaler Merge und Staging-Deploy sind grün; ein gerenderter deutscher Welcome-Proof liegt als Screenshot vor. **MAIL-02: 6/6 DoD = 100 % done. 0 Punkte offen.** ## Technische Bausteine - `packages/mail/src/templates-react/_layout/BaseLayout.tsx` - `packages/mail/src/templates-react/_layout/Footer.tsx` - `packages/mail/src/templates-react/transactional/shared.tsx` - `apps/web/app/modules/emails/utils/EmailTemplates.ts` - Signup-Welcome-Outbox in `apps/web/app/utils/services/authService.ts` - bestehende `packages/mail`- und Signup-/Outbox-Tests - CR-015 in `docs/CHANGE-REQUESTS.md` ## Rollback Reiner Code-Rollback des optionalen Mail-Chrome- und Text-Payload-Vertrags. HTML bleibt bei älteren Aufrufern durch Defaults kompatibel. Es gibt keine Datenmigration, Provider-Mutation oder Änderung persistierter Idempotenzkeys. ## Quellen - Mailjet: `https://documentation.mailjet.com/hc/de/articles/39399376475675-Barrierefreie-E-Mails-erstellen-Best-Practices` - `MAIL-01` Inbox- und Rendering-Proof, Screenshot `58` ## Umsetzungs-Notiz 2026-08-01 · Scope, Implementierung und lokaler Proof - Der echte deutsche Signup wurde exakt einmal zugestellt; Funktion und Mailjet-CustomID sind damit kein Blocker mehr. - Visueller Proof: deutscher Hauptinhalt, aber `lang="en"`, englischer Footer, sichtbare einzelne Bindestrichzeile und HTML-only Provider-Payload. - Mailjets aktuelle Accessibility-Empfehlung verlangt die passende Dokumentsprache und eine lesbare Reintext-Version. - Der optionale de/en-Chrome-Vertrag gilt für alle React-Templates; der Web-Wrapper liefert HTML und Text gemeinsam an Queue beziehungsweise Outbox. - Signup-Welcome, Passwort-Reset und Standard-Mitgliedseinladung erhalten den Plaintext-Payload. Der bestehende Mailjet-Adapter setzt ihn als `TextPart`. - Proof: `@hivegrid/mail` 99/99 grün, fokussierte Web-Slices 65/65 grün, Mail- und Web-Typecheck grün. Screenshot `60-final-welcome-mail-localized-plaintext.png`. - PR `#336`: vollständige CI `11701` mit 11/11 Jobs grün; normaler Merge `ab18351309c8e1fcbe21ffc262b5ddb23c822341`. - Staging-Deploy `11702` grün. Öffentliche Healthchecks von Web, Admin und API melden jeweils exakt Revision `ab18351309c8e1fcbe21ffc262b5ddb23c822341`. **MAIL-02: 6/6 DoD = 100 % done. 0 Punkte offen.**