Structurizr DSL

Ausführliche Erklärung

Structurizr DSL wurde von Simon Brown, dem Erfinder des C4-Modells, entwickelt und bildet die Referenzimplementierung für die code-basierte Erstellung von C4-Architektur-Diagrammen. Die Sprache folgt dem "models as code"-Prinzip: Anstatt Architekturdiagramme manuell in grafischen Werkzeugen zu zeichnen, beschreiben Sie Ihr System textuell in einer strukturierten DSL-Datei. Der Parser generiert daraus automatisch verschiedene Ansichten wie System-Context-, Container- und Komponenten-Diagramme.

Der zentrale Vorteil liegt in der Konsistenz: Sie definieren Systeme, Komponenten und deren Beziehungen nur einmal im Modell. Änderungen werden automatisch in allen Diagrammen reflektiert, wodurch Inkonsistenzen zwischen verschiedenen Ansichten vermieden werden. Die textbasierte Definition ermöglicht zudem Versionierung in Git, Code-Reviews der Architektur und kollaborative Bearbeitung. Structurizr DSL unterstützt auch erweiterte Funktionen wie die Einbindung externer Modelle, Dokumentation in Markdown oder AsciiDoc sowie Architecture Decision Records (ADRs).

Für KMU ist Structurizr DSL besonders relevant, wenn Softwarearchitektur formal dokumentiert und kommuniziert werden soll – etwa bei komplexen Individualsoftware-Projekten, regulatorischen Anforderungen oder Onboarding neuer Entwickler:innen. Die Lösung ist unter Apache-2.0-Lizenz kostenfrei verfügbar. Seit Anfang 2026 sind die früher getrennten Werkzeuge Structurizr Lite und Structurizr CLI in einem einzigen Tool zusammengeführt; die lokale Nutzung erfolgt über dessen local-Kommando beziehungsweise das bereitgestellte Docker-Image, was volle Datenkontrolle ermöglicht. Für Teams stehen daneben der kostenpflichtige Cloud-Service und eine On-Premises-Installation zur Verfügung. Allerdings erfordert die DSL eine gewisse Einarbeitungszeit und setzt voraus, dass das Team bereit ist, Architektur als Code zu behandeln.

Die Integration in CI/CD-Pipelines ermöglicht es, Architekturdiagramme automatisch zu generieren und zu validieren. Für Teams, die bereits mit Infrastructure as Code arbeiten, ist der Ansatz besonders naheliegend. Die Strukturierung nach dem C4-Modell stellt sicher, dass Diagramme auf die jeweils relevante Zielgruppe zugeschnitten sind – von der Management-Ebene bis zu einzelnen Entwickler:innen.

Code-Beispiel

workspace {
  model {
    user = person "Kunde"
    erp = softwareSystem "ERP System" {
      web = container "Web App" "React"
      api = container "API" "Node.js"
      db = container "Datenbank" "PostgreSQL"
      
      web -> api "API-Calls (HTTPS)"
      api -> db "Liest/Schreibt"
    }
    user -> web "Verwendet"
  }
  
  views {
    systemContext erp {
      include *
      autolayout lr
    }
  }
}