---
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)*