Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
@@ -0,0 +1,100 @@
|
||||
# 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.**
|
||||
Reference in new issue
Block a user