Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,56 @@
# 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: