Bausteinsicht Tutorial on Paul Fleischmann

Teil 1: Was ist Architecture-as-Code — und warum macht Bausteinsicht es anders?

Thu, 11 Jun 2026 00:00:00 +0000

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.

Teil 2: Von 0 zum ersten Architekturdiagramm mit Bausteinsicht

Wed, 17 Jun 2026 00:00:00 +0000

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

Teil 3: Das JSONC-Datenmodell von Bausteinsicht im Detail

Thu, 18 Jun 2026 00:00:00 +0000

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

Teil 4: Bidirektionale Synchronisation — Wie draw.io und JSONC in sync bleiben

Fri, 19 Jun 2026 00:00:00 +0000

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

Teil 5: Multi-View — Mehrere Diagrammperspektiven aus einem Modell

Sat, 20 Jun 2026 00:00:00 +0000

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

Teil 6: Export-Features — Mermaid, Structurizr DSL, PNG und mehr

Sun, 21 Jun 2026 00:00:00 +0000

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

Teil 7: Snapshots & Changelog — Architektur über Zeit versionieren

Mon, 22 Jun 2026 00:00:00 +0000

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

Teil 8: Validation & Linting — Architekturregeln automatisch durchsetzen

Tue, 23 Jun 2026 00:00:00 +0000

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

Teil 9: LSP-Integration — Autovervollständigung im Editor

Wed, 24 Jun 2026 00:00:00 +0000

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

Teil 10: LLM/AI Workflows — KI-gestützte Architekturmodellierung

Thu, 25 Jun 2026 00:00:00 +0000

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.

Teil 11: ADR-Integration — Architecture Decision Records mit dem Modell verknüpfen

Fri, 26 Jun 2026 00:00:00 +0000

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.

Teil 12: Overlay & Heatmap — Metriken auf Architekturdiagramme legen

Sat, 27 Jun 2026 00:00:00 +0000

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

Teil 13: Graph-Analyse — Zyklen und Abhängigkeiten aufdecken

Sun, 28 Jun 2026 00:00:00 +0000

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

Teil 14: Auto-Layout — Diagramme automatisch anordnen

Mon, 29 Jun 2026 00:00:00 +0000

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

Teil 15: Templates — Eigene visuelle Stile definieren

Tue, 30 Jun 2026 00:00:00 +0000

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

Teil 16: Workspace — Mehrere Architekturmodelle kombinieren

Wed, 01 Jul 2026 00:00:00 +0000

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

Teil 17: Sequenzdiagramme — Dynamische Views als PlantUML und Mermaid exportieren

Thu, 02 Jul 2026 00:00:00 +0000

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

Teil 18: CLI-Modellierung — Architektur direkt per Kommandozeile aufbauen

Fri, 03 Jul 2026 00:00:00 +0000

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

Teil 19: Health Score — Architekturqualität mit A–F bewerten

Sat, 04 Jul 2026 00:00:00 +0000

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.

Teil 20: Element-Lifecycle — Status von proposed bis archived verfolgen

Sun, 05 Jul 2026 00:00:00 +0000

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

Teil 21: As-Is / To-Be — Zielarchitektur direkt im Modell definieren

Mon, 06 Jul 2026 00:00:00 +0000

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

Teil 22: find & show — Das Modell navigieren und Elemente erkunden

Tue, 07 Jul 2026 00:00:00 +0000

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

Teil 23: Tags & View-Filterung — Elemente organisieren und Views gezielt befüllen

Wed, 08 Jul 2026 00:00:00 +0000

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.

Teil 24: CI/CD Integration — validate, diff und Export in GitHub Actions

Thu, 09 Jul 2026 00:00:00 +0000

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

Teil 25: Migration — Von draw.io, PlantUML und Structurizr zu Bausteinsicht

Fri, 10 Jul 2026 00:00:00 +0000

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.

Teil 26: Team-Workflows — Merge-Konflikte, Ownership und Architektur-Reviews im PR

Sat, 11 Jul 2026 00:00:00 +0000

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.

Teil 27: Custom Notations — Eigene Elementtypen, Shapes und Domain-Sprachen

Sun, 12 Jul 2026 00:00:00 +0000

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

Teil 28: Performance bei großen Modellen — Scoping, Partial Views und Subsysteme

Mon, 13 Jul 2026 00:00:00 +0000

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.

Teil 29: Real-Life-Beispiel — Structurizr Big Bank mit bausteinsicht import

Tue, 14 Jul 2026 00:00:00 +0000

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.

Teil 30: Mehr Views aus einem Modell — fokussierte Diagramme pro Publikum

Wed, 15 Jul 2026 00:00:00 +0000

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.

Mon, 01 Jan 0001 00:00:00 +0000