ADR-046 — Environments and configuration

Architecture decision record — status: Accepted.

Source: docs/adr/ADR-046-environments.md

ADR-046: Environments and configuration

Estado

Accepted — 2026-08-23

Decisión

AmbienteUsoDatos
localDev + agentesCompose; fixtures
stagingCuando exista VPS de pruebaAnonimizados / seed
productionPiloto y payingReales

Variables por ambiente (ADR-015):

  • DATABASE_URL, REDIS_URL
  • JWT_SECRET, ENCRYPTION_KEY (mailbox tokens)
  • SENTRY_DSN, AI_API_KEY
  • APP_URL, API_URL
  • Flags default (ADR-033)

Reglas:

  • .env.example completo en git; .env no.
  • Mismo nombre de variables en los tres ambientes.
  • NODE_ENV=production no se usa en local.
  • Staging no comparte DB ni Redis con production.
  • DOC-016 lista la matriz; el scaffolding crea el example.

No hay development cloud separado de staging en V1 (equipo chico).