Architekturmodelle, technische Dokumentation, Entscheidungen und Befunde bleiben mit ihren Quellen verbunden. Die schematischen Beispiele zeigen den Aufbau solcher Ergebnisse.
Ein Architekturmodell, das aus dem Code stammt
Bausteine, Schnittstellen und Datenbanktabellen werden aus dem Repository, dem Datenbankschema und den Deployment-Deklarationen abgeleitet. Daraus entstehen C4-, Klassen-, Sequenz- und ER-Diagramme. Weicht der Code später ab, zeigt die Drift-Prüfung die Stelle.
Modell v12 · Quelle: Repository-Stand 3f2c…, Schema-Snapshot 2026-10
Container Webanwendung ── REST ──▶ Abrechnungsdienst ── JDBC ──▶ PostgreSQL
Drift 1 Abweichung: neuer Endpunkt /app/v1/masks ohne Modellbaustein
Dokumentation, die mit dem Projekt wächst
Technische Dokumentation nach arc42 wird aus Modell, Entscheidungen und Quellen erzeugt und versioniert. Jede Fassung nennt den Code-Stand, aus dem sie stammt. Kein PDF vom Projektstart, das niemand mehr pflegt.
arc42 · Fassung 7 · 2026-10-20 · Abschnitte 1–12 vollständig
Geändert gegenüber Fassung 6: Bausteinsicht (3 Bausteine), Laufzeitsicht (1 Ablauf), Entscheidung ADR-006
Entscheidungen mit Kontext und Lebenszyklus
Jede Architekturentscheidung hat Kontext, Optionen, Begründung und Status. Wird sie später ersetzt, bleibt die alte Entscheidung mit Datum erhalten. So weiß ein Team auch nach Jahren, warum etwas so gebaut ist.
ADR-005 · Herkunftsdaten additiv in der Feldtabelle · Status: angenommen 2026-10-27
Kontext: Verlauf braucht Akteur, Quelle und Grund · Optionen: neue Tabelle / Spalten im Dokument / additive Spalten
Entscheidung: additive, optionale Spalten; Dokumentinhalt und Prüfsummen bleiben unverändert
Befunde mit Entscheidung
Sicherheits- und Qualitätsbefunde aus statischer Analyse, Abhängigkeitsprüfung und Review werden gesammelt und einzeln entschieden: beheben, akzeptieren mit Begründung oder zurückstellen mit Termin. Nichts versandet in einem Report.
Befund Q-0412 · Abhängigkeit mit bekannter Schwachstelle · Schwere: hoch
Disposition: behoben am 2026-10-14 (Version angehoben) · Nachweis: Prüflauf 38126 grün