Technical Documentation

This section covers the technical architecture of the application: how it is structured, how it handles authentication, how data is organised, and the key decisions that shaped the design.

Sections

Architecture

The system architecture described using the C4 model, from the high-level system context down to the internal components of each module.

Security

Authentication and authorisation — the OAuth2 flow, Keycloak organisation routing, and how roles are mapped from tokens to application permissions.

Database

The database schema structure, module ownership rules, and the migration strategy.

Decision Records

A log of the key architectural decisions made during the design of the system, with context and rationale.