Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/R-P12b.md
T
2026-07-08 16:15:37 +02:00

7.9 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-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 On Hold (Screens D-FLOW/D-P12 fehlen)

🔴 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)
  • Stand 2026-07-02: R-P12a ist serverseitig umgesetzt und technisch nutzbar; blockierend fuer R-P12b bleiben die fehlenden D-FLOW/D-P12-Screens und die visuelle Editor-Endabnahme.
  • 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 — technisch teilweise umgesetzt (Add/Delete/Duplicate/Connect/Disconnect/Auto-Layout/Undo/Redo + minimale Route); final offen: Canvas, Drag-Move, Mini-Map, Konfig-Panel nach D-FLOW.
  • 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 — Reverse-Plan + Confirm-Phrase umgesetzt; echte destructive Reverse-Adapter/Audit-Ausführung offen, sobald Action-Side-Effects konkret verdrahtet sind.
  • 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)

Umsetzungs-Notiz

  • 2026-07-02: R-P12b ohne Screens technisch maximal vorgezogen: reiner Editor-Kern (automation.editor.ts) fuer Flow-Normalisierung, Graph-Operationen, Cycle-/Reachability-/Unvollständig-Validation, Undo/Redo-History, Auto-Layout, Dry-Run-Preview mit Schwellenwert-Confirm und 24h-Reverse-Plan. Server-Wiring in automation.server.ts fuer Editor-VM, Save/Activate/Pause/Dry-Run/Template-aus-Rule und Template-aus-Platform-Template. Neue Routen: /automations/:id/edit und /automations/templates; bestehendes Execution-Detail zeigt Reverse-Plan.
  • Proof: pnpm typecheck; pnpm exec prisma validate; pnpm lint; pnpm vitest run apps/web/app/services/automation/automation.editor.test.ts apps/web/app/services/automation/automation.registry.test.ts scripts/verify-route-inventory.test.mjs apps/web/app/application/sidebar/AppSidebar.test.tsx.
  • Plane: Kommentar mit Proof hinterlegt; Ticket auf Blocked / On Hold gesetzt.
  • DoD-Stand: 4/6 aktive DoD-Punkte vollständig erledigt = ~67 % done. Zusätzlich sind 2/6 Punkte technisch teilweise erledigt, aber final blockiert durch D-FLOW/D-P12 bzw. echte Reverse-Adapter/Audit-Ausführung. Sprach-Andock ist per AD-26 erledigt/entfallen und wird nicht als offener v1-Punkt gezählt. Ticket bleibt On Hold, nicht Done.

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