Was ist das C4-Modell?

Das C4-Modell ist ein Satz von vier Diagrammen über ein System, jedes eine nähere Ansicht als das vorige. Sein eigentlicher Beitrag ist nicht das Zeichnen, sondern die Reihenfolge. Jede Ebene beantwortet eine Frage, und diese Antwort wirft die Frage auf, für die es die nächste Ebene gibt.

Das Publikum wird enger, je tiefer Sie gehen. Ebene 1 ist für alle, die ein Interesse am System haben, auch für Menschen, die nie Code lesen werden. Ebene 4 ist für das Team, in einer Woche, in der es etwas umbaut. Dieses Gefälle ist das Argument dafür, die ersten beiden zu zeichnen und aufzuhören, bis jemand nach mehr fragt.

Das ist der Teil, der verloren geht. C4 definiert keine Formen, Linienstile oder Beziehungssemantik. Es sagt Ihnen, was auf welches Diagramm gehört und für wen es ist, und dann: zeichnen Sie es so, wie Ihr Team ohnehin zeichnet.

Die praktische Folge ist, dass C4 sich mit der Notation kombiniert, die Sie haben, statt sie zu ersetzen. Ein Containerdiagramm, mit UML-Komponenten gezeichnet, ist zugleich ein legales UML-Diagramm und ein korrektes C4-Diagramm. In ArchiMate gezeichnet, bildet sich derselbe Inhalt auf Anwendungskomponenten und Technologieknoten ab. Beides ist in Ordnung. Nicht in Ordnung ist ein Diagramm, dessen Kästen drei verschiedene Dinge bedeuten, weil niemand gesagt hat, welche Ebene es war.

Weil es keine Notation zu prüfen gibt, muss die Disziplin von woanders kommen: beschriften Sie jeden Kasten damit, was er ist, jede Linie damit, was sie tut und über welches Protokoll, und mischen Sie nie zwei Ebenen auf einer Fläche. Diese drei Regeln erledigen das meiste von dem, was sonst eine Spezifikation für Sie täte.

C4 ist älter als Dockers Vorherrschaft und benutzt Container im älteren, allgemeinen Sinn: etwas, das laufen muss, damit das System funktioniert, und das für sich deployt werden kann. Eine Single-Page-Anwendung ist ein Container. Ebenso eine Datenbank, eine Serverless-Funktion, ein Message Broker und eine mobile App.

Auf Ebene 2 liegt der meiste Wert, und es ist die Ebene, die Teams überspringen - zum Teil wegen des Namens und zum Teil, weil es das erste Diagramm ist, das eine echte Entscheidung darüber erzwingt, was das System eigentlich ist. Der Artikel zum Containerdiagramm arbeitet eines von Anfang bis Ende durch.

Ein Satz C4-Diagramme hat dasselbe Versagensmuster wie jede andere Architekturdokumentation: am Tag des Zeichnens korrekt und ein halbes Jahr später still falsch. Zwei Dinge helfen, und keines davon handelt vom Zeichnen.

Das erste ist, die Ebenen in einem Modell zu halten statt in vier unverbundenen Bildern. Wenn die API auf Ihrem Kontextdiagramm und die API auf Ihrem Containerdiagramm dasselbe Element sind, ist Umbenennen eine Änderung; sind es zwei Kästen, die zufällig eine Beschriftung teilen, sind es zwei Änderungen und eine wird vergessen. Das ist das Argument für ein Modell hinter den Sichten, und es ist dasselbe Argument, das ein Modell aktuell zu halten ausführlich macht.

Das zweite ist, weniger Ebenen zu zeichnen. Ein Kontext- und ein Containerdiagramm, die stimmen, schlagen vier Ebenen, von denen zwei Fiktion sind. Besonders Ebene 4 sollte aus dem Code erzeugt oder weggelassen werden - ein handgezeichnetes Klassendiagramm ist die Momentaufnahme einer Meinung, und der Compiler hat eine aktuellere.