Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/VA-P28e.md
T

5.5 KiB

VA-P28e · Admin Outbound-Sequenzen & Automation

Plane HIVEGRID-193 · Parent HIVEGRID-190
Typ Dev (Code)
Owner Raffael
Phase P28 — Admin Sales Workspace
Cycle/Fenster Backlog · nach CRM und E-Mail
Status geplant

Owner-Änderung 2026-07-24: Raffael übernimmt die Delivery. Working-ID, Scope, Status, Termine, DoD und Abhängigkeiten bleiben unverändert.

Dependency-Nachzug 2026-07-24: Auch VA-P28b liegt jetzt bei Raffael; CRM-, Mail-, Call- und Booking-Verträge sowie blocked-by/blocks bleiben unverändert.

Abhängigkeiten & Parallelität

  • Blocked by: VA-P28b und VA-P28c; für vollständig produktive Call-Schritte VA-P28d, für Booking-Stop-Events VA-P28f.
  • Blocks: VA-P28h und VA-P28i.
  • Design: VD-P28, nach AD-28 kein Dev-Blocker.
  • Hardgrenze: Admin-Events und Admin-Kontakte; kein Tenant-Workflow und keine Tenant-Sequenz.

Was wir bauen

Eine versionierte Multi-Touch-Sequenz-Engine sowie eine allgemeine allowlist-basierte Wenn-dann-Automation für den internen HiveGrid-Vertrieb. Beide verwenden denselben Admin-Event-/Job-Vertrag, aber getrennte fachliche Modelle und Abnahmeoberflächen.

Story-Ownership — 13/117

Outbound-Sequenzen

  • SEQ-01 Mehrstufige Sequenz bauen.
  • SEQ-02 Mail, Wartezeit, Anruf-Aufgabe und LinkedIn-Aufgabe mischen.
  • SEQ-03 Kontakte in eine Sequenz aufnehmen.
  • SEQ-04 Sequenz bei Antwort automatisch stoppen.
  • SEQ-05 Sequenz bei Terminbuchung automatisch stoppen.
  • SEQ-06 Betreffzeilen A/B-testen.
  • SEQ-07 Öffnungen, Antworten und Abschlüsse je Schritt auswerten.
  • SEQ-08 Tägliches Sende-Limit setzen.

Automation

  • AUTO-01 Wenn-dann-Abläufe bauen.
  • AUTO-02 Bei Stufenwechsel automatisch eine Folgeaufgabe erzeugen.
  • AUTO-03 Leads automatisch zuweisen.
  • AUTO-04 Bei wichtigen Ereignissen benachrichtigen.
  • AUTO-05 Bei einem Trigger automatisch eine Mail senden.

Benötigte Screens

Screen [Admin-Host-Route] Kern-Inhalt
Sequenzen [/sales/sequences] Liste, Status, Enrollment und Performance
Sequenzeditor [/sales/sequences/:id] Schritte, Varianten, Limits, Publish
Analytics [/sales/sequences/:id/analytics] Send/Delivery/Open/Reply/Conversion je Schritt
Automationen [/sales/automations] Liste, Status, letzte Runs
Automation-Editor [/sales/automations/:id] Trigger, Bedingungen, Actions, Publish/Test
Kontakt-/Listen-Aktion Enrollment-Vorschau, Ausschlüsse und Start

Definition of Done

  • Sequenzen unterstützen E-Mail, Wait, Call-Task und LinkedIn-Task; Draft/Published-Versionen sind getrennt, veröffentlichte Versionen unveränderlich und laufende Enrollments versionsstabil.
  • Enrollment aus Kontakt/Listen ist idempotent, besitzt Vorschau/Ausschlüsse und verhindert unzulässige parallele Doppelansprachen.
  • Reply- und Booking-Events stoppen Enrollments atomar vor dem nächsten Schritt; verspätete Event-Replays erzeugen keinen weiteren Send.
  • A/B-Betreffzuordnung ist stabil; Analytics trennt Send, Delivery, Open, Click, Reply und Deal-Conversion.
  • Sende-Limits gelten pro Mailbox und Domain und berücksichtigen Zeitzone, Ruhezeit, Bounces und Backpressure.
  • Automation bietet typisierte Admin-Trigger/-Actions für Stage-Task, Lead-Assignment, Notification und Auto-Mail; keine freie Codeausführung oder freie HTTP-/DB-Aktion.
  • Lead-Assignment delegiert an VA-P28b, Mail an VA-P28c, Calls an VA-P28d, Booking an VA-P28f und Notification an den Plattformvertrag; keine zweite Fachlogik.
  • Runs sind idempotent, beobachtbar, retrybar und mit Version, Input-/Output-Referenzen und Klartextfehlern nachvollziehbar; sensible Payloads werden minimiert.
  • Admin-RBAC, Audit/Activity, i18n, VM-/Action-Layer, Smoke, Hot-Swap, Visual sowie Unit-/DB-/Worker- und Failure-Injection-Tests sind grün.

Fortschritt: 0/9 DoD = 0 % done.

Technische Bausteine

  • Schema: prisma/schema/adminSequences.prisma, prisma/schema/adminAutomations.prisma.
  • Modelle: AdminSequence, AdminSequenceVersion, AdminSequenceStep, AdminSequenceEnrollment, AdminSequenceStepRun, AdminSequenceExperiment, AdminSendBudget, AdminAutomation, AdminAutomationVersion, AdminAutomationTrigger, AdminAutomationAction, AdminAutomationRun, AdminAutomationRunStep.
  • Event-Registry: typisierte Admin-Events, explizite Payload-Schemas und producerseitige Outbox.
  • Wiederverwendung: Editor-/Queue-/Idempotenzbausteine bestehender Tenant-Automation dürfen extrahiert werden; gespeicherte Tenant-Workflows oder Tenant-Trigger sind kein Admin-Scope.
  • Legacy: globale EmailSequence-Daten einmalig migrieren oder archivieren; Raw-Routen danach entfernen.

Slices und Rollback

Event-/Job-Vertrag → Sequenzeditor/Versionen → Enrollment/Stop → Limits/Experimente/Analytics → Automation-Editor/Runtime. Publish/Enrollment und Automation-Runtime sind separat abschaltbar; Rollback pausiert neue Runs, lässt bestehende Historie unverändert und verhindert weitere Sends.

Quellen

  • .planning/ticket-docs/VA-P28b.md, VA-P28c.md, VA-P28d.md, VA-P28f.md, VD-P28.md
  • AGENTS.md — Automation-Querschnitt, Idempotenz, Notification, AD-21/AD-28

Dev-Nachzug

  • Sendebudget-/Ruhezeit-/DNC-Regeln in der Block-Review bestätigen.
  • Legacy-Retain/Migration dependency-aware in AK-UI-20 dokumentieren.
  • Davids VD-P28-Delta integrieren und Visual-Baselines erneuern.