Files
HiveGrid-Wireframes/02 Wireframes/P12 Automationen/WF-P12 Flow-Editor/WF-P12 Flow-Editor.md
T
dejanandClaude Opus 4.8 6fdcb556c7 Validate P12 blocks K-T1/K-T2/K-T3, apply decisions
Full validation pass over the first 18 of 30 block-config dialogs, done
by Dejan with David's mandate. Findings fixed directly in Subframe;
decisions and dependency notes recorded here.

Decisions (Dejan):
- Ansprache: durchgehend duzen (produktweit; Picker siezt noch)
- Begriff Board statt Pipeline
- Erklär-Box bleibt handgebaut (Alert-Komponente kann die Kategoriefarben
  nicht)
- Pflichtfeld-Muster: Sternchen im Label + "Pflichtfeld." im helpText
- "Deadline naht" wird "Frist oder Termin" (deckt Terminerinnerung +
  Mahnwesen ab; ersetzt zwei Picker-Einträge ohne Dialog)
- Zeitplan: Felder wechseln je Wiederholung; "monatlich" als eigene
  Subframe-Seite gezeichnet, "täglich" nur dokumentiert
- "E-Mail eingegangen": Badge "Ab v2" + Hinweis (braucht Postfach = v2)
- "E-Mail unzustellbar": bleibt v1, Abhängigkeit zu D-KAMP/D-P14 notiert

Editor-Split (freigegeben): S01b Baustein-Picker und S01c Kontextmenü
als eigene Screen-Dateien + Tracker-Zeilen; Canvas um Picker,
Kontextmenü und den fehlenden S01d Baustein-Karte-Knoten erweitert.

Befunde an D-D0b (Baukasten, nicht selbst geändert): Uhrzeit-Komponente
fehlt komplett (betrifft auch Plantafel/Terminbuchung/Kalender), Number
Input auf 192px festgenagelt, IconWithBackground kann kein Violett.

Baustein-Katalog in S05a auf den echten gebauten Stand nachgezogen.

Noch offen für David/Dejan von Hand: Subframe-Seite "K-T2 Deadline naht"
zu "K-T2 Frist oder Termin" umbenennen.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-16 17:32:09 +02:00

