5.1 KiB
5.1 KiB
AK-P14b · P14 Email-Marketing (Kampagnen + A/B)
| Typ | Dev (Code) |
| Owner | Akeshan |
| Phase | P14 — Email & Marketing |
| Cycle/Fenster | W3 — Kern-Kette & Kommunikation (Demo 2) · fällig 2026-06-29 · Gate W3 |
| Status | geplant |
Abhängigkeiten & Parallelität
- Blocked by:
AK-P14a(verifizierte Sende-Domain + Tracking-Infra + Suppression) - Blocks: — (Endpunkt der Email-Schiene)
- Läuft parallel zu: Raffaels Kern-Kette. Eigene
prisma/schema/email.prisma(gleicher Namespace wie AK-P14a, additive Tabellen — AD-21); Segmente lesen CRM-Kontakte read-only (R-P6). Sync-Punkt: R-P6 (Kontakt/Tag/Custom-Feld) muss stehen, damit Segment-Filter auflösen. - Konflikt-Risiko: keines auf Schema-Ebene; CRM nur lesend.
Was wir bauen
Das vollständige DSGVO-konforme Email-Marketing (bleibt VOLL inkl. A/B): ein mehrstufiger Kampagnen-Builder (Basis → Inhalt mit Rich-Text/HTML-Toggle + Personalisierungs-Tokens inkl. Custom-Felder + Pflicht-Footer-Auto-Injektion + Desktop-/Mobile-Vorschau → Empfänger → Test-Versand → Zeitpunkt → Bestätigung mit Klartext-Checkliste), Segmente mit verschachteltem AND/OR-Filter-Baum und Auto-Exclusion, Double-Opt-In, One-Click-Unsubscribe + List-Unsubscribe-Header, eine BullMQ-Versand-Engine mit Rate-Limiting/Throttling/geplantem (timezone-aware) Versand, Reporting (Open/Click/Bounce/Abmeldung, Klick-Map) und A/B-Varianten. Versand wird bei rotem Pflicht-Check (Domain/Unsubscribe/Impressum) blockiert.
Benötigte Screens (Backend bedient — Design liefert D-KAMP + D-P14)
| Screen [Route] | Kern-Inhalt |
|---|---|
Kampagnen-Editor [/email-marketing/campaigns/new] |
Mehrstufiger Wizard (Basis/Inhalt/Empfänger/Test/Zeitpunkt/Bestätigung), Token-Einfügen, Pflicht-Footer, Vorschau, Pflicht-Checkliste mit Versand-Blockade — BESPOKE |
Kampagnen-Liste + -Detail [/email-marketing/campaigns] |
Liste (Status/Empfänger/Datum/Stats); Detail mit KPI-Header, Klick-Map, Pro-Empfänger-Tabelle, A/B-Vergleich |
Segmente [/email-marketing/segments] |
Verschachtelter AND/OR-Filter-Baum, Live-Empfänger-Anzahl, Auto-Exclusion-Aufschlüsselung, Sample-Vorschau, dynamisch/statischer Snapshot |
Templates [/email-marketing/templates] |
Template-Liste, Vorschau, als Ausgangspunkt verwenden |
🌐 Unsubscribe-Page [/unsubscribe/{token}] |
Bestätigungs-Button, optionale Grund-Auswahl, Erfolgs-Meldung, Tenant-Branding |
Definition of Done
- Block-/Rich-Text-Editor + Personalisierungs-Tokens (auch Custom-Felder) + Pflicht-Footer-Auto-Injektion + Desktop-/Mobile-Vorschau
- Segmente: verschachtelter AND/OR-Filter-Baum, Live-Auflösung, Auto-Exclusion (Unsubscribe/Suppression/kein Opt-In/archiviert/keine Email), dynamisch vs. statischer Snapshot
- Versand-Engine (BullMQ, Rate-Limit, Throttling, geplanter timezone-aware Versand)
- Double-Opt-In (aus Form-Submissions) + Suppression-Check vor jedem Versand + One-Click-Unsubscribe + List-Unsubscribe-Header
- Pflicht-Checkliste vor Versand (Domain verifiziert / Unsubscribe / Impressum / Subject / >0 Empfänger / Daily-Cap) — Block + Fix-Link bei rotem Check
- Reporting (Open/Click/Bounce/Abmeldung in %, Klick-Map, Pro-Empfänger) + A/B-Varianten
- Konnektor
tenantHasModule('email'); RLS auf allen Tenant-Tabellen;is_demo_dataauf Demo-Kampagnen/-Segmenten/-Templates
Technische Bausteine
- Entities (eigene
prisma/schema/email.prisma):Campaign(subject, template_id, sender_id, recipient_segment_id, status, delivered/opened/clicked_count),OutboundEmail(campaign_id, recipient_kontakt_id, tracking_token, unsubscribe_token, delivery_status),OutboundEmailOpen/Click,RecipientSegment(entity_type, filter_definition JSONB, is_static_snapshot),Unsubscribe(kontakt_id, scope, reason).crm.prismanur lesend (Kontakt/Tag/CustomFieldValue). - Versand über BullMQ mit Provider-Abstraktion (Mailjet, AD-6), Rate-Limit-Worker, timezone-aware Scheduling.
- Segment-Engine: JSONB-Filter → typsicherer Query-Builder gegen CRM (read-only), Auto-Exclusion gegen
Unsubscribe/EmailSuppressionListaus AK-P14a. - RLS überall; Tracking mit IP-Anonymisierung.
- Konnektor
tenantHasModule('email');is_demo_dataauf seedbaren Demo-Daten.
Quellen (granular)
ENTITY-MODEL.md→ Domäne 8: Kommunikation (Campaign, OutboundEmail +Open/Click, RecipientSegment, Unsubscribe)REQUIREMENTS.md→REQ-marketing-datenmodell,REQ-marketing-double-optin,REQ-marketing-versandROADMAP.md→ Phase 14 ·PHASE-SOURCES.md→ Phase 14 (M100-editor, M101-segmente, M102-versand-engine, M103-ab-tests-reporting, M104-unsubscribe-bounces — Marketing bleibt VOLL inkl. A/B)designer-briefs/P14-email-marketing.md(Kampagnen-Editor BESPOKE, Segmente, Unsubscribe-Page)_bmad-output/specs/M10-email-marketing.md
Dev-Nachzug (nach Davids D-KAMP/D-P14-Delta)
- Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- REQUIREMENTS/PHASE-SOURCES nachgezogen
- Plane-Ticket
AK-P14baktualisiert