ADR-073 — Database migrations

Architecture decision record — status: Accepted.

Source: docs/adr/ADR-073-migrations.md

ADR-073: Database migrations

Estado

Accepted — 2026-08-23

Decisión

  1. Solo Prisma Migrate (ADR-008). SQL ad hoc en prod prohibido.
  2. Una migración por change/PR cuando cambie el schema. Nombre descriptivo kebab.
  3. Expand/contract para breaking: añadir columna → deploy → backfill → quitar vieja (PRs separados si hace falta).
  4. make check / CI aplica migrate en DB de test.
  5. Seed ≠ migrate (ADR-052). Seeds no se corren en production.
  6. Rollback: migrate down solo en local; prod = forward-fix.

DOC-006 es el modelo lógico; el historial real es prisma/migrations/.