101 lines
5.0 KiB
Markdown
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.**
|