# 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.