# Designer-Brief · P12 — Automation-Engine **Phase:** 12/21 · **Modul:** M17 · **Owner-Dev:** Raffael (R-P12a/b) · **Designer:** David (D-Automation, Paket Fr 03.07.) **Quellen:** `ROADMAP.md` §Phase 12 · `ENTITY-MODEL.md` Domäne 7 (Automation & KI) · `SCREEN-MAP.md` §5 (Flow-Editor) · `_bmad-output/specs/M17-automation-engine.md` **Subframe:** Pflicht je Route. Archetypen aus D0 (A2 Liste, A3 Detail, A5 Modal, A6 Settings) — Flow-Editor selbst ist **Bespoke**. > 🔴 **Schwerste UI der App (AD-16, ab 22.06. täglich 1h).** Der visuelle Flow-/Node-Editor ist die erste USP-Säule und vollständig bespoke. Klartext-First gilt überall: Knoten-Labels, Dry-Run-Ausgaben, Loop-/Rate-Warnungen und Execution-Logs sind in **verständlichem Deutsch**, nicht technisch. > 🟡 **v1-Grenze:** KWP-Push-Action ist nur als erweiterbarer Registry-Eintrag vorgesehen (zieht mit v2-P10/P32 nach) — kein KWP-spezifisches Konfig-UI in v1. Sprach-zu-Automation rendert hier den Flow-Vorschlag; die KI-Pipeline selbst liegt in P13. ## Was dieses Modul tut (Kurzfassung) Ein visueller Graph-Editor, in dem Nutzer modulübergreifende Automationen aus einer **vollständigen Trigger-Library** (CRM, Lead, Sales, Projekte, Email, Forms, Booking, Kalender, Zeit, Webhooks) und **Action-Library** (CRM, Notifications, HTTP, Tasks, If/Else, Delay, Loop; KWP-Push registriert-erweiterbar) bauen. Jeder Flow ist als JSON-Graph persistiert, per natürlicher Sprache (DE) erstellbar, vor Aktivierung als **Dry-Run** testbar und innerhalb **24h zurückrollbar**. Schutz-Mechanismen (Loop-Guard, Rate-Limit, Idempotenz, Resume) verhindern Runaway-Automationen. ## Benötigte Screens | Screen [Route] | Kern-Inhalt | Archetyp | |---|---|---| | **Flow-/Node-Editor** [`/automations/:id/edit`] | Graph-Canvas (Knoten + Kanten) · Knoten-Katalog-Sidebar (filterbar nach Modul-Quelle, Drag-&-Drop oder Klick-Hinzufügen) · Knoten-Konfig-Panel mit **Klartext-Label** · Mini-Map · Toolbar (Zoom/Pan/Undo/Redo/Zentrieren/Auto-Layout) · Validation-Hinweise inline (unverbundener Knoten, Cycle-Warnung, fehlendes Pflichtfeld) · Save/Aktivieren/Deaktivieren · **Dry-Run-Auslöser** | **BESPOKE — schwerste UI** | | **Sprach-zu-Automation-Einstieg** [im Editor] | Text-/Spracheingabe-Feld · Live-Streaming-Antwort · KI-Flow-Vorschau im Canvas + Klartext-Beschreibung · Rückfragen bei Mehrdeutigkeit · Risiko-Hinweise · **Bestätigungs-/Anpassungs-Schritt (nie Auto-Aktivierung!)** · Beispiel-Prompts | Bespoke-Teil des Editors | | **Dry-Run-Vorschau** [Modal im Editor] | „Trifft X Datensätze" + erste 5 Beispiele · Schritt-für-Schritt-Simulation mit Klartext je Step (z. B. „Email würde an … gehen") · **Bestätigungs-Pflicht** ab >100 Datensätzen/Schritt (Schwelle tenant-konfigurierbar) | A5 + Simulations-Liste | | 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 | | Loop-/Rate-Schutz-Warnmodal | Schleifen-Erkennung mit **Abhängigkeits-Graph-Visualisierung** + „Beheben" · Anomalie-Pause-Hinweis (Klartext: „2.000-mal in 5 Min, typisch 5-10/Tag — pausiert") | A5 + Mini-Graph | *(Trigger-/Action-Library selbst sind Daten im Knoten-Katalog, kein eigener Screen. KWP-Push-Konfig → v2.)* ## Geplante Features (muss abgedeckt sein) - [ ] Vollständige Trigger-Library über alle Module (CRM, Lead, Sales, Projekte, Email, Forms, Booking, Kalender, Zeit, Webhook) im Knoten-Katalog gruppiert - [ ] Vollständige Action-Library (CRM, Notification, HTTP, Task, If/Else, Delay, Loop) + erweiterbare Registry (KWP-Push dockt v2 an) - [ ] Graph-Editor: Knoten hinzufügen/konfigurieren/löschen/duplizieren, Kanten erstellen/löschen, verschieben, Auto-Layout, Undo/Redo, Mini-Map - [ ] Klartext-Knoten-Labels + Klartext-Validation-Hinweise (unverbunden, Cycle, unvollständig) - [ ] Sprach-zu-Automation: Satz → Flow-Vorschlag mit Rückfragen, Existenz-Prüfung, Risiko-Hinweisen, Bestätigungs-Pflicht (Action-Boundary, nie Auto-Aktivierung) - [ ] Dry-Run mit Klartext-Wirkungsvorschau + Pflicht-Bestätigung ab Schwelle - [ ] 24h-Reverse-Window: angelegte Entitäten löschen / Status zurücksetzen / Tags rückgängig, Mail-Empfängerliste anzeigen (nicht zurückziehbar), Multi-Step-Confirm + Audit - [ ] Schutz: Loop-Guard (Abhängigkeits-Graph-Warnung), Rate-Limit + Anomalie-Pause, Idempotenz-Key, Resume-ab-Schritt mit Auto-Retry - [ ] Klartext-Diagnostik in allen Execution-Logs (Step-Status, Dauer, Input/Output) - [ ] Plattform- + Tenant-Templates mit Katalog und „aus Rule erstellen" - [ ] AutomationRule/Step/Execution/StepExecution/Credential/Template persistiert (Domäne 7); verschlüsselte AutomationCredentials ## Benötigte UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand) Graph-Canvas (Knoten + Kanten, Pan/Zoom), Knoten-Katalog-Panel (gruppiert/filterbar nach Modul), Knoten-Konfig-Panel (typ-abhängige Felder), Klartext-Knoten-Label-Renderer, Verbindungs-Erstell-Interaktion, Mini-Map, Editor-Toolbar (Zoom/Undo/Redo/Auto-Layout/Zentrieren), Inline-Validation-Badges/Hinweise, Sprach-/Text-Eingabefeld mit Streaming-Antwort, Beispiel-Prompt-Chips, Dry-Run-Vorschau-Liste (getroffene Datensätze + Beispiele), Bestätigungs-Modal (Confirm-Phrase-Variante), Step-by-Step-Timeline mit Status-Markern, 24h-Reverse-Button mit Countdown, Retry-/Resume-Buttons, Abhängigkeits-Graph-Mini-Visualisierung (Loop-Guard), Template-Karten mit Use-Case-Beschreibung, Status-Pills (aktiv/pausiert/Entwurf/fehlgeschlagen/übersprungen), Daten-Tabelle (sortierbar, paginiert), Empty-/Loading-/Permission-Denied-States (Klartext). ## Davids Delta (David füllt aus) - [ ] Überschriebene/geänderte Spec-Punkte: - [ ] Neue UI/UX-Entscheidungen: - [ ] Subframe-Screen-Link(s): - [ ] Offene Fragen an Dev: ## Dev-Nachzug (wir nach Davids Delta) - [ ] Spec/ENTITY-MODEL an Davids Entscheidungen angepasst: - [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen: - [ ] Plane-Ticket (R-P12a/b) aktualisiert: