Decisions

Why it is built this way

Architecture decision records. Short, dated notes on the structural choices: the context, the decision, and what it costs.

  1. 1. Record architecture decisions
  2. 2. A single OpenAPI contract is the source of truth
  3. 3. Business logic lives in a framework-agnostic service layer
  4. 4. Secrets come from the environment, never the repository
  5. 5. OpenAPI 3.1.0 with Schemathesis 3.1 support enabled
  6. 6. Switch the active backend with a Docker Compose profile
  7. 7. Three client apps, one contract, no backend awareness
  8. 8. Client apps share artefacts, not source