decisions
Decision index
Historical decisions remain readable as individual pages. Later decisions amend or supersede earlier ones; use the Architecture tab to distinguish accepted decisions from deployed capabilities.
| Number | Title | Status | Date |
|---|---|---|---|
| ADR-001 | Adopt Modular Monolith (Service-Based) Architecture Over Microservices for Phase 1 | Accepted | 2026-05-10 |
| ADR-002 | Use Next.js Hybrid SSR/SSG as Frontend and Backend-for-Frontend (BFF) | Accepted | 2026-05-10 |
| ADR-003 | Use Clerk for Authentication Over Custom Auth or Auth0 | Accepted | 2026-05-10 |
| ADR-004 | Use Single PostgreSQL Database with Typed Product Extension Tables | Accepted | 2026-05-10 |
| ADR-005 | Defer Redis to Phase 2; Use Next.js Fetch Cache and PostgreSQL in Phase 1 | Accepted | 2026-05-10 |
| ADR-006 | Use Railway as Primary Cloud Platform Managed via Terraform | Accepted | 2026-05-10 |
| ADR-007 | Use Scheduled Jobs with Manual Upload for Data Ingestion Over Live Partner APIs | Superseded | 2026-05-10 |
| ADR-008 | Use Railway Persistent Volume for Documents in Phase 1; Migrate to Cloudflare R2 at Defined Threshold | Accepted | 2026-05-10 |
| ADR-009 | Use ISR for Category and Filter Pages; SSR for Comparison Pages | Accepted | 2026-05-10 |
| ADR-010 | Branch-to-Environment CI/CD: 3-Branch Gitflow with develop, staging, and main | Superseded | 2026-05-10 |
| ADR-011 | Trunk-Based Development with a Single Production Environment | Superseded | 2026-05-20 |
| ADR-012 | Replace Express/TypeScript API with Python FastAPI | Accepted | 2026-05-20 |
| ADR-013 | Staging and Production Environments with Manual Promotion | Accepted | 2026-05-25 |
| ADR-014 | Browser Data Fetching: Same-Origin Proxy via BFF Route Handlers | Accepted | 2026-05-25 |
| ADR-015 | First-party session cookie for engagement tracking | Accepted | 2026-05-26 |
| ADR-016 | Lightweight admin auth via HTTP Basic for the editor inbox | Accepted | 2026-05-26 |
| ADR-017 | Development lifecycle on OpenSpec, shared across agent tools | Accepted | 2026-10-19 |
| ADR-018 | Product data is maintained through the CMS | Accepted | 2026-10-20 |