Saltar a contenido

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, con canal_id en el cuerpo del POST y un filtro opcional GET ...?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_id no se edita: el PUT no lo declara y enviarlo da 422.
  • Un canal con tipos activos no se borra (DELETE del 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.