63 lines
6.4 KiB
Markdown
63 lines
6.4 KiB
Markdown
# D-P12 · Screens P12 — Automation-Engine (ohne Flow-/Node-Editor)
|
|
|
|
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Der „Sprach-zu-Automation"-/KI-Andock **entfällt** (kein LLM in v1 — HiveGrid wird MCP-Server, [[VR-MCP]]); R-P13 ist gelöscht. P12 bleibt ein **reiner visueller Flow-Editor** (Canvas via D-FLOW) + die Nicht-Canvas-Flächen hier. Alle Sprach-/KI-Stellen unten sind durchgestrichen.
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Typ** | Screen (Design) |
|
|
| **Owner** | David |
|
|
| **Phase** | P12 — Automation-Engine (bedient `R-P12a`/`R-P12b`) |
|
|
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · 2026-07-06 → 2026-07-07 · Gate W4 |
|
|
| **Status** | geplant (NEU — schließt P12-Screen-Lücke außerhalb des Flow-Editors) |
|
|
|
|
> **Ergänzt das Bespoke-Ticket `D-FLOW`** (visueller Flow-/Node-Editor ~~inkl. Sprach-zu-Automation-Einstieg~~ (entfällt [[AD-26]]), Dry-Run-Vorschau, Loop-/Rate-Schutz-Warnmodal — die schwerste UI der App, Langläufer ab 18.06.). **Dieses Ticket deckt die übrigen P12-Screens**: Automation-Liste, Run-History/Logs (Execution-Liste + -Detail), Template-Katalog und die Trigger-/Aktion-Konfiguration (als Knoten-Konfig-Panel-Inhalte, die der Editor einbettet). Der Graph-Canvas/Node-Editor ist **NICHT** Teil von D-P12.
|
|
|
|
## Abhängigkeiten & Parallelität
|
|
- **Blocked by:** `D-D0a` (App-Shell), `D-D0b` (Archetypen A2 Liste, A3 Detail + Timeline, A5 Modal, A6 Settings)
|
|
- **Bedient (Dev):** `R-P12a` (Automation-Kern + Schutz-Mechanismen), `R-P12b` (visueller Flow-Editor + Dry-Run + 24h-Undo ~~+ Sprach-Andock~~ → Sprach-Andock entfällt [[AD-26]])
|
|
- **Parallel/Geschwister:** `D-FLOW` (BESPOKE Graph-Editor) — D-P12 liefert die List-/History-/Template-Flächen + Konfig-Panel-Inhalte, D-FLOW den Canvas
|
|
- **Subframe:** Pflicht je Route (A2 Liste, A3 Execution-Detail mit Timeline, A5 Modal, A6 Settings)
|
|
|
|
## Was wir bauen
|
|
Die **Nicht-Canvas-Flächen der Automation-Engine**: Übersichtsliste aller Automationen, Run-History (Execution-Liste + Step-by-Step-Execution-Detail mit Klartext-Diagnostik + 24h-Rückgängig), Template-Katalog (SHK + Tenant) und die **Trigger-/Aktion-Konfiguration** als typ-abhängige Knoten-Konfig-Panel-Inhalte (vom Flow-Editor eingebettet).
|
|
|
|
> 🔴 **Klartext-First überall:** Knoten-Labels, Dry-Run-Ausgaben, Loop-/Rate-Warnungen und Execution-Logs in verständlichem Deutsch, nicht technisch.
|
|
> 🟡 **v1-Grenze:** KWP-Push-Action nur als erweiterbarer Registry-Eintrag (zieht v2 nach) — kein KWP-spezifisches Konfig-UI in v1. ~~Sprach-zu-Automation rendert im Flow-Editor (D-FLOW); die KI-Pipeline selbst liegt in P13.~~ → **entfällt ([[AD-26]]).**
|
|
|
|
## Benötigte Screens
|
|
| Screen [Route] | Kern-Inhalt | Archetyp |
|
|
|---|---|---|
|
|
| Automation-Liste [`/automations`] | Name, Trigger, Status (aktiv/pausiert/Entwurf), Läufe (30d), letzte Ausführung · „nur meine"-Filter | A2 |
|
|
| **Execution-Detail** [`/automations/:id/executions/:exec_id`] | `summary_text` · Trigger-Payload user-lesbar · **Step-by-Step-Verlauf mit Klartext je Schritt** (Status, Input/Output, Dauer) · Dry-Run-Marker · **24h-Rückgängig-Button mit Restzeit-Anzeige** · Manuell-Retry · Resume-ab-Schritt | A3 + Timeline |
|
|
| Execution-Liste [`/automations/:id/executions`] | Letzte N Läufe · Filter (Status/Datum/Trigger-Typ) · Klick → Detail | A2 |
|
|
| Template-Katalog [`/automations/templates`] | SHK-Vorlagen + Tenant-Vorlagen nach Kategorie · je Template Beschreibung + Use-Case + Nutzungs-Anzahl · „Verwenden"-Button · „Eigenes Template aus Rule anlegen" | A2 |
|
|
| Trigger-/Aktion-Konfiguration [Knoten-Konfig-Panel-Inhalte] | Typ-abhängige Konfig-Felder je Trigger (CRM/Lead/Sales/Projekte/Email/Forms/Booking/Kalender/Zeit/Webhook) und je Action (CRM/Notification/HTTP/Task/If-Else/Delay/Loop) mit **Klartext-Labels** + Validation-Hinweisen (Pflichtfeld fehlt, unverbunden) · KWP-Push als registriert-erweiterbarer Eintrag (kein eigenes UI v1) · **werden vom Flow-Editor (D-FLOW) als Konfig-Panel eingebettet** | Compose (in D-FLOW-Panel) |
|
|
|
|
*(Flow-/Node-Editor ~~+ Sprach-zu-Automation-Einstieg~~ (entfällt [[AD-26]]) + Dry-Run-Vorschau-Modal + Loop-/Rate-Schutz-Warnmodal = **D-FLOW**. Trigger-/Action-Library selbst sind Daten im Knoten-Katalog, kein eigener Screen. KWP-Push-Konfig → v2.)*
|
|
|
|
## Features (muss abgedeckt sein)
|
|
- [ ] Automation-Liste (Name/Trigger/Status/Läufe/letzte Ausführung, „nur meine"-Filter)
|
|
- [ ] Execution-Liste mit Filter (Status/Datum/Trigger-Typ)
|
|
- [ ] Execution-Detail mit Step-by-Step-Timeline (Klartext je Schritt, Status/Input/Output/Dauer) + Dry-Run-Marker
|
|
- [ ] 24h-Reverse-Window-UX (Countdown-Button) + Manuell-Retry + Resume-ab-Schritt
|
|
- [ ] Template-Katalog (SHK + Tenant nach Kategorie, „Verwenden" + „aus Rule erstellen")
|
|
- [ ] Trigger-/Aktion-Konfig-Panel-Inhalte (typ-abhängige Felder, Klartext-Labels, Validation-Hinweise) — einbettbar in D-FLOW
|
|
- [ ] Status-Pills (aktiv/pausiert/Entwurf/fehlgeschlagen/übersprungen)
|
|
- [ ] Empty/Loading/Permission-Denied-States (Klartext)
|
|
|
|
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
|
|
Daten-Tabelle (sortierbar, paginiert) für Automation-/Execution-Liste; Status-Pills (aktiv/pausiert/Entwurf/fehlgeschlagen/übersprungen); „nur meine"-Quick-Filter + Filter-Bar (Status/Datum/Trigger-Typ); Step-by-Step-Timeline mit Status-Markern (Klartext je Schritt, Input/Output, Dauer); user-lesbarer Trigger-Payload-Renderer; Dry-Run-Marker-Badge; **24h-Reverse-Button mit Countdown**; Retry-/Resume-Buttons; Template-Karten mit Use-Case-Beschreibung + Nutzungs-Anzahl + „Verwenden"-Button + „aus Rule erstellen"; **Knoten-Konfig-Panel** (typ-abhängige Felder je Trigger/Action) mit Klartext-Knoten-Label-Renderer + Inline-Validation-Badges/Hinweise (unverbunden/Cycle/Pflichtfeld fehlt); Empty-/Loading-/Permission-Denied-States.
|
|
|
|
## Quellen (granular)
|
|
- `designer-briefs/P12-automation-engine.md` (vollständiger Brief MINUS Flow-Editor/~~Sprach-Einstieg~~ (entfällt [[AD-26]])/Dry-Run-Modal/Loop-Schutz-Modal)
|
|
- `ENTITY-MODEL.md` → **Domäne 7** (Automation ~~& KI~~: AutomationRule/Step/Execution/StepExecution/Credential/Template — KI entfällt [[AD-26]])
|
|
- `ROADMAP.md` → Phase 12 · `REQUIREMENTS.md` → Modul 17 · `PHASE-SOURCES.md` → P12
|
|
- `_bmad-output/specs/M17-automation-engine.md`
|
|
- Geschwister-Ticket (Editor): `D-FLOW` · Dev-Pendant: `ticket-docs/R-P12a.md`, `ticket-docs/R-P12b.md`
|
|
|
|
## Davids Delta (David füllt aus)
|
|
- [ ] Überschriebene/geänderte Spec-Punkte:
|
|
- [ ] Neue UI/UX-Entscheidungen:
|
|
- [ ] Subframe-Screen-Link(s):
|
|
- [ ] Offene Fragen an Dev:
|