Architecture Decision RecordsΒΆ
Architecture Decision Records (ADRs) capture significant technical decisions made during the design and development of Curaway. Each record documents the context, decision, rationale, alternatives considered, and consequences so that future contributors understand why the system looks the way it does.
Status key: Accepted | Superseded | Deprecated
| ADR | Title | Status | Date | Session |
|---|---|---|---|---|
| ADR-0001 | Railway PostgreSQL over Neon | Accepted | 2026-03-10 | 6 |
| ADR-0002 | Voyage AI over OpenAI Embeddings | Accepted | 2026-03-20 | 11 |
| ADR-0003 | PyMuPDF-First OCR Strategy | Accepted | 2026-03-22 | 23B |
| ADR-0004 | SSE over Polling for Real-Time Chat | Accepted | 2026-03-24 | 23B |
| ADR-0005 | Lazy Case Creation | Accepted | 2026-03-26 | 22 |
| ADR-0006 | Records-First Intelligence | Accepted | 2026-03-26 | 21 |
| ADR-0007 | Conversation-First UX | Accepted | 2026-03-26 | 17/22 |
| ADR-0008 | DNS-Only Cloudflare Mode | Accepted | 2026-03-24 | 23B |
| ADR-0009 | Metabase OSS Self-Hosted on Railway | Accepted | 2026-03-22 | -- |
| ADR-0010 | Synchronous OCR before Orchestration | Accepted | 2026-03-25 | 23B |