Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/D-P12.md
T

64 lines
6.5 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-/AD-32-Grenze:** KWP-Push bleibt ein nicht ausführbarer Extension-Slot. Eine ausführbare Action und
> KWP-spezifisches Konfig-UI dürfen erst nach `VEXT-6` plus erneuter ausdrücklicher Produktfreigabe folgen.
> ~~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 nur als nicht ausführbarer Extension-Slot, ohne KWP-Adapter/Executor-Handler bis `VEXT-6` + erneuter Freigabe · **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 erst nach `VEXT-6` + erneuter Produktfreigabe.)*
## 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
- 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: