ADR-025 — Local Docker environment

Architecture decision record — status: Accepted.

Source: docs/adr/ADR-025-local-docker.md

ADR-025: Local Docker environment

Estado

Accepted — 2026-08-23

Contexto

Humanos y agentes deben levantar Postgres + Redis iguales. ADR-016 exige fachada make.

Decisión

  1. Docker Compose para infra: PostgreSQL (ADR-003) + Redis (ADR-022).
  2. Node/pnpm en el host (o Dev Container opcional). No es obligatorio dockerizar Nest/Next en local el día 1.
  3. Targets (cuando exista scaffolding):
    • make install — pnpm install + prisma generate
    • make local-up — compose up
    • make local-down
    • make check — lint + typecheck + test
  4. Versiones fijadas en compose (imagen tag, no latest).
  5. .env.example en git; .env nunca (ADR-015).
  6. Node ≥ 20.19 (ya requerido por OpenSpec).

Alternativas

Instalar Postgres/Redis nativos en cada máquina: se descarta (onboarding y agentes).

Consecuencias

  • DOC-011 se actualiza con este contrato. Los YAML de compose no se escriben hasta el change de scaffolding.