Saltar a contenido

0011. CRUD de los catálogos globales — cuarto slice: monedas

Estado: Aceptado Fecha: 2026-09-29 Autor: Duval Alcivar Módulo(s) afectado(s): app/domains/catalogos/, tests/unit/catalogos/

Contexto

Los ADR 0008 a 0010 establecieron el patrón CRUD de los catálogos globales con países, tipos de identificación y géneros como primeros slices. Este ADR lo replica para las monedas, que como países tiene campo único codigo.

Decisión

  • POST /api/v1/catalogos/monedas — crea una moneda y responde 201 con el recurso creado.
  • PUT /api/v1/catalogos/monedas/{moneda_id} — actualización parcial con campos opcionales; responde 200.
  • DELETE /api/v1/catalogos/monedas/{moneda_id} — borrado lógico; responde 204.
  • El repository hace add/commit/refresh; el commit no vive en el router ni en el service.
  • Las lecturas (listar_monedas, obtener_moneda) filtran deleted_at IS NULL.
  • La unicidad del codigo se valida en el service (CodigoDuplicadoError) y ante duplicado responde 409, igual que países.

Alternativas descartadas

  • Esperar la administración autenticada — mismo razonamiento que en los ADR 0008 a 0010: los catálogos globales son públicos y sin RLS.
  • Borrado físico — el modelo usa borrado lógico (deleted_at); un DELETE físico rompería la auditoría y las referencias.
  • No validar duplicados — el UNIQUE de la base rechazaría el código repetido con un 500; validar en el service y responder 409 es una mejor experiencia de usuario.

Consecuencias

  • Supera parcialmente al ADR 0006: queda habilitada la escritura de otro catálogo global.
  • Feriados y bancos (por empresa) siguen esperando autenticación: llevan empresa_id y RLS.
  • Los demás catálogos globales replicarán este patrón en slices siguientes.
  • OpenAPI expone 3 endpoints nuevos.