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-P28bliegt jetzt bei Raffael; CRM-, Mail-, Call- und Booking-Verträge sowieblocked-by/blocksbleiben unverändert.
Abhängigkeiten & Parallelität
- Blocked by:
VA-P28bundVA-P28c; für vollständig produktive Call-SchritteVA-P28d, für Booking-Stop-EventsVA-P28f. - Blocks:
VA-P28hundVA-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-01Mehrstufige Sequenz bauen.SEQ-02Mail, Wartezeit, Anruf-Aufgabe und LinkedIn-Aufgabe mischen.SEQ-03Kontakte in eine Sequenz aufnehmen.SEQ-04Sequenz bei Antwort automatisch stoppen.SEQ-05Sequenz bei Terminbuchung automatisch stoppen.SEQ-06Betreffzeilen A/B-testen.SEQ-07Öffnungen, Antworten und Abschlüsse je Schritt auswerten.SEQ-08Tägliches Sende-Limit setzen.
Automation
AUTO-01Wenn-dann-Abläufe bauen.AUTO-02Bei Stufenwechsel automatisch eine Folgeaufgabe erzeugen.AUTO-03Leads automatisch zuweisen.AUTO-04Bei wichtigen Ereignissen benachrichtigen.AUTO-05Bei 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 anVA-P28c, Calls anVA-P28d, Booking anVA-P28fund 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-20dokumentieren. - Davids
VD-P28-Delta integrieren und Visual-Baselines erneuern.