Seminar Structurizr Local: Multi-Workspace, Konfiguration und Teamkonventionen

Mehrere Softwaresysteme werden so organisiert, dass gemeinsame Landschaftsinformationen wiederverwendet und systembezogene Workspaces unabhängig bearbeitet werden können. Technische Konfiguration und Teamregeln werden gemeinsam entwickelt.

Inhaltsverzeichnis

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

Einordnung

Local ist ein Einzelplatzwerkzeug, kann aber mehrere Workspaces aus einer strukturierten Ablage anzeigen. Für Teams entsteht Zusammenarbeit deshalb über Versionsverwaltung, eindeutige Ownership und getrennte Arbeitskopien, nicht über gleichzeitige Bearbeitung desselben Datenverzeichnisses.

Zielgruppe

Software- und Enterprise-Architects, Architekturteams, Plattformteams sowie Verantwortliche für gemeinsame Architecture-as-Code-Repositories.

Voraussetzungen

Praktische Erfahrung mit Structurizr Local und Structurizr DSL. Grundkenntnisse zu Includes, Workspace-Erweiterung und Versionsverwaltung sind hilfreich.

Lernziele

• Mehrere Workspaces in einer nachvollziehbaren lokalen Verzeichnisstruktur betreiben.
• Workspace-Pfad und Dateiname gezielt konfigurieren.
• Gemeinsame Landschaften und systembezogene Workspaces sauber trennen.
• Layoutdateien, Ressourcen und Dokumentation ohne Kollisionen organisieren.
• Ownership-, Branching- und Merge-Regeln für die teamgestützte Einzelplatzarbeit festlegen.

Seminarinhalte

1. Zielstruktur für mehrere Workspaces

Die Ablage wird aus Systemgrenzen, Ownership und Wiederverwendungsbedarf abgeleitet.

1. Gemeinsame Landschaft, System-Workspaces und geteilte Ressourcen identifizieren.
2. Verzeichnis- und Dateinamenskonvention festlegen.
3. Zugriffs- und Änderungsverantwortung je Teilbereich dokumentieren.

2. Multi-Workspace-Konfiguration

Local wird so konfiguriert, dass mehrere Workspaces kontrolliert auswählbar sind.

1. Datenverzeichnis und Multi-Workspace-Modus vorbereiten.
2. Workspace-Pfade und abweichende Dateinamen testen.
3. Fehlende, doppelte oder falsch priorisierte Dateien diagnostizieren.

3. Gemeinsame Landschaft mit Workspace-Erweiterung

Ein Basismodell wird für mehrere System-Workspaces nutzbar gemacht.

1. Stabile Bezeichner und Eigentumsgrenzen im Basis-Workspace definieren.
2. System-Workspace an das Basismodell anbinden.
3. Änderungen an gemeinsamen Elementen gegen abhängige Workspaces prüfen.

4. Layouts, Dokumentation und Ressourcen trennen

Dateien mit unterschiedlichem Lebenszyklus werden so abgelegt, dass keine ungewollten Überschreibungen entstehen.

1. workspace.json je Workspace eindeutig zuordnen.
2. Dokumentation, ADRs, Bilder und Themes mit relativen Pfaden organisieren.
3. Layouts nach Umbenennungen, Verschiebungen und Merge-Vorgängen verifizieren.

5. Teamkonventionen und sichere Zusammenarbeit

Der technische Aufbau wird durch verbindliche Arbeitsregeln ergänzt.

1. Getrennte Arbeitskopien und keine parallelen Zugriffe auf dasselbe Datenverzeichnis festlegen.
2. Branch-, Review- und Merge-Prozess für Modell und Layout definieren.
3. Freigabekriterien für die Veröffentlichung auf Server dokumentieren.

Praxisfall und Übungsartefakte

Eine lokale Portfoliostruktur mit gemeinsamem Landschaftsmodell und mehreren System-Workspaces wird aufgebaut. Enthalten sind Local-Konfiguration, Layouttrennung, Ownership-Matrix und Merge-Checkliste.