58 lines
6.5 KiB
Markdown
58 lines
6.5 KiB
Markdown
# 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.)
|
|
**Aktive Quellen:** zugehörige Ticket-Docs · `ROADMAP.md`/`ROADMAP-V2.md` · `REQUIREMENTS.md` · `ENTITY-MODEL.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/ROADMAP nachgezogen:
|
|
- [ ] Plane-Ticket (AK-P14a/b) aktualisiert:
|