Track HiveGrid Cloud planning reference
This commit is contained in:
1 parent
b3d5ea6764
commit
e341c5938a
5784 files changed
+1104929
-3
No files matched your search
@@ -0,0 +1,61 @@
|
||||
# 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
|
||||
Reference in new issue
Block a user