Saltar a contenido

0014. CRUD de los catálogos — sexto slice: unidades comerciales

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_unidades_comerciales clasifica el mercado destinatario del cliente (B2B, B2C, B2G, B2E) y tiene la misma forma que canales (codigo, nombre, descripcion). docs-sql aclara que es independiente del canal comercial y que sus descripciones deben verificarse con el negocio antes de cargar los valores.

Decisión

  • Endpoints bajo /api/v1/catalogos/unidades-comerciales, con los mismos códigos y reglas que canales comerciales (ADR 0008).
  • Sin reglas propias: no depende del canal ni se infiere de otros datos.
  • El CRUD no carga datos; los valores los define el negocio.

Alternativas descartadas

  • Precargar B2B, B2C, B2G y B2E — docs-sql pide verificar antes su significado operativo.
  • Relacionarla con el canal o con las sucursales — docs-sql no confirma ninguna regla de ese tipo.

Consecuencias

  • La API expone 30 operaciones de catálogos (6 catálogos × 5).
  • Si un cliente llegara a necesitar varias unidades, cambia la FK de mae_clientes, no este catálogo.

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.