0018. CRUD de los catálogos por empresa — segundo slice: bancos¶
Estado: Aceptado Fecha: 2026-09-29 Autor: Duval Alcivar Módulo(s) afectado(s): app/domains/catalogos/, tests/unit/catalogos/
Contexto¶
El ADR 0017 abrió los catálogos por empresa con cat_feriados. Este ADR lo
replica para cat_bancos, que como monedas y países tiene codigo único — pero
por empresa: la tabla declara unique(empresa_id, codigo)
(uq_cat_bancos_empresa_codigo). El empresa_id se acepta en el body por
ahora; cuando exista la capa de autenticación vendrá del token, como ya se
documentó en el ADR 0017.
Decisión¶
Se implementa el CRUD de cat_bancos bajo /api/v1/catalogos/bancos, con la
arquitectura de capas router -> service -> repository del ADR 0001 transversal:
POST /api/v1/catalogos/bancoscrea con201;PUT /api/v1/catalogos/bancos/{banco_id}actualiza parcialmente con200;DELETE /api/v1/catalogos/bancos/{banco_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" (reutilizaEmpresaNoEncontradoError).- El
codigono puede repetirse dentro de la misma empresa →409(nueva excepciónBancoCodigoDuplicadoError), igual que la constraintuq_cat_bancos_empresa_codigode la tabla.
Alternativas descartadas¶
- Esperar a la capa de autenticación — mismo criterio que el ADR 0017: no
hay nada que esperar, el
empresa_idse recibe en el body hasta que el token lo provea. - Validar el código de forma global — el unique es por empresa, no global: dos empresas pueden usar el mismo código de banco.
Consecuencias¶
- Completa los catálogos por empresa junto con el ADR 0017.
- Cuando llegue la autenticación, el
empresa_iddel token reemplazará al del body (pendiente documentado). - OpenAPI del servicio suma 3 endpoints (pasa a 40).