SAF | Technology RadarSAF | Technology Radar

C4 model

c4
Adopt

A good architecture design is fundamental to build a stable, scalable and sustainable software system. Documenting this architecture such way that we provide required level of information to all stakeholders had always been a challenge.

The C4 model provides a hierarchical approach to architecture documentation through four levels of abstraction: Context, Container, Component, and Code. This methodology enables teams to create clear, consistent architecture diagrams that serve different stakeholder needs - from high-level system overviews for executives to detailed component designs for developers.

We generate C4 models using Structurizr, implementing an architecture-as-code approach. This enables teams to:

  • Define architecture models using textual DSL (Domain-Specific Language) within their IDE
  • Version control architecture documentation alongside source code
  • Automatically generate consistent, maintainable diagrams
  • Easily update and evolve architecture documentation as the system changes