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,41 @@
+---
+kind: screen
+project: HiveGrid Screen Project
+ticket: D-FLOW
+package: WF-P12 Flow-Editor
+id: M01
+screen: Probelauf
+typ: Modal
+umsetzung: Bauen
+status: Validiert
+route: "aus S01 (Probelauf-Knopf / vor Aktivierung)"
+subframe: ""
+---
+
+# M01 — Probelauf (Dry-Run)
+
+## Ziel
+
+Vor dem Scharfschalten sehen, was die Automation WIRKLICH tun würde — keine bösen Überraschungen.
+
+## Was das Tool können muss
+
+- **»Trifft X Datensätze«** + die ersten 5 als Beispiele
+- Schritt-für-Schritt-Simulation in Klartext (»E-Mail würde an max@… gehen«)
+- **Pflicht-Bestätigung** ab Schwelle (> 100 Datensätze/Schritt, mandant-einstellbar) — ggf. mit Bestätigungs-Phrase
+- Ergebnis: aktivieren oder zurück in den Editor
+
+## Pattern / Archetyp
+
+A5 Modal + Simulations-Liste.
+
+## Zustände
+
+| Zustand | Beschreibung | Umsetzung |
+|---|---|---|
+| Über Schwelle | Bestätigung Pflicht | Nur dokumentieren |
+| Trifft nichts | »Aktuell trifft die Automation 0 Datensätze« | Nur dokumentieren |
+
+## Subframe
+
+- (erst nach explizitem OK)
@@ -0,0 +1,34 @@
+---
+kind: screen
+project: HiveGrid Screen Project
+ticket: D-FLOW
+package: WF-P12 Flow-Editor
+id: M02
+screen: Schleifen-Warnung
+typ: Modal
+umsetzung: Bauen
+status: Validiert
+route: "aus S01 bei Schleifen-Verdacht"
+subframe: ""
+---
+
+# M02 — Schleifen-/Raten-Warnung
+
+## Ziel
+
+Endlos-Schleifen verhindern, bevor sie den Betrieb fluten — verständlich erklärt.
+
+## Was das Tool können muss
+
+- **Mini-Abhängigkeits-Graph**: welche Automationen sich gegenseitig auslösen (der Kreis ist markiert)
+- Klartext: »Automation A löst B aus, B löst wieder A aus«
+- **»Beheben«**-Knopf (springt zum betroffenen Baustein)
+- Anomalie-Hinweis-Variante: »2.000-mal in 5 Min gelaufen, typisch 5–10/Tag — pausiert« + wieder aktivieren
+
+## Pattern / Archetyp
+
+A5 Modal + Mini-Graph.
+
+## Subframe
+
+- (erst nach explizitem OK)
@@ -0,0 +1,32 @@
+---
+kind: screen
+project: HiveGrid Screen Project
+ticket: D-FLOW
+package: WF-P12 Flow-Editor
+id: M03
+screen: Start-Auswahl
+typ: Modal
+umsetzung: Bauen
+status: Validiert
+route: "»+ Neue Automation« (aus der Automation-Liste)"
+subframe: ""
+---
+
+# M03 — Start-Auswahl
+
+## Ziel
+
+Der schnellste Weg zum Erfolgserlebnis: mit einer Vorlage starten statt vor leerer Fläche zu sitzen.
+
+## Was das Tool können muss
+
+- **Leer starten** ODER **Vorlage wählen** (SHK-Vorlagen + eigene, nach Kategorie, mit Use-Case-Beschreibung — eingebetteter Vorlagen-Katalog aus WF-P12 Verwaltung)
+- Auswahl → Editor öffnet mit vorbefülltem Flow (Vorlage) oder leer
+
+## Pattern / Archetyp
+
+A5 Dialog (echtes Modal).
+
+## Subframe
+
+- (erst nach explizitem OK)
@@ -0,0 +1,44 @@
+---
+kind: screen
+project: HiveGrid Screen Project
+ticket: D-FLOW
+package: WF-P12 Flow-Editor
+id: S01
+screen: Flow-Editor
+typ: BESPOKE (schwerste UI)
+umsetzung: Bauen
+status: Validiert
+route: "/automations/:id/edit"
+subframe: ""
+---
+
+# S01 — Flow-Editor ⭐
+
+## Ziel
+
+Automationen zusammenklicken wie ein Diagramm — verständlich für Büro-Menschen, nicht nur Techniker.
+
+## Was das Tool können muss
+
+- **Zeichenfläche**: Bausteine setzen, verbinden, verschieben, duplizieren, löschen; Pan/Zoom; Undo/Redo; automatisch anordnen; Mini-Übersichtskarte
+- **Katalog links** (einklappbar): Auslöser + Aktionen, nach Modul gruppiert/filterbar, per Ziehen oder Klick hinzufügen
+- **Konfig-Panel rechts**: Klick auf Baustein → typ-abhängiges Formular in Klartext (Inhalte aus WF-P12 Verwaltung S05)
+- **Inline-Validierung** direkt am Baustein: nicht verbunden · Schleifen-Verdacht · Pflichtfeld fehlt
+- Kopf: Name, Status-Pill (aktiv/pausiert/Entwurf), Speichern, **Probelauf** → [[M01 Probelauf]], Aktivieren/Deaktivieren
+- Aktivieren blockiert bei Fehlern (Klartext-Liste, Sprung zum Baustein)
+
+## Pattern / Archetyp
+
+**BESPOKE** — Dreispalten-Anordnung (validiert): Katalog · Canvas · Konfig.
+
+## Zustände
+
+| Zustand | Beschreibung | Umsetzung |
+|---|---|---|
+| Leerer Flow | Hinweis »Ersten Auslöser aus dem Katalog ziehen« | Nur dokumentieren |
+| Ungespeichert verlassen | Hinweis | Nur dokumentieren |
+| Laden / Fehler / kein Zugriff | A7 | Wiederverwenden |
+
+## Subframe
+
+- (erst nach explizitem OK)
@@ -0,0 +1,19 @@
+{
+	"nodes":[
+		{"id":"md-paket","type":"file","file":"02 Wireframes/P12 Automationen/WF-P12 Flow-Editor/WF-P12 Flow-Editor.md","x":-80,"y":-440,"width":460,"height":280},
+		{"id":"group-editor","type":"group","x":-80,"y":-100,"width":1820,"height":380,"label":"Editor (Bespoke — schwerste UI, Langläufer)"},
+		{"id":"group-schutz","type":"group","x":-80,"y":460,"width":1820,"height":380,"label":"Schutz-Dialoge"},
+		{"id":"note-entry","type":"text","text":"# Einstieg\n\n»+ Neue Automation« aus der Automation-Liste (WF-P12 Verwaltung) → Start-Auswahl.\n\nKlartext-First: alles in verständlichem Deutsch.","x":0,"y":0,"width":360,"height":200},
+		{"id":"m03","type":"file","file":"02 Wireframes/P12 Automationen/WF-P12 Flow-Editor/Screens/M03 Start-Auswahl.md","x":560,"y":0,"width":420,"height":200},
+		{"id":"s01","type":"file","file":"02 Wireframes/P12 Automationen/WF-P12 Flow-Editor/Screens/S01 Flow-Editor.md","x":1240,"y":0,"width":420,"height":200},
+		{"id":"m01","type":"file","file":"02 Wireframes/P12 Automationen/WF-P12 Flow-Editor/Screens/M01 Probelauf.md","x":560,"y":560,"width":420,"height":200},
+		{"id":"m02","type":"file","file":"02 Wireframes/P12 Automationen/WF-P12 Flow-Editor/Screens/M02 Schleifen-Warnung.md","x":1240,"y":560,"width":420,"height":200},
+		{"id":"note-embed","type":"text","text":"# Einbettung\n\nBaustein-Konfig-Panels (rechtes Panel) kommen aus WF-P12 Verwaltung (S05).\n\nAnordnung validiert: Katalog links · Canvas Mitte · Konfig rechts.","x":0,"y":560,"width":460,"height":240}
+	],
+	"edges":[
+		{"id":"e-entry","fromNode":"note-entry","fromSide":"right","toNode":"m03","toSide":"left","toEnd":"arrow","styleAttributes":{"path":"dotted"}},
+		{"id":"e-start","fromNode":"m03","fromSide":"right","toNode":"s01","toSide":"left","toEnd":"arrow","label":"leer oder Vorlage"},
+		{"id":"e-dryrun","fromNode":"s01","fromSide":"bottom","toNode":"m01","toSide":"top","toEnd":"arrow","label":"Probelauf / vor Aktivierung"},
+		{"id":"e-loop","fromNode":"s01","fromSide":"bottom","toNode":"m02","toSide":"top","toEnd":"arrow","label":"bei Schleifen-Verdacht","styleAttributes":{"path":"long-dashed"}}
+	]
+}
@@ -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)*