Architektura

Kreslené z toho, co platí.

Architektura vyčtená z vašeho repozitáře, ne z něčí paměti — a přečtená znovu pokaždé, když se repozitář změní.

compose, OpenAPI, SQL

Diagram se generuje ze zdrojů, které stejně udržujete, takže popisuje systém, který existuje, ne ten, který se navrhoval.

Vaše reálná konfigurace — docker-compose, OpenAPI, SQL schéma nebo živá databáze.
Už tak udržované — jsou to soubory, které držíte aktuální — diagram to po nich zdědí.
Ne po paměti — nikdo architekturu nepřekresluje ručně, takže na službu nikdo nezapomene.

Popíšete, co věci jsou a jak spolu souvisí. Kam přijdou boxy, výslovně neřešíte.

Posíláte význam — dráhy, skupiny, typované uzly, porty a hrany — smysl, ne geometrii.
Nikdy souřadnice — rozvržení se počítá, takže diagram nerozbijete přidáním jednoho uzlu.

Po změně vygenerujte znovu a diagram dožene kód — což je celý důvod, proč se vyplatí ho mít.

Obnovitelné — generování je celá údržba; žádné ruční překreslování.
Hluboké odkazy — na uzel lze odkázat ze stránky, která ho vysvětluje, a zase zpátky.