6.7 KiB
Designer-Brief · P12 — Automation-Engine
Phase: 12/21 · Modul: M17 · Owner-Dev: Raffael (R-P12a/b) · Designer: David (D-Automation, Paket Fr 03.07.)
Aktive Quellen: zugehörige Ticket-Docs · ROADMAP.md/ROADMAP-V2.md · REQUIREMENTS.md · ENTITY-MODEL.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-/AD-32-Grenze: KWP-Push ist nur ein nicht ausführbarer Extension-Slot. Eine ausführbare Action und KWP-spezifisches Konfig-UI dürfen erst nach
VEXT-6plus erneuter ausdrücklicher Produktfreigabe folgen; der initiale Phase-32-Scope bleibt read-only. 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 nur als nicht ausführbarer Extension-Slot) 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 nur nach VEXT-6 + erneuter Produktfreigabe.)
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 bleibt bis
VEXT-6+ erneuter Produktfreigabe ohne Adapter/Handler nicht ausführbar - 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/ROADMAP nachgezogen:
- Plane-Ticket (R-P12a/b) aktualisiert: