0012. CRUD de los catálogos — cuarto slice: modelos 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_modelos_comerciales tiene la misma forma que
canales (codigo, nombre, descripcion), pero docs-sql lo marca como
catálogo provisional
Decisión¶
- Se expone igual que canales comerciales, bajo
/api/v1/catalogos/modelos-comerciales, con los mismos códigos y reglas (ADR 0008). - El CRUD no carga datos: la tabla queda vacía hasta que el negocio defina qué clasifica.
- No se agrega ninguna regla propia mientras el catálogo sea provisional.
Alternativas descartadas¶
- Esperar a que el negocio lo defina — el CRUD no depende del significado de los valores; dejarlo listo evita volver a abrir el dominio después.
- Precargar
TRADICIONAL,MODERNO,PREVENTA… — docs-sql indica que esos valores pertenecen a otros catálogos y no deben copiarse aquí.
Consecuencias¶
- La API expone 20 operaciones de catálogos (4 catálogos × 5).
- Crear filas por la API antes del acuerdo de negocio puede obligar a reclasificarlas después; el endpoint existe, pero su uso queda a criterio del negocio.
- Si el negocio agrega campos o reglas, se documentan en un ADR nuevo.
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.