5.0 KiB
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-01ist 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
- Transaktionale Templates erhalten eine normalisierte
de-/en-Sprache und setzen das passendelang-Attribut am HTML-Dokument. - Legal-Links, Supportzeile und optionaler Abmeldelink verwenden die vorhandenen de/en-Übersetzungen; kein englischer Footer bleibt in der deutschen Welcome-Mail.
- Der einzelne Signatur-Bindestrich entfällt, ohne Absendername oder bestehenden Signoff-Text zu verändern.
- Die bereits erzeugte Plaintext-Version wird im Template-Resultat, im
Welcome-Outbox-Payload und im Mailjet-
TextPartunverändert erhalten. - Fokus-Tests decken deutsche und englische Sprache, Footer, Plaintext, Welcome-Outbox, Replay-Stabilität und den finalen Provider-Payload ab.
- 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.tsxpackages/mail/src/templates-react/_layout/Footer.tsxpackages/mail/src/templates-react/transactional/shared.tsxapps/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-01Inbox- und Rendering-Proof, Screenshot58
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/mail99/99 grün, fokussierte Web-Slices 65/65 grün, Mail- und Web-Typecheck grün. Screenshot60-final-welcome-mail-localized-plaintext.png. - PR
#336: vollständige CI11701mit 11/11 Jobs grün; normaler Mergeab18351309c8e1fcbe21ffc262b5ddb23c822341. - Staging-Deploy
11702grün. Öffentliche Healthchecks von Web, Admin und API melden jeweils exakt Revisionab18351309c8e1fcbe21ffc262b5ddb23c822341.
MAIL-02: 6/6 DoD = 100 % done. 0 Punkte offen.