134 lines
6.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
kind: wireframe-package
project: HiveGrid Screen Project
ticket: D-FLOW
package: WF-P12 Flow-Editor
typ: Flow
status: In Subframe (Grundgeruest) - Neuausrichtung 2026-07-12
subframe: "https://app.subframe.com/f023064a5ca0/flow/22d511a9-1d8f-4554-89ad-86729b8d7738/edit"
canvas: "WF-P12 Flow-Editor.canvas"
---
# WF-P12 Flow-Editor
Status: Editor-Grundgerüst in Subframe, Bausteine auf dem Canvas fehlen; M01–M03 neu zu bauen
Subframe-Flow: [(MCP) HiveGrid Workflow Engine / Automationen P12](https://app.subframe.com/f023064a5ca0/flow/22d511a9-1d8f-4554-89ad-86729b8d7738/edit)
Canvas: [Canvas](<WF-P12 Flow-Editor.canvas>)
Stand: 2026-07-13 (Subframe per MCP abgeglichen)
---
## 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, Baustein-Picker, Konfig-Dialoge, 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 Dialoge |
| Out of scope | s. o. |
---
## 4. Entscheidungen
| Entscheidung | Status | Notiz |
|---|---|---|
| Zwei P12-Pakete (Editor / Verwaltung) | genommen (07-09) | Editor ist Langläufer |
| ~~Grundanordnung: Katalog links · Canvas Mitte · Konfig rechts~~ | **ERSETZT (07-12)** | n8n-Dreispalten verworfen. Beide Subframe-Varianten (A/B) wurden gelöscht. |
| **Grundanordnung: Vollbild-Canvas · Baustein-Picker als Drawer · Konfig als Dialog** | genommen (07-12) | Neuer gebauter Stand, siehe [[S01 Flow-Editor]]. Subframe gilt. |
| **Konfig als echtes Modal je Baustein-Typ** | genommen (07-12, David) | 30 Dialoge gebaut, siehe [[S05a Baustein-Konfig Vorplanung]] |
| Farbschema der Kategorien: S05a-Schema | genommen (07-13, Dejan) | Grün/Rot/Blau/Gelb/Violett/Grau. Die 30 Konfig-Dialoge stimmen bereits; der **Picker muss nachziehen** (nutzt derzeit Orange für Auslöser). |
| Ansprache: durchgehend duzen | genommen (07-13, Dejan) | Der Baustein-Picker siezt noch und muss nachziehen. |
| Start-Auswahl mit Vorlagen | genommen (07-09) | »+ Neue Automation« → Dialog: leer starten ODER SHK-/eigene Vorlage wählen → Editor öffnet |
| Dry-Run + Schleifen-Warnung als eigene Modals | genommen (07-09) | Pflicht-Bestätigung ab Schwelle (mandant-einstellbar) |
| Aktivieren blockiert bei Fehlern | genommen (07-09) | Klartext-Fehlerliste (nicht verbunden / Schleife / Pflichtfeld) |
| Klartext-First | genommen (07-09) | Baustein-Labels, Validierung, Dry-Run-Ausgaben: verständliches Deutsch |
| **Modus-Umschalter »Bauen / Aktivität / Auswertung«** | **OFFEN — David muss entscheiden** | Im Editor-Kopf gebaut, aber »Auswertung« steht in keinem Ticket; »Aktivität« würde die Lauf-Liste in den Editor holen. Aufgefallen beim Abgleich 2026-07-13. Planung läuft vorerst **ohne** die Tabs. |
### Happy Path
1. »+ Neue Automation« → Start-Auswahl: Vorlage wählen (oder leer starten).
2. Editor: Baustein über den Picker-Drawer hinzufügen, verbinden; Klick auf Baustein → Konfig-Dialog 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. Screen-Liste (Stand 2026-07-13)
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|---|---|---|---|---|---|
| S01 | Flow-Editor (Vollbild-Canvas) ⭐ | BESPOKE | Bauen | `/automations/:id/edit` | **In Subframe** (Grundgerüst, leerer Canvas) |
| S01b | Baustein-Picker (Drawer) | Drawer | Bauen | aus S01 | **In Subframe** (Farbschema nachziehen) |
| S01c | Canvas-Kontextmenü | Kontextmenü | Bauen | Rechtsklick in S01 | **In Subframe** |
| S01d | Baustein-Karte + Kanten auf dem Canvas | BESPOKE | Bauen | in S01 | **FEHLT — höchste Priorität** |
| M01 | Probelauf (Dry-Run) | Modal | Bauen | aus S01 | Validiert, Subframe gelöscht → neu bauen |
| M02 | Schleifen-/Raten-Warnung | Modal | Bauen | aus S01 | Validiert, Subframe gelöscht → neu bauen |
| M03 | Start-Auswahl (leer / Vorlage) | Modal | Bauen | »+ Neue Automation« | Validiert, Subframe gelöscht → neu bauen |
| 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 -> S01b (Baustein-Picker Drawer) -> Baustein landet auf dem Canvas
S01 -> Klick auf Baustein -> Konfig-Dialog (WF-P12 Verwaltung S05/S05a)
S01 -> M01 (Probelauf) -> Aktivieren
S01 -> M02 (Schleifen-Warnung, bei Verdacht)
```
---
## 9. Screen-Pakete
- [[S01 Flow-Editor]] · [[M01 Probelauf]] · [[M02 Schleifen-Warnung]] · [[M03 Start-Auswahl]]
- Baustein-Konfig: [[S05a Baustein-Konfig Vorplanung]] (Katalog aller 30 Dialoge)
---
## 10. Offene Fragen
- **Modus-Umschalter »Bauen / Aktivität / Auswertung«** — offen (David). Siehe Entscheidungstabelle.
- Kanten-Interaktion (Klick-Verbinden vs. nur Ziehen) + Auto-Anordnen-Verhalten → Subframe-Iterationen
- Dry-Run-Schwelle: Default-Wert → Dev
- M02: »Trotzdem aktivieren« widerspricht der Blockier-Regel — beim Neubau klären
- M03: doppelter CTA (»Verwenden« je Karte + »Mit Auswahl weiter« im Footer) — Interaktionsmodell festlegen
## Handoff-Check
- [x] Jeder Screen ist mit Umsetzung markiert.
- [x] Meldungs-/Error-State-Matrix ist ausgefüllt.
- [ ] Subframe vollständig. *(Editor-Grundgerüst + Picker + Kontextmenü stehen; Baustein-Karte, Kanten und M01–M03 fehlen.)*