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

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-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

  • Transaktionale Templates erhalten eine normalisierte de-/en-Sprache und setzen das passende lang-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-TextPart unverä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.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.