⚠️ Veraltet (Stand 2026-04-30)
Diese Dokumentation beschreibt das alte System vor dem Process-Engine-Refactor (Phase 4.7). Die zugrundeliegenden Tabellen (cascade_*, concept_instances/bausteine, crisis_scenarios/events/tasks, workflow_*) wurden gedroppt. Die hier dokumentierten Routen und Models existieren so nicht mehr.
Aktuelle Architektur: Process-Engine API — eine Engine, mehrere Apps (flow.*, concept.*, crisis.*).
Diese Datei bleibt als historische Referenz erhalten.
Erster Workflow: Schritt fuer Schritt
In dieser Anleitung bauen wir gemeinsam einen einfachen Workflow. Das Ziel: Wenn eine Krise aktiviert wird, soll automatisch ein Matrix-Krisenraum erstellt werden.
Voraussetzung
Sie sind im Portal angemeldet und haben den Workflow-Designer ueber Ablaeufe → n8n Workflows → Workflow-Designer oeffnen gestartet.
Schritt 1: Neuen Workflow anlegen
- Klicken Sie in der linken Sidebar auf "+ Workflow"
- Geben Sie einen Namen ein: "Mein erster Krisen-Workflow"
- Sie sehen eine leere Arbeitsflaeche mit einem "+" Button in der Mitte
Schritt 2: Trigger hinzufuegen
Der Trigger bestimmt, wann der Workflow startet.
- Klicken Sie auf das "+" in der Mitte
- Suchen Sie nach "Webhook"
- Waehlen Sie "Webhook" aus
- Im rechten Panel konfigurieren Sie:
- HTTP Method: POST
- Path:
crisis-activated
Dieser Node wartet darauf, dass Prilog ihm sagt: "Eine Krise wurde aktiviert."
Schritt 3: Aktion hinzufuegen
Jetzt fuegen wir hinzu, was passieren soll.
- Klicken Sie auf das "+" rechts neben dem Webhook-Node
- Suchen Sie nach "HTTP Request"
- Konfigurieren Sie:
- Method: POST
- URL:
PRILOG_API_URL/api/platform/v1/n8n-callback/events/[eventId]/create-room - Headers: Content-Type: application/json
Dieser Node ruft Prilog zurueck und sagt: "Erstelle jetzt den Krisenraum fuer dieses Event."
Geht das auch einfacher?
Ja — der Prilog-Node erspart Ihnen das Eintippen der URL. Stattdessen waehlen Sie aus einem Dropdown "Krise → Matrix-Raum erstellen" und fuellen die Felder aus.
Schritt 4: Testen
- Klicken Sie oben auf "Test Workflow"
- n8n wartet jetzt auf den Webhook
- Aktivieren Sie im Portal eine Krise
- Sie sehen, wie die Daten durch die Nodes fliessen — gruen heisst erfolgreich
Schritt 5: Aktivieren
- Klicken Sie oben rechts auf den Schalter (von grau auf gruen)
- Der Workflow ist jetzt aktiv und reagiert auf echte Events
Glueckwunsch — Sie haben Ihren ersten Workflow gebaut!
Die wichtigsten Bausteine (Nodes)
n8n bietet Hunderte von Nodes. Fuer Prilog-Workflows brauchen Sie vor allem diese:
Trigger-Nodes (Start)
| Node | Wofuer |
|---|---|
| Webhook | Reagiert auf Ereignisse von Prilog (Krise aktiviert, Task erledigt, etc.) |
| Schedule | Startet den Workflow regelmaessig (z.B. jeden Montag um 8:00) |
| Manual | Startet den Workflow per Klick (zum Testen) |
| Matrix Trigger | Reagiert auf neue Chat-Nachrichten in Matrix-Raeumen |
Aktions-Nodes
| Node | Wofuer |
|---|---|
| Prilog | Bequemer Custom-Node fuer alle Prilog-Operationen — siehe Prilog-Node |
| HTTP Request | Generischer API-Call (auch fuer Prilog-Callbacks) |
| Wait | Wartet eine bestimmte Zeit (z.B. 3 Minuten fuer Eskalation) |
| Send Email | Sendet eine E-Mail (z.B. Benachrichtigung an Eltern) |
| Set | Setzt oder veraendert Daten im Workflow |
Logik-Nodes
| Node | Wofuer |
|---|---|
| IF | Bedingung pruefen ("Sind noch Tasks offen?") |
| Switch | Mehrfach-Verzweigung ("Welcher Schweregrad?") |
| Loop Over Items | Etwas fuer jedes Element wiederholen |
| Merge | Zwei Pfade zusammenfuehren |
Tipps fuer den Einstieg
Klein anfangen. Bauen Sie erst einen einfachen Workflow mit 2-3 Nodes. Testen Sie ihn. Erweitern Sie dann.
Testen, testen, testen. Nutzen Sie den "Test Workflow" Button bevor Sie einen Workflow aktivieren. So sehen Sie genau, welche Daten fliessen.
Kopieren statt neu bauen. Oeffnen Sie einen der 10 Standard-Workflows und passen Sie ihn an. Das ist einfacher als bei Null zu starten.
Wartezeiten grosszuegig setzen. Im Alltag dauern Dinge laenger als gedacht. Lieber 10 Minuten Eskalationszeit als 2.
Dokumentieren Sie Ihre Workflows. Geben Sie jedem Node einen sprechenden Namen. "Tasks erstellen" ist besser als "HTTP Request 3".
Wie geht es weiter?
- Der Prilog-Node — der bequeme Weg fuer alle Prilog-Operationen
- Workflows als Szenario importieren — eigene Workflows in der Szenarien-Liste verfuegbar machen
- Chat automatisieren — Matrix-Nachrichten verarbeiten