0017. CRUD de los catálogos por empresa — primer slice: feriados¶
Estado: Aceptado Fecha: 2026-09-29 Autor: Duval Alcivar Módulo(s) afectado(s): app/domains/catalogos/, tests/unit/catalogos/
Contexto¶
Los ADR 0008–0016 cubrieron los catálogos globales (países, tipos de
identificación, géneros, monedas, provincias, ciudades) y el CRUD de
mae_empresas. Este ADR abre los catálogos por empresa: tablas que heredan
EmpresaMixin (id + empresa_id) y llevan política RLS (ADR 0012
transversal). cat_feriados es el primero. El empresa_id se acepta en el body
por ahora; cuando exista la capa de autenticación vendrá del token y se
documenta como pendiente.
Decisión¶
Se implementa el CRUD de cat_feriados bajo /api/v1/catalogos/feriados, con la
arquitectura de capas router -> service -> repository del ADR 0001 transversal:
POST /api/v1/catalogos/feriadoscrea con201;PUT /api/v1/catalogos/feriados/{feriado_id}actualiza parcialmente con200;DELETE /api/v1/catalogos/feriados/{feriado_id}elimina lógicamente con204.- El repository hace
add/commit/refreshy las lecturas filtrandeleted_at. - Validaciones:
empresa_iddebe existir enmae_empresas→404"Empresa no encontrada" (nueva excepciónEmpresaNoEncontradoError); el repository la valida consultandomae_empresas, como ya hace el dominioempresascon los catálogos.pais_iddebe existir →404(reutilizaPaisNoEncontradoError).- El par
(empresa_id, pais_id, fecha)no puede repetirse →409(nueva excepciónFeriadoDuplicadoError), igual que la constraint de la tabla.
Alternativas descartadas¶
- Esperar a la capa de autenticación — el CRUD de
mae_empresasya permite datos reales, así que no hay nada que esperar: elempresa_idse recibe en el body hasta que el token lo provea. - No validar la empresa — dejaría feriados huérfanos para empresas que no
existen; el repository la valida contra
mae_empresas.
Consecuencias¶
- Primer catálogo con validación de empresa:
cat_bancosseguirá el mismo patrón cuando se implemente. - Cuando llegue la autenticación, el
empresa_iddel token reemplazará al del body (pendiente documentado). - OpenAPI del servicio suma 3 endpoints.