methodatlas
Architecture

C4 Model

Macht System, Container und Bausteine in abgestuften Sichten lesbar und erleichtert Architekturkommunikation.

Kernfrage
Auf welcher Abstraktionsebene welcher Leser welche Architektur-Information aus dem Diagramm zieht?
NiedrigWorkshop + Async1-4 h
Runsheet öffnenSession planenVergleich starten
Zweck

Das C4 Model macht ein System über mehrere Auflösungsebenen lesbar, vom Kontext bis zum Code. Es eignet sich, wenn verschiedene Zielgruppen dieselbe Architektur aus unterschiedlichen Höhen verstehen sollen.

Funktionsweise

Zuerst wird der Systemkontext mit Menschen, Nachbarsystemen und Grenzen beschrieben. Danach werden Container, Components und bei Bedarf Code-Sicht ergänzend dargestellt. So bleibt die Architektur auf jeder Ebene anschlussfähig, ohne in einem einzigen Diagramm zu viel zu überladen.

Visuelle Orientierung

Methodenskizze für ein schnelles Grundgefühl.

C4 Model · Zoom-in von Kontext bis CodeVier Ebenen vom Systemkontext bis zur Implementierung
C4 ModelVier Architektur-Ebenen zeigen den Zoom vom Systemkontext über Container und Components bis zum optionalen Code-Level.Architektur über vier Zoomstufen erklärenJede Ebene beantwortet eine andere Frage, ohne alle Details in ein Diagramm zu pressen.ZoomZoombei BedarfC1System ContextWer nutzt welches System?PersonNutzerSystemim FokusExternNachbarC2ContainerApps, APIs und DatenstoresWeb AppUIAPIBackendDatabaseDatenWorkerJobsC3ComponentBausteine im ContainerControllerEingangServiceLogikPolicyRegelnRepositoryPersistenzAdapterIntegrationC4CodeKlassen, Module, TestsService.tsModulPolicy.tsRegelRepo.tsDatenTestsBelegeSequenzDetailpfad

Ablauf

  1. 1System Context zeichnen
  2. 2Container identifizieren
  3. 3Wichtige Container in Components zerlegen
  4. 4Code-Level nur bei Bedarf ergänzen

Das Runsheet führt mit 5 Phasen, Timeboxen, 6 Stolperfallen und klaren Abbruchkriterien durch die Umsetzung.

Runsheet öffnen

Ideal für

  • Architecture Communication
  • Onboarding
  • Design Reviews

Nicht gut für

  • Domain Discovery
  • Strategische Marktanalyse

Vertiefung

Im Detail

Das C4 Model funktioniert, weil es dieselbe Architektur in abgestuften Auflösungen zeigt und dadurch verschiedene Zielgruppen ohne Diagrammüberladung abholt. Gute Anwendung hält die Abstraktion je Ebene diszipliniert und vermeidet Mischbilder aus Kontext, Container und Detail. Wirksam wird der Ansatz, wenn Beziehungen, Verantwortungen und Schnittstellen pro Sicht so klar werden, dass Verständnisfragen schneller gelöst und falsche Annahmen früher entdeckt werden.

Durchführung

Kläre vorab, welche Sicht für welches Gespräch gebraucht wird, damit ihr nicht aus Gewohnheit alles gleichzeitig zeichnet. Ein tragender Moment entsteht dort, wo eine Ebene nicht mehr reicht und bewusst zur nächsten gewechselt wird. Schließe mit einem kompakten Satz gepflegter Sichten und klaren Regeln, wann welche davon aktualisiert werden muss.

Output-Artefakte
Context DiagramContainer DiagramComponent Diagram
Tags
diagramsarchitecturecommunicationvisualization

Quellen

Introduction | C4 modelc4model.com
In Playbooks
Architekturdokumentation aufbauenVon verstreutem Architekturwissen zu Views, Entscheidungen und kommunizierbarer Dokumentation.
Artefakt-Vorlagen
C4 Model ArbeitsvorlageKompakte Arbeitsvorlage für C4 Model mit Kontext, Input, Ergebnisartefakten und nächstem Schritt.
canvas

c4-model-working-template.md

Kompakte Arbeitsvorlage für C4 Model mit Kontext, Input, Ergebnisartefakten und nächstem Schritt.

C4 Model Canvas

Kontext

Wofür wird die Methode eingesetzt?

Kernfrage

Welche Frage soll am Ende beantwortet sein?

Input

Welche Daten, Beobachtungen oder Materialien liegen vor?

Arbeitsfläche

  • Bereich 1:
  • Bereich 2:
  • Bereich 3:
  • Beziehungen / Muster:

Ergebnisartefakte

  • Context Diagram:
  • Container Diagram:
  • Component Diagram:

Offene Fragen

  • ...

Nächster Schritt

Owner, Datum, Erfolgssignal.

Wann stattdessen?

Kurze Entscheidungshilfe für vorhandene Alternativen.

Views and Beyond

Statt C4 Model, wenn du Architektur mit mehreren Sichten für Dokumentation und Stakeholder systematisch beschreiben willst.

Ähnliche Methoden

Alle Methoden
Architecture
arc42

Strukturiert Architekturwissen über Ziele, Kontext, Laufzeit und Deployment zu einer lebendigen Systemdokumentation.

Architecture
Views and Beyond

Verbindet mehrere Sichten auf große Systeme und hält Cross-view-Informationen für das Gesamtbild fest.

Statt C4 Model, wenn du Architektur mit mehreren Sichten für Dokumentation und Stakeholder systematisch beschreiben willst.

Architecture
Architecture Communication Canvas

Bereitet Stakeholder, Kernbotschaften und Artefakte so auf, dass Architekturkommunikation gezielt anschließt.

Architecture
Architecture Decision Record

Dokumentiert eine Architekturentscheidung mit Kontext, Alternativen und Konsequenzen, damit spätere Reviews nachvollziehbar bleiben.

Architecture
Quality Attribute Workshop

Sammelt Qualitätsziele, priorisiert Risiken und macht daraus Architekturthemen, die gemeinsam bewertet werden.

Architecture
Architecture Inception Canvas

Bündelt Problem, Ziele, Stakeholder und Risiken zu einem Startbild, das frühe Architekturfragen sortiert.