6.7 KiB
Designer-Brief · P14 — Email & Marketing
Phase: 14/21 · Module: M09 (Email-Brücke) / M10 (Marketing) · Owner-Dev: Akeshan (AK-P14a/b) · Designer: David (D-Marketing, Kampagnen-Editor Paket Fr 26.06., Sende-Domain Paket Mo 06.07.)
Quellen: ROADMAP.md §Phase 14 · ENTITY-MODEL.md Domäne 8 (Kommunikation) · SCREEN-MAP.md §3 (Kampagnen-Editor) + §6 (Sende-Domain) · _bmad-output/specs/M09-email-inbox.md (nur Sende-Domain/Inbound/BCC) · _bmad-output/specs/M10-email-marketing.md
Subframe: Pflicht je Route. Archetypen aus D0 (A2 Liste, A3 Detail, A6 Settings, A4 Public). Kampagnen-Editor + Unsubscribe-Page sind Bespoke.
🟡 v1-Grenze (Scope-Schnitt 11.06.): Postfach-Sync ist v2 (→ P23) — kein OAuth-Mailbox-Connect, keine Inbox-View, keine Compose-Oberfläche, kein Thread-View in v1. Aus M09 bleiben in v1 nur: Sende-Domain-Verifikation (DKIM/SPF/DMARC), Tenant-Inbound-Adresse (Lead-Eingang) und die BCC-Logging-Brücke. Mails (Automation/Marketing/transaktional) erscheinen im Activity-Stream am Kontakt (P6). 🔴 DSGVO-First: Double-Opt-In, Suppression-Check vor jedem Versand, One-Click-Unsubscribe, Pflicht-Footer (Impressum + Unsubscribe), Pflicht-Checkliste vor Versand — Versand wird bei rotem Check blockiert.
Was dieses Modul tut (Kurzfassung)
Der Betrieb verifiziert pro Mandant eine eigene Sende-Domain und versendet von dort transaktionale, Automation- und Marketing-Mails über Mailjet (AD-6) — ohne US-Kern-Abhängigkeit. Eingehende Mails an die Tenant-Inbound-Adresse erzeugen Leads/Aktivitäten; die BCC-Logging-Brücke protokolliert in Gmail/Outlook geschriebene Mails am Kontakt (kein OAuth). Marketing-Kampagnen versenden DSGVO-konform über einen mehrstufigen Builder mit Segmenten, Auto-Exclusion, Test-Versand, Tracking (Open/Click) und Bounce-Handling.
Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
Sende-Domain [/settings/integrations/email] |
Domain-Eingabe · DNS-Records (DKIM/SPF/DMARC) mit Copy-Button · Verifikations-Status-Ampel (pending/verifying/verified/failed) · 5-Min-Prüf-Indikator + Klartext bei 7-Tage-Fehlschlag · BCC-Logging-Toggle + angezeigte BCC-Adresse + Klartext „Mails erscheinen am Kontakt" | A6 |
Kampagnen-Editor [/email-marketing/campaigns/new] |
Mehrstufiger Wizard: Basis (Name/Sender/Subject/Preheader) → Inhalt (Rich-Text + HTML-Toggle, Personalisierungs-Tokens, Bild-Upload, Pflicht-Footer Impressum+Unsubscribe, Desktop-/Mobile-Vorschau) → Empfänger (Segment-Wahl/ad-hoc-Filter, Vorschau mit Ausschluss-Aufschlüsselung Abgemeldet/Bounce/Suppression) → Test-Versand (max. 5 Adressen, Sample-Tokens) → Zeitpunkt (sofort/geplant/Entwurf) → Bestätigung mit Klartext-Checkliste (Domain verifiziert? Unsubscribe? Impressum?) — Versand bei rotem Check blockiert | BESPOKE |
Kampagnen-Liste + -Detail [/email-marketing/campaigns] |
Liste: Name, Status, Empfänger, Versanddatum, Stats · Detail: KPI-Header (Zugestellt/Geöffnet/Geklickt/Bounces/Abmeldungen in %) · Klick-Map (URLs + Counts) · Pro-Empfänger-Tabelle · (A/B-Vergleich falls vorhanden) | A2/A3 + KPI |
Segmente [/email-marketing/segments] |
Filter-Baum lesbar (verschachtelte AND/OR), Tags/Custom-Felder/Verantwortlicher/Datum/aktiver-Deal/Sprache · Live-Empfänger-Anzahl · Auto-Exclusion-Aufschlüsselung · Sample-Vorschau (max. 50) · dynamisch/statischer Snapshot | A2 + Filter-Builder |
Sender + Suppression [/email-marketing/senders] |
Sender: From-Name/-Email, Domain-DKIM-Status, Default-Marker · Suppression-Liste: Adresse, Grund (Bounce/Beschwerde/manuell) | A2/A6 |
Templates [/email-marketing/templates] |
Template-Liste, Vorschau, als Ausgangspunkt verwenden | A2 |
🌐 Unsubscribe-Page [/unsubscribe/{token}] |
Klartext, Bestätigungs-Button, optionale Grund-Auswahl, Erfolgs-Meldung · Tenant-Branding | A4-Public / Bespoke-Public |
(Inbox-Liste, Mail-Detail, Compose, Mailbox-Connect-OAuth → v2/P23.)
Geplante Features (muss abgedeckt sein)
- Sende-Domain pro Mandant: DKIM/SPF/DMARC-Records mit Copy, 5-Min-Auto-Probe, Status-Ampel, Klartext-Fehler nach 7 Tagen; ohne verifizierte Domain kein Marketing-Versand
- BCC-Logging-Brücke: Toggle + Anzeige der BCC-Adresse; in nativen Clients geschriebene Mails erzeugen Activity am Kontakt (kein OAuth)
- Tenant-Inbound-Adresse: eingehende Mails → Lead/Aktivität
- Kampagnen-Builder 6-stufig mit Personalisierungs-Tokens (auch Custom-Felder), Pflicht-Footer-Auto-Injektion, Desktop-/Mobile-Vorschau
- Pflicht-Validierungen vor Versand (verifizierte Domain, Unsubscribe-Link, Impressum, Subject, >0 Empfänger, Daily-Cap) — Block + Fix-Link bei rotem Check
- Segmente: verschachtelter AND/OR-Filter-Baum, Live-Auflösung, Auto-Exclusion (Unsubscribe/Suppression/kein Opt-In/archiviert/keine Email), dynamisch vs. statischer Snapshot
- Double-Opt-In-Workflow (Form-Submissions), One-Click-Unsubscribe + List-Unsubscribe-Header, Opt-In-Dokumentation je Kontakt
- Versand über BullMQ mit Rate-Limiting, geplanter Versand (timezone-aware), Throttling
- Open-/Click-Tracking (IP anonymisiert), Klick-Map, Stats-Aggregation; Bounce-Handling mit Suppression-Eintrag
- SMTP-Provider-Abstraktion (Mailjet, AD-6) ohne US-Kern-Abhängigkeit
- Datenmodell persistiert: TenantSendingDomain, TenantInboundAddress, Email, Campaign, OutboundEmail (+Open/Click), EmailTemplate/Sender, RecipientSegment, Unsubscribe, EmailSuppressionList (Domäne 8)
Benötigte UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
DNS-Record-Karten mit Copy-Button, Status-Ampel (Connection-Card-Stil), Toggle-Zeile mit Klartext (BCC), mehrstufiger Wizard mit Progress, Rich-Text-/HTML-Editor mit Token-Einfügen, Bild-Dropzone, Desktop-/Mobile-Vorschau-Umschalter, Pflicht-Footer-Hinweis, Segment-Picker, verschachtelter AND/OR-Filter-Builder, Empfänger-Vorschau-Liste mit Auto-Exclusion-Aufschlüsselung, Test-Versand-Eingabe (max. 5), Date-Time-Picker (timezone-aware), Pflicht-Checkliste mit grün/rot-Status + Fix-Links, Versand-Blockade-Hinweis, KPI-Kacheln + Prozent-Anzeigen, Klick-Map-Tabelle, Pro-Empfänger-Tabelle, Suppression-Liste mit Grund-Badge, öffentliche Unsubscribe-Bestätigung mit Branding, Daten-Tabelle (sortierbar/paginiert), Empty-/Loading-/Permission-Denied-States (Klartext).
Davids Delta (David füllt aus)
- Überschriebene/geänderte Spec-Punkte:
- Neue UI/UX-Entscheidungen:
- Subframe-Screen-Link(s):
- Offene Fragen an Dev:
Dev-Nachzug (wir nach Davids Delta)
- Spec/ENTITY-MODEL an Davids Entscheidungen angepasst:
- REQUIREMENTS/PHASE-SOURCES nachgezogen:
- Plane-Ticket (AK-P14a/b) aktualisiert: