Skip to content

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