Seminar Kroki – Mermaid, BPMN und Excalidraw

Abläufe, Interaktionen und Fachprozesse mit passenden Notationen darstellen

Mermaid, BPMN und Excalidraw verfolgen unterschiedliche Ziele. Mermaid eignet sich für kompakte textuelle Darstellungen, BPMN für formalere Fachprozesse und Excalidraw für freiere, skizzenhafte Darstellungen. Das Seminar schafft klare Auswahlregeln und zeigt den gemeinsamen Renderingweg über Kroki.

Zwei Tage sind erforderlich, um nicht nur Syntaxbeispiele zu erzeugen, sondern Prozessgrenzen, Ereignisse, Verantwortlichkeiten, alternative Pfade, Layout und Qualitätsprüfung in einer gemeinsamen Fallstudie zu behandeln.

Inhaltsübersicht

• Auswahl zwischen Mermaid, BPMN und Excalidraw
• Mermaid-Flowcharts und Sequenzdiagramme
• Zustands-, Klassen- und Gantt-Darstellungen in Mermaid
• BPMN-Ereignisse, Aufgaben, Gateways und Verantwortungsbereiche
• Excalidraw-Daten für freie Skizzen und Workshops
• Companion-Dienste und Kroki-Endpunkte
• Layout, Optionen, Ausgabe und Dokumentationsintegration
• Prozessreview und zusammenhängende Fallstudie

Zielgruppe

Das Seminar richtet sich an Business-Analysten, Prozessmanager, Entwickler, Architekten, technische Redakteure und Projektteams. Es ist geeignet, wenn sowohl technische Abläufe als auch fachliche Prozesse und frühe Skizzen dokumentiert werden müssen.

Voraussetzungen

Erforderlich sind Grundkenntnisse zu Abläufen oder Geschäftsprozessen. BPMN-Vorwissen ist hilfreich, aber nicht zwingend. Grundlegende Kroki-API-Kenntnisse werden im Seminar wiederholt.

Lernstrecke Schritt für Schritt

1. Schritt 1: Notation anhand der Aussage auswählen. Formalisierungsgrad, Änderungsrate, Zielgruppe und benötigte Semantik entscheiden zwischen Mermaid, BPMN und Excalidraw.
2. Schritt 2: Mermaid-Flowchart aufbauen. Knoten, Richtungen, Verzweigungen, Gruppen und Beschriftungen werden für einen überschaubaren Prozess eingesetzt.
3. Schritt 3: Interaktionen als Sequenz darstellen. Beteiligte, Nachrichten, Antworten, Alternativen und Schleifen werden modelliert. Technische Details bleiben auf den Zweck der Darstellung begrenzt.
4. Schritt 4: Zustände und Übergänge modellieren. Status, Ereignisse, Bedingungen und Endzustände werden für ein fachliches Objekt beschrieben und mit Prozessschritten abgeglichen.
5. Schritt 5: Zeitpläne und Abhängigkeiten darstellen. Ein Gantt-Beispiel zeigt Phasen, Termine und Abhängigkeiten. Die Darstellung wird als Kommunikationsmittel, nicht als vollständiges Planungssystem eingeordnet.
6. Schritt 6: BPMN-Prozessgrenzen festlegen. Start- und Endereignisse, Aufgaben, Sequenzflüsse und Verantwortungsbereiche werden aus einer fachlichen Beschreibung abgeleitet.
7. Schritt 7: Gateways und Ausnahmewege modellieren. Exklusive, parallele und ereignisbasierte Entscheidungen werden passend verwendet. Fehler- und Eskalationspfade bleiben nachvollziehbar.
8. Schritt 8: Excalidraw-Daten über Kroki rendern. Eine vorbereitete freie Skizze wird als strukturierte Zeichnungsquelle verarbeitet. Eignung für Workshopstände und formale Dokumentation wird abgegrenzt.
9. Schritt 9: Companion-Dienste prüfen. Gateway und benötigte Renderer werden funktional getestet. Fehlende Dienste, Zeitüberschreitungen und inkompatible Quellen werden unterschieden.
10. Schritt 10: Diagrammoptionen und Layout kontrollieren. Sprachspezifische Einstellungen, Maße, Schrift und Ausgabeformat werden reproduzierbar gesetzt. Unzulässige oder sicherheitskritische Optionen werden vermieden.
11. Schritt 11: Dokumentation und Versionierung integrieren. Quellen, gerenderte Ausgaben, Beschreibungen und Freigabestand werden gemeinsam organisiert.
12. Schritt 12: Eine Prozessfallstudie konsolidieren. Workshopskizze, formale BPMN-Sicht und technische Mermaid-Sequenz werden auf gemeinsame Begriffe, Grenzen und Verantwortlichkeiten geprüft.

Praxisaufgaben

• Einen Ablauf als Mermaid-Flowchart und als Sequenzdiagramm darstellen.
• Aus einer fachlichen Beschreibung einen BPMN-Prozess mit Ausnahmeweg ableiten.
• Eine Excalidraw-Skizze über Kroki rendern und ihren Dokumentationsstatus kennzeichnen.
• Companion-Ausfall und Syntaxfehler anhand unterschiedlicher Symptome diagnostizieren.
• Drei Darstellungen derselben Fallstudie begrifflich und fachlich konsolidieren.

Kompetenzziele

• Mermaid, BPMN und Excalidraw nach Formalisierungsgrad und Zielgruppe auswählen.
• Technische Abläufe, Zustände und Zeitpläne mit Mermaid modellieren.
• Fachprozesse mit BPMN-Ereignissen, Aufgaben, Gateways und Verantwortungsbereichen strukturieren.
• Excalidraw-Daten als freie, versionierbare Skizzenquelle einordnen.
• Companion-Dienste, Rendering, Layout und Qualitätsreview über Kroki beherrschen.