Saltar a contenido

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/feriados crea con 201; PUT /api/v1/catalogos/feriados/{feriado_id} actualiza parcialmente con 200; DELETE /api/v1/catalogos/feriados/{feriado_id} elimina lógicamente con 204.
  • El repository hace add/commit/refresh y las lecturas filtran deleted_at.
  • Validaciones:
  • empresa_id debe existir en mae_empresas → 404 "Empresa no encontrada" (nueva excepción EmpresaNoEncontradoError); el repository la valida consultando mae_empresas, como ya hace el dominio empresas con los catálogos.
  • pais_id debe existir → 404 (reutiliza PaisNoEncontradoError).
  • El par (empresa_id, pais_id, fecha) no puede repetirse → 409 (nueva excepción FeriadoDuplicadoError), igual que la constraint de la tabla.

Alternativas descartadas

  • Esperar a la capa de autenticación — el CRUD de mae_empresas ya permite datos reales, así que no hay nada que esperar: el empresa_id se 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_bancos seguirá el mismo patrón cuando se implemente.
  • Cuando llegue la autenticación, el empresa_id del token reemplazará al del body (pendiente documentado).
  • OpenAPI del servicio suma 3 endpoints.