Entry point for the docs/ tree. The repository-root README.md is the project
overview; the documents below are the detail it points to. Behavioural rules and conventions live in
../CLAUDE.md.
| Document | Purpose |
|---|---|
| architecture.md | System map: project layout, per-service tables, feature inventory, AI advisory/MCP design, Service Bus queues, EF migration matrix, external services. |
| glossary.md | Ubiquitous language — aggregates and core domain terms. |
| auth/role-model.md | Roles, ASP.NET authorization policies, ABAC handlers, MFA, token claims, and sub-derived identity. |
| ui-conventions.md | Binding visual/theming/MudBlazor/CSS reference for the Blazor client. |
| ../contracts/CONVENTIONS.md | Service contract conventions: typed HTTP clients and integration-event schemas. |
| Document | Purpose |
|---|---|
| adr/README.md | Architecture Decision Records — index and individual decisions with context and consequences. |
| assessments/README.md | Dated, immutable maturity snapshots of the project over time. |
| Document | Purpose |
|---|---|
| deploy-ordersphere.md | Azure deployment via azd: prerequisites, parameters, secrets, step-by-step, troubleshooting. |
| operations.md | Observability and operations runbook: traces, health checks, Aspire dashboard, resilience. |
| github/branching.md | Branching strategy and workflow. |
| github/branch-protection.md | Branch-protection ruleset and required status checks for master. |
| Document | Purpose |
|---|---|
| ../SECURITY.md | Security policy, vulnerability reporting, automated controls, trust boundaries. |
| ../CONTRIBUTING.md | Contribution workflow and local checks. |
| ../CHANGELOG.md | Notable changes (Keep a Changelog format). |