Refresh HiveGrid Cloud reference snapshot

This commit is contained in:
david committed 2026-08-03 15:31:14 +02:00
1 parent 5e99e14772
commit 7f88026f79
5955 files changed
+1177325 -188362

No files matched your search

@@ -0,0 +1,112 @@
# 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.