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,B2GyB2E— 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.