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) filtrandeleted_at IS NULL. - La unicidad del
codigose 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); unDELETEfísico rompería la auditoría y las referencias. - No validar duplicados — el
UNIQUEde 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_idy RLS. - Los demás catálogos globales replicarán este patrón en slices siguientes.
- OpenAPI expone 3 endpoints nuevos.