6.0 KiB
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-P13entfä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:
→ entfällt (AD-26: R-P13 gelöscht); R-P12b ist letztes v1-Glied.R-P13(KI-Layer / Sprach-zu-Automation-Gateway) - Sequenz (Raffaels Kern-Kette): sequenziell (
R-P12a → R-P12b)— R-P12b ist das Ketten-Ende (AD-26).→ R-P13 - 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 |
| 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 persistiertflow_dataJSON +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) →→ entfällt (AD-26: kein KI-Gateway/GeneratedObject).GeneratedObjectFlow-Vorschlag → Canvas-Render; kein Auto-Aktivieren.- 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) —GeneratedObjectentfä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→ P12designer-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-P12baktualisiert