Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/R-P12b.md
T

62 lines
6.0 KiB
Markdown

# R-P12b · P12 Visueller Flow-Editor + Dry-Run + 24h-Undo ~~+ Sprach-Andock~~
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Der „Sprach-zu-Automation"-/KI-Andock **entfällt** (kein LLM in v1 — HiveGrid wird MCP-Server, [[VR-MCP]]). R-P12b ist ein **reiner visueller Flow-Editor** (Graph + Dry-Run + 24h-Undo + Templates). Das `blocks: R-P13` entfällt (R-P13 gelöscht) → R-P12b ist das **neue letzte v1-Glied** der Kern-Kette. Alle Sprach-/KI-Stellen unten sind durchgestrichen.
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Raffael |
| **Phase** | P12 — Automation-Engine (USP-Säule 1) |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · 2026-07-07 → 2026-07-08 · Gate W4 |
| **Status** | geplant |
> 🔴 **Schwerste UI der App (AD-16, ab 22.06. täglich 1h).** Der visuelle Flow-/Node-Editor ist die erste USP-Säule und vollständig **bespoke**. Klartext-First überall (Knoten-Labels, Dry-Run-Ausgaben, Loop-/Rate-Warnungen, Logs in verständlichem Deutsch). ~~🟡 Sprach-zu-Automation rendert hier den Flow-Vorschlag — die KI-Pipeline selbst liegt in P13 (R-P13 liefert das Gateway dahinter).~~ → **entfällt ([[AD-26]]).**
## Abhängigkeiten & Parallelität
- **Blocked by:** `R-P12a` (Engine + Trigger/Action-Registry + Guards), `D-FLOW` (Flow-Editor-Design)
- **Blocks:** ~~`R-P13` (KI-Layer / Sprach-zu-Automation-Gateway)~~ → **entfällt ([[AD-26]]: R-P13 gelöscht); R-P12b ist letztes v1-Glied.**
- **Sequenz (Raffaels Kern-Kette):** sequenziell (`R-P12a → R-P12b`) ~~`→ R-P13`~~ — **R-P12b ist das Ketten-Ende ([[AD-26]]).**
- **Läuft parallel zu:** Akeshans Module W4. Schema-Trennung nach **AD-21**.
## Was wir bauen
Den **visuellen Graph-/Node-Editor** über der Engine aus P12a: Knoten aus Trigger/Action-Library hinzufügen/konfigurieren/löschen/duplizieren, Kanten, Auto-Layout, Undo/Redo, Mini-Map, Klartext-Validation. Dazu **Dry-Run** (Klartext-Wirkungsvorschau + Pflicht-Bestätigung ab Schwelle) und **24h-Reverse-Window**. ~~und den **Sprach-zu-Automation-Andock** (Satz → Flow-Vorschlag, **nie Auto-Aktivierung**)~~ → **Sprach-Andock entfällt ([[AD-26]]).**
## Benötigte Screens (Backend bedient — Design liefert `D-FLOW` + `D-P12`, Editor BESPOKE)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Flow-/Node-Editor [`/automations/:id/edit`] | Graph-Canvas (Knoten + Kanten); Knoten-Katalog-Sidebar (filterbar nach Modul-Quelle, Drag/Klick); Knoten-Konfig-Panel mit **Klartext-Label**; Mini-Map; Toolbar (Zoom/Pan/Undo/Redo/Zentrieren/Auto-Layout); inline Validation (unverbunden/Cycle/fehlendes Pflichtfeld); Save/Aktivieren/Deaktivieren; **Dry-Run-Auslöser** |
| ~~Sprach-zu-Automation-Einstieg [im Editor]~~ → **entfällt ([[AD-26]])** | ~~Text-/Spracheingabe; Live-Streaming-Antwort; KI-Flow-Vorschau im Canvas + Klartext-Beschreibung; Rückfragen bei Mehrdeutigkeit; Risiko-Hinweise; Bestätigungs-/Anpassungs-Schritt (nie Auto-Aktivierung!); Beispiel-Prompts~~ |
| Dry-Run-Vorschau [Modal im Editor] | „Trifft X Datensätze" + erste 5 Beispiele; Schritt-für-Schritt-Simulation Klartext je Step; **Bestätigungs-Pflicht** ab >100 Datensätzen/Schritt (Schwelle tenant-konfigurierbar) |
| Template-Katalog [`/automations/templates`] | SHK- + Tenant-Vorlagen nach Kategorie; je Template Beschreibung/Use-Case/Nutzungs-Anzahl; „Verwenden" + „Eigenes Template aus Rule anlegen" |
## Definition of Done
- [ ] **Graph-Editor** aus Trigger/Action-Library: Knoten hinzufügen/konfigurieren/löschen/duplizieren, Kanten erstellen/löschen, verschieben, **Auto-Layout, Undo/Redo, Mini-Map**
- [ ] **Klartext-Knoten-Labels** + Klartext-Validation (unverbunden, Cycle, unvollständig)
- [ ] **Dry-Run-Vorschau** (Klartext-Wirkungsvorschau, getroffene Datensätze + Beispiele) + **Bestätigungs-Pflicht ab Schwelle**
- [ ] **24h-Undo-Fenster:** angelegte Entitäten löschen / Status zurücksetzen / Tags rückgängig, Mail-Empfängerliste anzeigen (nicht zurückziehbar), Multi-Step-Confirm + Audit
- [ ] ~~**Sprach-zu-Automation-Andock:** Satz → Flow-Vorschlag mit Rückfragen/Existenz-Prüfung/Risiko-Hinweisen, **Bestätigungs-Pflicht (Action-Boundary, nie Auto-Aktivierung)** — KI-Pipeline = R-P13~~ → **entfällt ([[AD-26]]: kein LLM in v1)**
- [ ] Template-Katalog mit „aus Rule erstellen"
- [ ] Konnektor `tenantHasModule('automation')` (Editor/Routes gated)
## Technische Bausteine
- **Erweitert `prisma/schema/automation.prisma`** (keine neuen Kern-Entities — Editor persistiert `flow_data` JSON + `AutomationRuleStep`-Graph aus R-P12a; Template-CRUD).
- **Graph-Persistenz:** Flow als JSON-Graph (`AutomationRule.flow_data`) + normalisierte Steps; serverseitige Cycle-/Vollständigkeits-Validation gespiegelt zur Client-Validation.
- **Dry-Run:** Simulations-Lauf ohne Seiteneffekte; Schwelle (>100/Schritt, tenant-konfigurierbar) → Confirm-Phrase.
- **24h-Reverse-Window:** `AutomationExecution.reverse_window_expires_at` (aus R-P12a) + Reverse-Aktionen (delete/revert/untag) mit Audit (Domäne 2).
- ~~**Sprach-Andock:** Editor ruft KI-Gateway (R-P13) → `GeneratedObject` Flow-Vorschlag → Canvas-Render; **kein Auto-Aktivieren**.~~ → **entfällt ([[AD-26]]: kein KI-Gateway/GeneratedObject).**
- **RLS** durchgängig (AD-1).
- **Konnektor** `tenantHasModule('automation')` gated.
- `is_demo_data`-Flag auf Demo-Flows/SHK-Templates.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 7: Automation** (AutomationRule.flow_data/RuleStep-Graph/Execution.reverse_window) — ~~GeneratedObject~~ entfällt ([[AD-26]])
- `REQUIREMENTS.md` → `REQ-automation-flow-editor` (Graph-Editor ~~+ KI-Sprache~~ → KI-Sprache entfällt [[AD-26]] + Dry-Run + 24h-Undo), `REQ-automation-schutz` (Phase 12)
- `ROADMAP.md` → Phase 12 · `PHASE-SOURCES.md` → P12
- `designer-briefs/P12-automation-engine.md` (Flow-Editor BESPOKE — schwerste UI; ~~Sprach-Vorschlag rendert hier, KI-Pipeline P13~~ → Sprach-Andock entfällt [[AD-26]])
- `_bmad-output/specs/M17-automation-engine.md`
## Dev-Nachzug (nach Davids `D-FLOW`/`D-P12`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `R-P12b` aktualisiert