Prilog Handbuch

Appearance

⚠️ 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.

Spaces & Benutzer verwalten ​

n8n kann nicht nur Krisen orchestrieren — Sie koennen auch Spaces erstellen, Benutzer auflisten und Mitgliedschaften verwalten. Das ist ideal fuer Onboarding und Schuljahres-Beginn.

Bequemer Weg: Prilog-Node

Alle Operationen auf dieser Seite sind im Prilog-Node als Resource verfuegbar — ohne URLs eintippen zu muessen. Diese Seite zeigt die HTTP-Request-Variante, falls Sie volle Kontrolle brauchen.

Tenant-ID ermitteln ​

Fast alle Admin-Callbacks brauchen eine tenantId — eine eindeutige Kennung Ihrer Schule in Prilog. Sie sieht aus wie cmneba0nv000fzxazefimnlvt und ist fuer Ihre Schule fest und einmalig.

Schnellster Weg

Im Portal unter Ablaeufe → n8n Workflows wird Ihre Tenant-ID prominent angezeigt — Sie koennen sie mit einem Klick kopieren.

Alternativ via API:

  • URL: PRILOG_API_URL/api/platform/v1/n8n-callback/tenant-info?matrixDomain=ihre-schule.prilog.team
  • Method: GET

Antwort:

{
  "orderId": "ORD-...",
  "tenantId": "cmneba0nv000fzxazefimnlvt",
  "matrixDomain": "ihre-schule.prilog.team"
}

Tenant-ID als n8n-Variable speichern

Speichern Sie die tenantId einmalig in den n8n-Variablen (Settings → Variables) als TENANT_ID. Dann koennen Sie in jedem Workflow [$vars.TENANT_ID] verwenden, ohne sie jedes Mal nachzuschlagen. Das ist die saubere Loesung.

Space erstellen ​

  • URL: PRILOG_API_URL/api/platform/v1/n8n-callback/spaces/create
  • Method: POST
  • Body (JSON):
{
  "tenantId": "[Ihre Tenant-ID]",
  "name": "Klasse 5a",
  "type": "GENERAL",
  "visibility": "PRIVATE",
  "chatEnabled": true,
  "filesEnabled": true,
  "membersEnabled": true,
  "moderationEnabled": false
}

Optionale Felder:

  • parentSpaceId — fuer verschachtelte Spaces (Klasse 5a unter Mittelstufe)
  • roomsEnabled — Unter-Raeume erlauben

Antwort: Der erstellte Space mit ID, Name, Typ.

Spaces auflisten ​

  • URL: PRILOG_API_URL/api/platform/v1/n8n-callback/spaces?tenantId=[ID]
  • Method: GET

Gibt alle Spaces des Tenants zurueck — nuetzlich um pruefen, ob ein Space schon existiert bevor Sie einen neuen anlegen.

Benutzer auflisten ​

  • URL: PRILOG_API_URL/api/platform/v1/n8n-callback/users?tenantId=[ID]
  • Method: GET

Liefert alle Benutzer mit userId, username, fullName, email, userType. Filterbar in n8n mit einem IF- oder Filter-Node, z.B. nach userType === 'Lehrkraft'.

Benutzer einem Space hinzufuegen ​

  • URL: PRILOG_API_URL/api/platform/v1/n8n-callback/spaces/[spaceId]/members
  • Method: POST
  • Body:
{
  "userId": "@mueller:ihre-schule.prilog.team",
  "role": "MEMBER"
}

Verfuegbare Rollen: OWNER, ADMIN, MANAGER, MEMBER, GUEST

Beispiel: Klassen-Generator ​

Ein Workflow, der mit einem Klick alle Klassen einer Jahrgangsstufe anlegt:

Manual Trigger
    ↓
Set Node: classes = ["5a", "5b", "5c", "5d"]
    ↓
Loop Over Items: fuer jede Klasse
    ↓
HTTP Request: POST /spaces/create
    Body: { tenantId, name: "Klasse [item]" }
    ↓
HTTP Request: GET /users?tenantId=...
    ↓
Filter Node: nur User mit userTypeKey = "lehrkraft"
    ↓
Loop: fuer jede Lehrkraft
    ↓
HTTP Request: POST /spaces/[spaceId]/members
    Body: { userId: [user.userId], role: "MANAGER" }

Mit einem Klick haben Sie alle 5. Klassen angelegt und alle Lehrkraefte als Manager hinzugefuegt.

Beispiel: Schuljahres-Onboarding ​

Schedule Trigger: 1. August jeden Jahres um 8:00
    ↓
HTTP Request: GET /spaces?tenantId=...
    ↓
Filter: Spaces mit Praefix "Klasse" und Jahrgangsstufe -1
    ↓
Loop: fuer jeden alten Klassen-Space
    ↓
HTTP Request: POST /spaces/create
    Body: { name: "[alter Name + 1 Jahr]", parentSpaceId: ... }
    ↓
HTTP Request: Mitgliedschaften aus altem Space lesen
    ↓
Loop: alle Mitglieder in den neuen Space uebertragen

So uebernimmt n8n den jaehrlichen Schuljahreswechsel komplett automatisch.

Vorsicht beim Loeschen

Es gibt aktuell keinen Callback fuer das Loeschen von Spaces oder Benutzern. Das ist Absicht — diese Operationen sollen bewusst manuell im Portal erfolgen, um versehentliche Datenverluste zu vermeiden.

Weitere Workflow-Ideen ​

Krisen sind nur der Anfang. Mit n8n koennen Sie viele Schulablaeufe automatisieren:

Eltern-Rundbrief ​

Zeitplan: Jeden Freitag um 14:00
    → Sammle alle neuen Dokumente der Woche
    → Erstelle eine Zusammenfassung
    → Sende E-Mail an alle Eltern

Aufgaben-Erinnerung ​

Zeitplan: Taeglich um 8:00
    → Pruefe ueberfaellige Aufgaben
    → Wenn ueberfaellig: Sende Erinnerung im Chat

Neuer-Schueler-Onboarding ​

Webhook: Neuer Benutzer angelegt
    → Fuege zu Standard-Spaces hinzu
    → Sende Willkommensnachricht
    → Erstelle Eltern-Einladung

Krankmeldungs-Workflow ​

Webhook: Krankmeldung eingegangen
    → Informiere Klassenleitung
    → Aktualisiere Anwesenheitsliste
    → Bei 3. Tag: Informiere Schulleitung