Docker Compose (Development)

Services

# PostgreSQL
db:
  image: postgres:15-alpine
  port: 5432
  volume: pgdata
  healthcheck: pg_isready

# Backend API
backend:
  build: ./backend
  port: 8000
  depends_on: db (healthy)
  auto-runs: alembic upgrade head on start
  volume: live reload

# Frontend
frontend:
  build: ./frontend
  port: 5173
  volume: live reload

Commands

make docker-up     # Start all services (build + detached)
make docker-down   # Stop all services
make docker-seed   # Create admin user in container
make docker-logs   # Tail logs

CI/CD Pipeline

GitHub Actions runs on pull requests to master:

Backend Job

• Ubuntu + Python 3.14 (allow-prereleases)
• PostgreSQL 15-alpine service container
• Runs: pytest -x --tb=short

Frontend Job

• Ubuntu + Node 22
• Runs: npm run lint + npm run build

Production Checklist

• [ ] Set a strong, random SECRET_KEY
• [ ] Set LOG_LEVEL=INFO (not DEBUG)