Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/D-FLOW.md
T

5.9 KiB

D-FLOW · Flow-/Node-Editor (Bespoke, Langläufer)

⚠️ KI→MCP-Pivot (AD-26): Der eingebettete „Sprach-zu-Automation"-/KI-Einstieg entfällt (kein LLM in v1 — HiveGrid wird MCP-Server, VR-MCP). D-FLOW ist ein reiner visueller Flow-/Node-Editor (Canvas + Dry-Run-Vorschau + Loop-/Rate-Warnmodal). Alle Sprach-/KI-Stellen unten sind durchgestrichen; die KI-Pipeline P13 (R-P13) ist gelöscht.

Typ Screen (Design)
Owner David
Phase P12 — Automation-Engine (bedient R-P12a/R-P12b)
Cycle/Fenster W3 — Kern-Kette & Kommunikation (Demo 2) · Langläufer ab 2026-06-18 → fällig 2026-07-03
Status geplant

🟦 Bespoke-Abgrenzung: Dieses Ticket deckt NUR den Flow-/Node-Editor (inkl. eingebettetem Sprach-zu-Automation-Einstieg → entfällt AD-26; Dry-Run-Vorschau und Loop-/Rate-Schutz-Warnmodal — alles Bespoke-Teile des Editors). Die übrigen P12-Screens (Automation-Liste, Execution-Detail/-Liste, Template-Katalog) sind Compose aus A2/A3 → P12-Compose-Anteil.

🔴 Schwerste UI der App (AD-16, ab 22.06. täglich 1h). Erste USP-Säule, vollständig bespoke. Klartext-First überall: Knoten-Labels, Dry-Run-Ausgaben, Loop-/Rate-Warnungen und Logs in verständlichem Deutsch. 🟡 v1-Grenze: KWP-Push-Action nur als erweiterbarer Registry-Eintrag (kein KWP-Konfig-UI in v1). Sprach-zu-Automation rendert hier den Flow-Vorschlag; die KI-Pipeline selbst liegt in P13. → entfällt (AD-26).

Abhängigkeiten & Parallelität

  • Blocked by: D-D0b (Archetypen, A5 Modal)
  • Blockt: R-P12b (der Editor ist die kritische UI, an der die Automation-Engine andockt)
  • Subframe: Pflicht je Route. Archetypen aus D0; Flow-Editor selbst ist BESPOKE — schwerste UI.

Was wir bauen

Nur den visuellen Flow-/Node-Editor: Graph-Canvas mit Knoten-Katalog, Klartext-Konfig, Mini-Map, Toolbar, Inline-Validation — plus die bespoke Editor-Teile Sprach-zu-Automation-Einstieg (entfällt AD-26), Dry-Run-Vorschau und Loop-/Rate-Schutz-Warnmodal.

Benötigte Screens

Screen [Route] Kern-Inhalt Archetyp
Flow-/Node-Editor [/automations/:id/edit] Graph-Canvas (Knoten + Kanten) · Knoten-Katalog-Sidebar (filterbar nach Modul-Quelle, Drag-&-Drop oder Klick-Hinzufügen) · Knoten-Konfig-Panel mit Klartext-Label · Mini-Map · Toolbar (Zoom/Pan/Undo/Redo/Zentrieren/Auto-Layout) · Validation-Hinweise inline (unverbundener Knoten, Cycle-Warnung, fehlendes Pflichtfeld) · Save/Aktivieren/Deaktivieren · Dry-Run-Auslöser BESPOKE — schwerste UI
Sprach-zu-Automation-Einstieg [im Editor] → entfällt (AD-26) Text-/Spracheingabe-Feld · 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 Bespoke-Teil des Editors
Dry-Run-Vorschau [Modal im Editor] „Trifft X Datensätze" + erste 5 Beispiele · Schritt-für-Schritt-Simulation mit Klartext je Step (z. B. „Email würde an … gehen") · Bestätigungs-Pflicht ab >100 Datensätzen/Schritt (Schwelle tenant-konfigurierbar) A5 + Simulations-Liste
Loop-/Rate-Schutz-Warnmodal [im Editor] Schleifen-Erkennung mit Abhängigkeits-Graph-Visualisierung + „Beheben" · Anomalie-Pause-Hinweis (Klartext: „2.000-mal in 5 Min, typisch 5-10/Tag — pausiert") A5 + Mini-Graph

(Automation-Liste, Execution-Detail/-Liste, Template-Katalog = P12-Compose. Trigger-/Action-Library = Daten im Knoten-Katalog, kein eigener Screen. KWP-Push-Konfig → v2.)

Features (muss abgedeckt sein)

  • Graph-Editor: Knoten hinzufügen/konfigurieren/löschen/duplizieren, Kanten erstellen/löschen, verschieben, Auto-Layout, Undo/Redo, Mini-Map
  • Knoten-Katalog mit voller Trigger-Library (CRM/Lead/Sales/Projekte/Email/Forms/Booking/Kalender/Zeit/Webhook) + Action-Library (CRM/Notification/HTTP/Task/If-Else/Delay/Loop; KWP-Push erweiterbar)
  • Klartext-Knoten-Labels + Klartext-Validation-Hinweise (unverbunden, Cycle, unvollständig)
  • Sprach-zu-Automation: Satz → Flow-Vorschlag mit Rückfragen, Risiko-Hinweisen, Bestätigungs-Pflicht (nie Auto-Aktivierung) → entfällt (AD-26)
  • Dry-Run mit Klartext-Wirkungsvorschau + Pflicht-Bestätigung ab Schwelle
  • Schutz: Loop-Guard (Abhängigkeits-Graph-Warnung), Rate-Limit + Anomalie-Pause

UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)

Graph-Canvas (Knoten + Kanten, Pan/Zoom); Knoten-Katalog-Panel (gruppiert/filterbar nach Modul); Knoten-Konfig-Panel (typ-abhängige Felder); Klartext-Knoten-Label-Renderer; Verbindungs-Erstell-Interaktion; Mini-Map; Editor-Toolbar (Zoom/Undo/Redo/Auto-Layout/Zentrieren); Inline-Validation-Badges/Hinweise; Sprach-/Text-Eingabefeld mit Streaming-Antwort; Beispiel-Prompt-Chips; (entfällt AD-26) Dry-Run-Vorschau-Liste (getroffene Datensätze + Beispiele); Bestätigungs-Modal (Confirm-Phrase-Variante); Abhängigkeits-Graph-Mini-Visualisierung (Loop-Guard); Status-Pills (aktiv/pausiert/Entwurf/fehlgeschlagen/übersprungen); Empty-/Loading-/Permission-Denied-States (Klartext).

Quellen (granular)

  • designer-briefs/P12-automation-engine.md → §Benötigte Screens „Flow-/Node-Editor" + „Sprach-zu-Automation-Einstieg" (entfällt AD-26) + „Dry-Run-Vorschau" + „Loop-/Rate-Schutz-Warnmodal" (NUR diese) + zugehörige Features/UI-Elemente
  • ENTITY-MODEL.md → Domäne 7 (Automation & KI: AutomationRule/Step/Execution/Credential — KI entfällt AD-26)
  • SCREEN-MAP.md → §5 Flow-Editor · DESIGNER-FIRST-PLAYBOOK.md → §3 Rang 1 · ROADMAP.md → Phase 12 · _bmad-output/specs/M17-automation-engine.md

Davids Delta (David füllt aus)

  • Überschriebene/geänderte Spec-Punkte:
  • Neue UI/UX-Entscheidungen:
  • Subframe-Screen-Link(s):
  • Offene Fragen an Dev: