# — Design Document **Status:** Draft **Last updated:** YYYY-MM-DD **Scope:** --- ## 0. Problem / motivating requirements ## 1. Current state (grounding) ## 2. Prior art / research ## 3. Proposed design - **Data model** — new/changed models, fields, migrations. - **API** — endpoints, request/response shape, who can call them. - **UI / UX** — screens, interactions, states. For timeline/visual features, link a mockup or an interactive artifact rather than describing pixels in prose. - **Permissions impact** — new roles/checks, or how it fits [PERMISSIONS.md](../PERMISSIONS.md). ## 4. Alternatives considered ## 5. Phasing - **Phase 1 (MVP):** the smallest version worth shipping. - **Phase 2:** … - **Later / maybe:** … ## 6. Cost & risk - **Effort:** - **Migration / data risk:** - **Perf / UX risk:** - **Blast radius:** ## 7. Open questions / decisions needed - [ ] …