Čo je model C4?

Model C4 je súbor štyroch diagramov nad jedným systémom, každý bližší pohľad než ten predchádzajúci. Jeho skutočným prínosom nie je kreslenie - je to poradie. Každá úroveň odpovedá na otázku a tá odpoveď otvorí otázku, kvôli ktorej existuje úroveň ďalšia.

Ako klesáte, publikum sa zužuje. Úroveň 1 je pre kohokoľvek, koho systém zaujíma, vrátane ľudí, ktorí nikdy neprečítajú kód. Úroveň 4 je pre tím, v týždni, keď niečo prestavuje. Ten spád je argumentom pre to, aby ste nakreslili prvé dve a zastavili sa, kým niekto nepožiada o viac.

Práve toto sa stráca. C4 nedefinuje tvary, štýly čiar ani sémantiku vzťahov. Hovorí vám, čo patrí na ktorý diagram a pre koho je, a potom dodá: nakreslite to tak, ako váš tím kreslí veci aj tak.

Praktickým dôsledkom je, že C4 sa skladá s notáciou, ktorú už máte, namiesto toho, aby ju nahrádzal. Diagram kontajnerov nakreslený UML komponentmi je zároveň legálnym UML diagramom aj správnym C4 diagramom. Nakreslený v ArchiMate sa ten istý obsah mapuje na aplikačné komponenty a technologické uzly. Oboje je v poriadku. V poriadku nie je diagram, ktorého boxy znamenajú tri rôzne veci, lebo nikto nepovedal, o ktorú úroveň ide.

Keďže tu nie je notácia na kontrolu, disciplína musí prísť odinakiaľ: označte každý box tým, čo je, označte každú čiaru tým, čo robí a akým protokolom, a nikdy nemiešajte dve úrovne na jednom plátne. Tie tri pravidlá spravia väčšinu práce, ktorú by inak za vás spravila špecifikácia.

C4 vznikol pred nadvládou Dockeru a používa slovo kontajner v jeho staršom, všeobecnom význame: vec, ktorá musí bežať, aby systém fungoval, a ktorá sa dá nasadiť samostatne. Jednostránková aplikácia je kontajner. Rovnako aj databáza, serverless funkcia, message broker a mobilná aplikácia.

Úroveň 2 je tam, kde je väčšina hodnoty, a je to tá úroveň, ktorú tímy vynechávajú - čiastočne kvôli názvu a čiastočne preto, že je to prvý diagram, ktorý si vynúti skutočné rozhodnutie o tom, čím systém vlastne je. Článok o diagrame kontajnerov jeden taký prechádza od začiatku do konca.

Sada C4 diagramov má rovnaký spôsob zlyhania ako každá iná architektonická dokumentácia: v deň nakreslenia je presná a o pol roka ticho nesprávna. Pomáhajú dve veci a ani jedna nie je o kreslení.

Prvou je držať úrovne v jednom modeli, nie v štyroch nesúvisiacich obrázkoch. Ak je API na vašom kontextovom diagrame a API na diagrame kontajnerov ten istý prvok, premenovanie je jedna úprava; ak sú to dva boxy, ktoré náhodou zdieľajú popisku, premenovanie sú dve úpravy a na jednu sa zabudne. To je argument pre model za pohľadmi a je to ten istý argument, ktorý zoširoka rozvádza udržiavanie modelu aktuálnym.

Druhou je kresliť menej úrovní. Kontextový diagram a diagram kontajnerov, ktoré sú pravdivé, sú lepšie než štyri úrovne, z ktorých dve sú fikcia. Najmä úroveň 4 by sa mala generovať z kódu alebo vynechať - ručne kreslený diagram tried je snímka názoru a kompilátor má aktuálnejší.