Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
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.
|
||||
Reference in new issue
Block a user