Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/designer-briefs/P14-email-marketing.md
T

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: