Publiziert:
Zuletzt aktualisiert:
C4 Model und Docs-as-Code
Architektur-Diagramme veralten oft schnell. Das C4 Model bietet eine standardisierte Methode zur Beschreibung von Systemen auf verschiedenen Abstraktionsebenen (Context, Containers, Components, Code).
Kernkonzept
Diagramme werden als Code (z. B. via Mermaid oder PlantUML) erstellt und direkt im Git-Repository neben dem Quellcode gepflegt (Docs-as-Code). Dies garantiert, dass die Dokumentation Teil des Entwicklungsprozesses bleibt.
Anwendung
- Level 1 (Context): Wer nutzt das System und welche Umsysteme sind angebunden?
- Level 2 (Container): Welche Applikationen (Web, API, DB) bilden das Gesamtsystem?
- Mermaid-Integration: Visualisierung direkt in Markdown-Dateien für nahtlose Migration zu Grav.