Access your teaching qualifications - Architecture

Both services are monolithic Rails apps built with the GOV.UK Design System. They share a single repository, database, and deployment pipeline. See routing two services for how requests are routed to the correct service.

C4 diagrams

We create architecture views of the application using the C4 diagramming method.

The diagram code can be found here and rendered here in Structurizr, Mermaid or PlantUML etc.

Architecture Decision Records (ADRs)

We keep track of architecture decisions in Architecture Decision Records (ADRs).

We use rladr to generate the boilerplate for new records:

bin/bundle exec rladr new title