Plan P8 Pipelines, P9 Auftrag (Akte/Plantafel/Abnahme), P12 Automationen

- WF-P8: Kanban-Board, Edit-Mode (nur Detailansicht), Gewonnen regel-basiert - WF-P9: Projekt-Akte + Rechnung v1, Plantafel (Heute<->Woche offline), Abnahme mehrstufig - WF-P12: Flow-Editor (Katalog/Canvas/Konfig, Start-Auswahl) + Verwaltung (Timeline, 24h-Undo) - D-FORM zurueckgestellt (Davids Mitarbeiter:in) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-09 15:38:27 +02:00
1 parent ca078436df
commit 2de481bf25
@@ -0,0 +1,121 @@
+---
+kind: wireframe-package
+project: HiveGrid Screen Project
+ticket: D-FLOW
+package: WF-P12 Flow-Editor
+typ: Flow
+status: Validiert
+subframe: ""
+canvas: "WF-P12 Flow-Editor.canvas"
+---
+
+# WF-P12 Flow-Editor
+
+Status: Validiert (Screen-Liste)  
+Subframe-Link: -  
+Canvas: [Canvas](<WF-P12 Flow-Editor.canvas>)  
+Stand: 2026-07-09
+
+---
+
+## 1. Kurzfassung
+
+Der Automations-Baukasten: Zeichenfläche mit Auslöser- und Aktions-Bausteinen, alles in verständlichem Deutsch, mit Probelauf und Schleifen-Schutz. **Schwerste UI der App, erste USP-Säule, Langläufer — viele Iterationen einplanen.**
+
+---
+
+## 2. Intent Check
+
+| Frage | Antwort |
+|---|---|
+| Ticket/Modul | D-FLOW, Dev-Pendant R-P12a/R-P12b (Editor blockt R-P12b!) |
+| Nutzer-Ziel | »Wenn X passiert, tu Y« zusammenklicken — ohne Programmierkenntnisse, ohne Angst vor Fehlern |
+| Quellen geprüft | `ticket-docs/D-FLOW.md`, ENTITY-MODEL Domäne 7, HiveGrid Map |
+| Sicher im Scope | Graph-Canvas, Katalog, Konfig-Panel-Rahmen, Mini-Map, Toolbar, Validation, Dry-Run, Loop-Warnung, Start-Auswahl |
+| Sicher nicht im Scope | Sprach-zu-Automation (gestrichen, AD-26) · KWP-Konfig-UI (v2) · Liste/Verläufe/Vorlagen (WF-P12 Verwaltung) |
+| Unsichere Annahmen | — |
+
+---
+
+## 3. Scope
+
+| Punkt | Inhalt |
+|---|---|
+| Startpunkt | »+ Neue Automation« (aus der Automation-Liste) oder bestehende öffnen |
+| Ziel | Automation gebaut, per Probelauf geprüft, bewusst aktiviert |
+| Haupt-Archetyp | **BESPOKE — schwerste UI** + A5 Modals |
+| Out of scope | s. o. |
+
+---
+
+## 4. Entscheidungen (validiert 2026-07-09)
+
+| Entscheidung | Status | Notiz |
+|---|---|---|
+| Zwei P12-Pakete (Editor / Verwaltung) | genommen | Editor ist Langläufer |
+| **Grundanordnung: Katalog links · Canvas Mitte · Konfig rechts** | genommen | n8n-Muster; Klick auf Baustein öffnet Konfig-Panel rechts, Canvas bleibt sichtbar; Katalog einklappbar |
+| **Start-Auswahl mit Vorlagen** | genommen | »+ Neue Automation« → Dialog: leer starten ODER SHK-/eigene Vorlage wählen → Editor öffnet |
+| Dry-Run + Schleifen-Warnung als eigene Modals | genommen | Pflicht-Bestätigung ab Schwelle (mandant-einstellbar) |
+| Aktivieren blockiert bei Fehlern | genommen | Klartext-Fehlerliste (nicht verbunden / Schleife / Pflichtfeld) — dokumentiert |
+| Klartext-First | genommen | Baustein-Labels, Validierung, Dry-Run-Ausgaben: verständliches Deutsch, nicht technisch |
+| Konfig-Panel-Inhalte kommen aus WF-P12 Verwaltung | genommen | typ-abhängige Formulare (S05 dort), der Editor bettet sie ein |
+
+### Happy Path
+
+1. »+ Neue Automation« → Start-Auswahl: Vorlage »Neue Anfrage → Aufgabe für Vertrieb« wählen (oder leer).
+2. Editor: Bausteine aus dem Katalog ziehen, verbinden; Klick → Konfig rechts in Klartext.
+3. Inline-Fehler beheben (»Baustein nicht verbunden«).
+4. **Probelauf**: »Trifft 143 Datensätze …« — prüfen, ggf. Pflicht-Bestätigung.
+5. Aktivieren. Bei Schleifen-Verdacht: Warnmodal mit Mini-Graph + »Beheben«.
+
+### Meldungs-/Error-States (validiert)
+
+| Ereignis | UI-Form | Blockiert? | Bauen? | Copy/Notiz |
+|---|---|---|---|---|
+| Probelauf ab Schwelle | Pflicht-Bestätigung im Dry-Run-Modal | ja | Bauen (M01) | »Trifft > 100 Datensätze — bitte bestätigen« |
+| Schleife erkannt | Warnmodal mit Mini-Abhängigkeits-Graph | ja | Bauen (M02) | + »Beheben«-Knopf |
+| Aktivieren mit Fehlern | blockiert + Klartext-Fehlerliste | ja | Nur dokumentieren | je Fehler Sprung zum Baustein |
+| Anomalie-Pause | Banner (auch in Liste/Detail) | nein | Nur dokumentieren | »2.000-mal in 5 Min — pausiert« |
+| Ungespeicherte Änderungen | Hinweis beim Verlassen | nein | Nur dokumentieren | — |
+
+---
+
+## 7. Validierte Screen-Liste
+
+| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
+|---|---|---|---|---|---|
+| S01 | Flow-Editor (Katalog · Canvas · Konfig) ⭐ | BESPOKE | Bauen | `/automations/:id/edit` | Validiert |
+| M01 | Probelauf (Dry-Run) | Modal | Bauen | aus S01 | Validiert |
+| M02 | Schleifen-/Raten-Warnung | Modal | Bauen | aus S01 | Validiert |
+| M03 | Start-Auswahl (leer / Vorlage) | Modal | Bauen | »+ Neue Automation« | Validiert |
+| D01–D03 | Aktivieren-Block / Anomalie-Banner / Verlassen-Hinweis | Inline | Nur dokumentieren | — | Validiert |
+
+---
+
+## 8. Grid
+
+```text
+Automation-Liste (WF-P12 Verwaltung) -> M03 (Start-Auswahl) -> S01 (Editor)
+S01 -> M01 (Probelauf) -> Aktivieren
+S01 -> M02 (Schleifen-Warnung, bei Verdacht)
+S01 bettet ein: Baustein-Konfig-Panels (WF-P12 Verwaltung S05)
+```
+
+---
+
+## 9. Screen-Pakete
+
+- [[S01 Flow-Editor]] · [[M01 Probelauf]] · [[M02 Schleifen-Warnung]] · [[M03 Start-Auswahl]]
+
+---
+
+## 10. Offene Fragen
+
+- Kanten-Interaktion (Klick-Verbinden vs. nur Ziehen) + Auto-Layout-Verhalten → Subframe-Iterationen
+- Dry-Run-Schwelle: Default-Wert → Dev
+
+## Handoff-Check
+
+- [x] Jeder Screen ist mit Umsetzung markiert.
+- [x] Meldungs-/Error-State-Matrix ist ausgefüllt.
+- [ ] Subframe-Link ist eingetragen. *(Subframe erst nach explizitem OK)*