Seminar Structurizr Local (ehemals Lite): Installation und Autorenworkflow

Der lokale Autorenprozess wird von einer leeren Arbeitsumgebung bis zum stabilen Zusammenspiel aus DSL, JSON und manuellem Diagrammlayout aufgebaut. Besondere Aufmerksamkeit gilt der sicheren Ablage und dem schnellen Feedback bei Modelländerungen.

Inhaltsverzeichnis

1. Einordnung
2. Zielgruppe
3. Voraussetzungen
4. Lernziele
5. Seminarinhalte
6. Praxisfall und Übungsartefakte

Einordnung

Structurizr Local ist für die Arbeit auf dem eigenen Rechner vorgesehen und entspricht funktional dem früheren Lite-Ansatz. Es arbeitet direkt mit Dateien im Datenverzeichnis und besitzt keine Authentifizierungs-, Autorisierungs- oder Kollaborationsfunktionen. Diese Grenze wird im Seminar ausdrücklich berücksichtigt.

Zielgruppe

Softwarearchitektinnen und Softwarearchitekten, Entwicklerinnen und Entwickler, technische Leads sowie Personen, die Structurizr-Workspaces lokal erstellen, anzeigen oder layouten.

Voraussetzungen

Grundkenntnisse der Structurizr DSL. Für die Containerübung sind grundlegende Docker-Kenntnisse hilfreich; alternativ kann eine Java-Anwendung verwendet werden.

Lernziele

• Structurizr Local reproduzierbar starten und das Datenverzeichnis korrekt einbinden.
• Das Zusammenspiel von workspace.dsl und workspace.json sicher erklären und anwenden.
• Manuelle Layoutinformationen speichern und bei DSL-Änderungen erhalten.
• Auto-Refresh und relevante Konfigurationsparameter passend zum Workflow einstellen.
• Typische Ursachen für verlorene Layouts, falsche Pfade und nicht geladene Workspaces beheben.

Seminarinhalte

1. Betriebsgrenze und Installationsvarianten

Zunächst wird Local gegenüber Server und dem früheren Lite-Produkt abgegrenzt.

1. Einzelplatz-, Team- und Publikationsanforderungen gegenüberstellen.
2. Container- und Java-Variante nach lokaler Umgebung auswählen.
3. Datenverzeichnis, Port und Dateiberechtigungen vorbereiten.

2. Erster Start und Workspace-Erkennung

Eine minimale Arbeitsumgebung wird eingerichtet und kontrolliert gestartet.

1. workspace.dsl im Datenverzeichnis anlegen.
2. Local starten und Parse- sowie Ladezustand prüfen.
3. Priorität von DSL- und JSON-Datei anhand eines kontrollierten Tests nachvollziehen.

3. Layout speichern und erhalten

Manuelle Diagrammanordnung wird als JSON-Repräsentation gesichert.

1. Elemente in der Oberfläche positionieren und Workspace speichern.
2. Entstehende workspace.json prüfen und versionierbare Anteile einordnen.
3. DSL ändern, neu laden und die Übernahme vorhandener Layoutinformationen kontrollieren.

4. Auto-Refresh und Arbeitsgeschwindigkeit

Der Autorenzyklus aus Ändern, Speichern und Prüfen wird verkürzt.

1. Konfigurationsdatei im Datenverzeichnis anlegen.
2. Auto-Refresh-Intervall passend zur Arbeitsweise setzen.
3. Editor und Browser nebeneinander für einen schnellen Feedbackzyklus organisieren.

5. Fehleranalyse und sichere Arbeitsweise

Typische Störungen werden reproduziert und mit einer Diagnosefolge behoben.

1. Pfad-, Dateinamen-, Port- und Berechtigungsfehler systematisch eingrenzen.
2. Layoutverlust durch instabile View-Keys oder umbenannte Elemente analysieren.
3. Gleichzeitige Zugriffe auf dasselbe Datenverzeichnis vermeiden und eine sichere Arbeitsregel festlegen.

Praxisfall und Übungsartefakte

Ein Beispiel-Workspace wird lokal gestartet, manuell layoutet, gespeichert, verändert und erneut geladen. Die Übung endet mit einer lauffähigen Local-Konfiguration und einer Diagnosecheckliste.