Bausteinsicht Tutorial

Architekturdokumentation veraltet schneller als Code. Architecture-as-Code ist der Versuch, das zu ändern — und Bausteinsicht löst das Problem auf eine Weise, die andere Tools nicht können.

Bausteinsicht installieren, ein Projekt initialisieren, das erste Diagramm generieren und in beide Richtungen synchronisieren — in unter 10 Minuten.

Alle Felder und Sektionen des Bausteinsicht-Datenmodells: specification, model, views, relationships und optionale Erweiterungen wie asIs/toBe, dynamicViews und constraints.

Wie der Bausteinsicht-Sync-Algorithmus funktioniert: Forward-Sync, Reverse-Sync, Konfliktauflösung, Relationship-Lifting und die .bausteinsicht-sync State-Datei.

Wie Bausteinsicht mehrere Diagrammperspektiven (Context, Container, Component) aus einem einzigen Modell erzeugt — mit Scope-Bounding-Boxes, Drill-Down-Links und Rücknavigation.

Bausteinsicht als Exportzentrale: PNG/SVG via draw.io CLI, PlantUML, Mermaid C4, DOT, D2, HTML5, Structurizr DSL, AsciiDoc/Markdown-Tabellen und Sequenzdiagramme.

Architekturzustände mit bausteinsicht snapshot festhalten, vergleichen und wiederherstellen — plus changelog für automatisches Architektur-Changelog aus der Git-History.

Architekturregeln als maschinenprüfbare Constraints definieren und mit bausteinsicht lint + health automatisch in der CI-Pipeline durchsetzen.

bausteinsicht-lsp bringt Inline-Validierung, Fehlermeldungen und CodeLens direkt in VS Code — plus JSON Schema als schlanke Alternative ohne LSP-Setup.

Bausteinsicht als LLM-freundliche CLI: --format json für maschinenlesbare Ausgabe, bausteinsicht find und status als Kontext-Lieferanten für KI-Assistenten wie Claude Code.

Architecture Decision Records direkt im Bausteinsicht-Modell verknüpfen: ADRs in der Specification definieren, an Elemente und Beziehungen hängen, und mit bausteinsicht adr list/show navigieren.

Externe Metriken wie Error-Rate, Coverage oder Latenz als Heatmap auf draw.io-Elemente legen — und mit einem Befehl wieder entfernen.

bausteinsicht graph analysiert den Abhängigkeitsgraphen: Zyklen erkennen, Zentralitätsmetriken berechnen, stark zusammenhängende Komponenten identifizieren.

bausteinsicht layout berechnet hierarchisches Auto-Layout für draw.io-Diagramme — mit Pinning für Elemente die manuell positioniert bleiben sollen.

bausteinsicht generate-template erstellt eine draw.io-Template-Datei mit visuellen Stilen für alle Element-Typen — in vier Presets: default, c4, minimal, dark.

Mehrere Team-Modelle mit einer workspace.jsonc kombinieren: workspace merge, validate und list — plus Cross-Model Relationships zwischen Teilsystemen.

Dynamische Views in architecture.jsonc definieren und mit bausteinsicht export-sequence als PlantUML oder Mermaid-Sequenzdiagramm exportieren.

Elemente, Beziehungen, Views und Spezifikationstypen direkt über die Kommandozeile zum Modell hinzufügen — ohne die JSONC-Datei manuell zu editieren.

bausteinsicht health bewertet die Architektur in fünf Kategorien und gibt einen Score von 0–100 plus Note A+ bis F — für Dashboards, PRs und Architektur-Reviews.

Das status-Feld in Bausteinsicht-Elementen: proposed bis archived im Modell verwalten, mit bausteinsicht status filtern und im Health Score auswerten.

asIs und toBe Sektionen in architecture.jsonc für Migrationsplanung — und bausteinsicht diff für den annotierten Vergleich von Ist- und Zielarchitektur.

bausteinsicht find durchsucht das Modell per Freitext — bausteinsicht show zeigt alle Details eines Elements inklusive Beziehungen und Views.

Tags in specification.tags definieren, Elementen zuweisen und Views mit filter-tags und exclude-tags präzise befüllen — ohne jedes Element einzeln in include aufzulisten.

Bausteinsicht in GitHub Actions: validate als Build-Gate, diff als PR-Kommentar und automatischer SVG-Export — mit vollständigen Workflow-YAMLs zum Copy-Pasten.

Bestehende Architekturdokumentation zu Bausteinsicht migrieren: was bei draw.io, PlantUML-C4 und Structurizr automatisch geht, was manuell überführt werden muss, und warum eine View-by-View-Strategie besser funktioniert als ein Big Bang.

Mehrere Personen am gleichen Modell: welche Teile des JSONC merge-freundlich sind, wie Ownership-Conventions Konflikte vermeiden, und wie ein Architektur-Review im Pull Request aussieht.

Über C4 hinaus: eigene Elementtypen mit eigenen Shapes in draw.io definieren — am Beispiel einer AUTOSAR-Notation und einer Embedded-Hardware-Notation.

Bausteinsicht mit 50+ Elementen: wann braucht man fokussierte Views statt einer Gesamtansicht, wie teilt man ein gewachsenes Modell in Subsysteme auf, und wann ist das Workspace-Feature die richtige Lösung.

Das Big Bank Example von Simon Brown (Structurizr) in drei Schritten nach Bausteinsicht migrieren — mit bausteinsicht import --from structurizr, vollständigem Walkthrough des generierten JSONC und visuellem Ergebnis.

Dasselbe JSONC-Modell, sieben verschiedene Diagramme: wie man aus einem Big Bank Modell fokussierte Views für Security-Team, Mobile-Entwickler und Stakeholder erzeugt — ohne das Modell zu duplizieren.