# 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