Architecture Decision Records¶
Records for decisions the SRS left open or that shape the Tauri refactor. Each ADR states context, the decision, and consequences. Status is Accepted unless noted.
| ADR | Title | Decision summary |
|---|---|---|
| 001 | Tauri-mediated sidecar access | Renderer reaches the sidecar only through allowlisted Tauri commands |
| 002 | Preserve Python domain + SQLite | Port existing scoring/week/migrations verbatim |
| 003 | Query/cache library | TanStack Query with explicit invalidation |
| 004 | UI + accessibility approach | Hand-rolled accessible components, no heavy UI kit |
| 005 | OpenAPI → TypeScript | Generated types as build artifacts + drift check |
| 006 | Startup credential transport | Token via env var / stdin, never argv |
| 007 | Readiness endpoint auth | /health and /ready unauthenticated (no sensitive data) |
| 008 | Blank weekly review persistence | Get-or-create returns a transient blank, not persisted |
| 009 | Zero-active-project portfolio score | Portfolio score is 0 when no scores exist |
| 010 | macOS sidecar architecture | Per-arch PyInstaller binaries, universal later |
| 011 | Markdown/Mermaid rendering | Render in React with bundled libraries, offline |