0015. CRUD de los catálogos — séptimo slice: tipos de canal comercial¶
Estado: Propuesto Fecha: 2026-09-30 Autor: Kevin Delgado Lopez Módulo(s) afectado(s): app/domains/catalogos/, tests/unit/catalogos/
Contexto¶
Sigue el molde del ADR 0008. cat_tipos_canal_comercial es el primer catálogo
con FK: cada tipo pertenece a un canal de la misma empresa (FK compuesta
(empresa_id, canal_id)) y su codigo es único dentro del canal, no en
toda la empresa. El cliente guardará solo el tipo; el canal se deduce de él.
Decisión¶
- Rutas planas, como los demás catálogos:
/api/v1/catalogos/tipos-canal-comercial, concanal_iden el cuerpo delPOSTy un filtro opcionalGET ...?canal_id=. - Al crear, el canal debe existir (404) y estar activo (409); el código se valida contra los tipos de ese canal (409 si se repite, aunque esté borrado).
canal_idno se edita: elPUTno lo declara y enviarlo da 422.- Un canal con tipos activos no se borra (
DELETEdel canal da 409); primero se borran sus tipos. Esto amplía el ADR 0008.
Alternativas descartadas¶
- Rutas anidadas (
/canales-comerciales/{id}/tipos) — rompen la forma común de los catálogos y alargan cada ruta; el filtro cubre el mismo caso. - Permitir borrar el canal con tipos activos — dejaría tipos activos colgando de un canal borrado, y los clientes verían un canal inexistente.
- Mover un tipo de canal por
PUT— cambiaría en silencio el canal de todos los clientes que lo usan.
Consecuencias¶
- La API expone 35 operaciones de catálogos (7 catálogos × 5).
- Borrar un canal pasa a ser un proceso en dos pasos: sus tipos y luego él.
- El mismo código (
GENERAL) puede existir en varios canales.
Media página como máximo. Si el ADR crece más que eso, probablemente estás documentando el diseño completo del módulo, no una decisión puntual — separa.