Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/MAIL-02.md
T

101 lines
5.0 KiB
Markdown

# 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.**