Architecture documentation index (Arc42-style)
Purpose
Section titled “Purpose”External reviews sometimes expect a single architectural “book”. This site intentionally distributes architecture across multiple pages. This index maps the classic Arc42 section headings to existing URLs so reviewers can navigate in one place. Content is not duplicated here—only pointers.
Arc42 → this site
Section titled “Arc42 → this site”| Arc42 section | What reviewers expect | Where it lives here |
|---|---|---|
| 1. Introduction and goals | Problem, stakeholders, quality goals | Introduction — Overview, Start guide, NFR & SLO |
| 2. Constraints | Technical, organizational | Platform primer, Environment matrix, Stack |
| 3. Context and scope | External systems, boundaries | System context |
| 4. Solution strategy | Key technical decisions | Architecture decisions (ADR), ADR practice |
| 5. Building block view | Components / modules | System overview, Module catalog, Container view (C4) |
| 6. Runtime view | Request paths, concurrency | Request flow, Business logic flows |
| 7. Deployment view | Nodes, environments | Deployment & operations, Operational runbook, Cloudflare Pages (this site) |
| 8. Cross-cutting concepts | Security, logging | Security checklist, Threat model, Test evidence & CI |
| 9. Architecture decisions | ADRs | Architecture decisions |
| 10. Quality requirements | NFR, risks | Introduction overview — NFR template, NFR & SLO, Known issues & roadmap |
| 11. Risks and technical debt | Known issues & roadmap, Architecture decisions | |
| 12. Glossary | Terms | Glossary |
End-to-end business paths
Section titled “End-to-end business paths”For vertical slices (payments, payroll, Xero, incorporation, identity), use Critical paths (E2E).
Related
Section titled “Related”- Diagram roadmap — planned diagrams
- Documentation gap closure plan
- Handover completion checklist