Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/AK-P14a.md
T

4.9 KiB

AK-P14a · P14 Sende-Domain-Verifikation + BCC-Brücke + Tracking

Typ Dev (Code)
Owner Akeshan
Phase P14 — Email & Marketing
Cycle/Fenster W3 — Kern-Kette & Kommunikation (Demo 2) · fällig 2026-06-28 · Gate W3
Status geplant

Abhängigkeiten & Parallelität

  • Blocked by: EXT-02 (Mailjet Sende-Domain SPF/DKIM/DMARC + Warm-up), R-P6 (CRM-Kern — Mails/Activity hängen am Kontakt)
  • Blocks: AK-P14b (Marketing setzt verifizierte Domain + Tracking-Infra voraus)
  • Läuft parallel zu: Raffaels Kern-Kette (P7/P8 Lead/Projekt). Schema-isoliert über eigene prisma/schema/email.prisma (AD-21); berührt crm.prisma nur für die related_kontakt/projekt_id-Relation und schreibt in den Activity-Stream (R-P6). Sync-Punkt: R-P6 (Activity am Kontakt) muss stehen, bevor BCC-Logging andocken kann.
  • Konflikt-Risiko: gering — additive Tabellen + polymorpher Activity-Write; keine Änderung am CRM-Schema.

Was wir bauen

Das v1-Fundament der Email-Welt (Postfach-Sync ist v2 → P23): pro Mandant eine eigene Sende-Domain mit DKIM/SPF/DMARC-Records, Copy-Buttons, 5-Min-Auto-Probe und Status-Ampel (pending/verifying/verified/failed) inkl. Klartext-Fehler nach 7 Tagen. Dazu die BCC-Logging-Brücke (crm@<tenant>… als BCC → in Gmail/Outlook geschriebene Mails erscheinen als Activity am Kontakt, kein OAuth), eine Tenant-Inbound-Adresse (eingehende Mails → Lead/Activity) und das Email-Tracking (Delivery-Status, Open/Click, Bounce-Handling mit Suppression-Eintrag). Versand läuft über Mailjet (AD-6, SMTP-Provider-Abstraktion ohne US-Kern-Abhängigkeit). Ohne verifizierte Domain kein Marketing-Versand (Gate für AK-P14b).

Benötigte Screens (Backend bedient — Design liefert D-KAMP + D-P14)

Screen [Route] Kern-Inhalt
Sende-Domain [/settings/integrations/email] Domain-Eingabe, DNS-Record-Karten (DKIM/SPF/DMARC) mit Copy, Status-Ampel + 5-Min-Prüf-Indikator + 7-Tage-Klartext-Fehler, BCC-Logging-Toggle + angezeigte BCC-Adresse + Klartext „Mails erscheinen am Kontakt"
Sender + Suppression [/email-marketing/senders] Sender (From-Name/-Email, Domain-DKIM-Status, Default-Marker) · Suppression-Liste (Adresse, Grund Bounce/Beschwerde/manuell)

Definition of Done

  • Sende-Domain pro Mandant: DKIM/SPF/DMARC-Records mit Copy, 5-Min-Auto-Probe, Status-Ampel, Klartext-Fehler nach 7 Tagen
  • BCC-Logging-Brücke: Toggle + Anzeige der BCC-Adresse; in nativen Clients geschriebene Mails → Activity am Kontakt (kein OAuth)
  • Tenant-Inbound-Adresse: eingehende Mails → Lead/Activity
  • Email-Tracking + Delivery-Status + Open/Click (IP anonymisiert) + Bounce-Handling → Suppression-Eintrag
  • SMTP-Provider-Abstraktion (Mailjet, AD-6) ohne US-Kern-Abhängigkeit
  • Konnektor tenantHasModule('email') (Sidebar + Routes + Actions gated)
  • RLS auf allen Tenant-Tabellen; is_demo_data auf seedbaren Sendern/Templates

Technische Bausteine

  • Entities (eigene prisma/schema/email.prisma): TenantSendingDomain (DKIM/SPF/DMARC-Records, verification_status — [verschlüsselt][Soft-Delete]), TenantInboundAddress (local_part, purpose lead_inbox/bcc_logging/reply_routing), Email (purpose, from_sender_id, delivery_status, related_kontakt/projekt_id), EmailSender/EmailTemplate (is_default), EmailSuppressionList (email_address unique, reason). crm.prisma nur für related_kontakt/projekt_id-Relation berühren (AD-21).
  • Activity-Write: BCC-Logging + Inbound erzeugen Activity (polymorph subject_type/id, actor_kind=system) im Stream aus R-P6.
  • RLS auf allen Tabellen außer keine; OAuth/Provider-Credentials über per-Tenant-DEK verschlüsselt (AD-8).
  • Auto-Probe als BullMQ-Scheduled-Job (DNS-Lookup DKIM/SPF/DMARC), Status-Übergänge in Klartext.
  • Inbound-/Bounce-Webhooks (Mailjet) → Signatur-Check → Lead/Activity bzw. Suppression.
  • Konnektor tenantHasModule('email'); is_demo_data auf Demo-Sendern/-Templates.

Quellen (granular)

  • ENTITY-MODEL.md → Domäne 8: Kommunikation (TenantSendingDomain, TenantInboundAddress, Email, EmailSender/Template, EmailSuppressionList)
  • REQUIREMENTS.md → REQ-email-datenmodell (v1-Teil: Sende-Domain + Inbound), REQ-marketing-versand (SMTP-Abstraktion Mailjet) · v2-Cut: REQ-email-sync-strategie/REQ-email-inbox-view
  • ROADMAP.md → Phase 14 · PHASE-SOURCES.md → Phase 14 (M099-email-tracking-bounces; Sende-Domain aus M096 herausgelöst, v1-Pflicht; BCC-Brücke neu)
  • designer-briefs/P14-email-marketing.md (Sende-Domain-Card, BCC-Toggle, Suppression)
  • _bmad-output/specs/M09-email-inbox.md (nur Sende-Domain/Inbound/BCC — Rest v2)

Dev-Nachzug (nach Davids D-KAMP/D-P14-Delta)

  • Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
  • REQUIREMENTS/PHASE-SOURCES nachgezogen
  • Plane-Ticket AK-P14a aktualisiert