Architectural Decision Records (ADRs)
This folder contains the Architectural Decision Records (ADRs) for the Open Projects Hub. An ADR captures a significant architectural decision, the context that led to it, and the consequences.
Decision Log
| ADR ID | Title |
|---|---|
| ADR-001 | High-Level Architecture Pattern (Modular Monolith) |
| ADR-002 | Backend Framework (FastAPI) |
| ADR-003 | Frontend Framework (React + TypeScript) |
| ADR-004 | Database (Amazon RDS PostgreSQL) |
| ADR-005 | Authentication and Authorization Strategy (Custom Auth + JWT) |
| ADR-006 | Deployment Platform (AWS), superseded in part by ADR-021 |
| ADR-007 | ORM Choice (SQLAlchemy) |
| ADR-008 | Build Tooling (Vite + Docker) |
| ADR-009 | Monitoring and Observability (Sentry + CloudWatch) |
| ADR-010 | Testing Framework Strategy (Pytest, Vitest, Playwright) |
| ADR-011 | Secrets Management Strategy |
| ADR-012 | Containerization Strategy (Docker) |
| ADR-013 | Infrastructure as Code Strategy (Terraform) |
| ADR-014 | Environment Strategy (Local / Container / Dev) |
| ADR-015 | Code Quality Tooling Strategy |
| ADR-016 | Git Workflow and Branch Strategy |
| ADR-017 | Database Migration Strategy (Alembic) |
| ADR-018 | User API Key Encryption at Rest |
| ADR-019 | Do Not Persist Draft Stories |
| ADR-020 | Client Review by Project Access Code (No Viewer Accounts) |
| ADR-021 | Low-Cost Single-Host Deployment (CloudFront + EC2), entry point replaced by ADR-022 |
| ADR-022 | Cloudflare Edge Instead of CloudFront |
| ADR-023 | Credits Account in us-east-2 and Manual Deploys (No GitHub OIDC) |
Creating a New ADR
Use the ADR Template for all new decisions.
Related Documents
Last Updated: 2026-10-10