Co je model C4?

Model C4 je soubor čtyř diagramů nad jedním systémem, každý bližší pohled než ten předchozí. Jeho skutečným přínosem není kreslení - je to pořadí. Každá úroveň odpovídá na otázku a ta odpověď otevře otázku, kvůli které existuje úroveň další.

Jak klesáte, publikum se zužuje. Úroveň 1 je pro kohokoli, koho systém zajímá, včetně lidí, kteří nikdy nepřečtou kód. Úroveň 4 je pro tým, v týdnu, kdy něco přestavuje. Ten spád je argumentem pro to, abyste nakreslili první dvě a zastavili se, dokud někdo nepožádá o víc.

Právě tohle se ztrácí. C4 nedefinuje tvary, styly čar ani sémantiku vztahů. Říká vám, co patří na který diagram a pro koho je, a pak dodá: nakreslete to tak, jak váš tým kreslí věci tak jako tak.

Praktickým důsledkem je, že C4 se skládá s notací, kterou už máte, místo aby ji nahrazoval. Diagram kontejnerů nakreslený UML komponentami je zároveň legálním UML diagramem i správným C4 diagramem. Nakreslený v ArchiMate se tentýž obsah mapuje na aplikační komponenty a technologické uzly. Obojí je v pořádku. V pořádku není diagram, jehož boxy znamenají tři různé věci, protože nikdo neřekl, o kterou úroveň jde.

Protože tu není notace ke kontrole, disciplína musí přijít odjinud: označte každý box tím, co je, označte každou čáru tím, co dělá a jakým protokolem, a nikdy nemíchejte dvě úrovně na jednom plátně. Ta tři pravidla udělají většinu práce, kterou by za vás jinak udělala specifikace.

C4 vznikl před nadvládou Dockeru a používá slovo kontejner v jeho starším, obecném významu: věc, která musí běžet, aby systém fungoval, a která se dá nasadit samostatně. Jednostránková aplikace je kontejner. Stejně tak databáze, serverless funkce, message broker a mobilní aplikace.

Úroveň 2 je tam, kde je většina hodnoty, a je to ta úroveň, kterou týmy vynechávají - zčásti kvůli názvu a zčásti proto, že je to první diagram, který si vynutí skutečné rozhodnutí o tom, čím systém vlastně je. Článek o diagramu kontejnerů jeden takový prochází od začátku do konce.

Sada C4 diagramů má stejný způsob selhání jako každá jiná architektonická dokumentace: v den nakreslení je přesná a za půl roku tiše špatná. Pomáhají dvě věci a ani jedna není o kreslení.

První je držet úrovně v jednom modelu, ne ve čtyřech nesouvisejících obrázcích. Pokud je API na vašem kontextovém diagramu a API na diagramu kontejnerů tentýž prvek, přejmenování je jedna úprava; pokud jsou to dva boxy, které náhodou sdílejí popisek, přejmenování jsou dvě úpravy a na jednu se zapomene. To je argument pro model za pohledy a je to tentýž argument, který zeširoka rozvádí udržování modelu aktuálním.

Druhá je kreslit méně úrovní. Kontextový diagram a diagram kontejnerů, které jsou pravdivé, jsou lepší než čtyři úrovně, z nichž dvě jsou fikce. Zejména úroveň 4 by se měla generovat z kódu, nebo vynechat - ručně kreslený diagram tříd je snímek názoru a kompilátor má aktuálnější.