Back to the vitrínavitrinkaThe architecture · Diagrams

The architecture

Drawn from what's true.

Architecture read out of your repository rather than out of somebody's memory — and re-read whenever the repository changes.

01

compose, OpenAPI, SQL

The diagram is generated from sources you already maintain, so it describes the system that exists rather than the one that was designed.

  • Your real configdocker-compose, an OpenAPI spec, a SQL schema, or a live database.
  • Already maintainedthese are files you keep current anyway, so the diagram inherits that.
  • Not from memorynobody redraws the architecture by hand, so nobody forgets a service.

02

The server arranges it

You describe what things are and how they relate. Where the boxes go is explicitly not your problem.

  • You send semanticslanes, groups, typed nodes, ports and edges — the meaning, not the geometry.
  • Never coordinateslayout is computed, so a diagram cannot be broken by adding one more node.

03

Run it again

Re-generate after a change and the diagram catches up with the code, which is the whole reason it is worth having one.

  • Refreshableregenerating is the maintenance story; there is no manual redraw.
  • Deep linksa node can be linked from the page that explains it, and back again.