clientes.cat_modelos_comerciales¶
Estado de la definición¶
Catálogo provisional, solicitado para mantener el concepto «modelo comercial» en la nueva propuesta. Su significado de negocio y sus valores válidos quedan pendientes de acordar con la empresa. Por ahora, sus filas no se interpretan como canal comercial, modalidad de venta ni acuerdo con el cliente.
No se cargarán datos de ejemplo hasta definir qué clasifica. mae_clientes.modelo_comercial_id incorpora una FK opcional a este catálogo por decisión posterior; debe permanecer NULL hasta acordar valores, cardinalidad y reglas de asignación. Los valores TRADICIONAL, MODERNO y HORECA ya corresponden al análisis de cat_canales_comerciales; PREVENTA y AUTOVENTA, al de cat_modalidad_ventas. Su presencia en el catálogo legacy de modelos no justifica copiarlos aquí automáticamente.
Estructura provisional¶
| Columna | Tipo | Regla |
|---|---|---|
id |
uuid |
Clave primaria |
empresa_id |
bigint |
Empresa propietaria |
codigo |
varchar(30) |
Código estable, único por empresa |
nombre |
varchar(100) |
Nombre visible |
descripcion |
text |
Explicación opcional |
is_activo |
boolean |
Estado administrativo; por defecto true |
created_at / updated_at |
timestamptz |
Fechas de auditoría obligatorias |
deleted_at |
timestamptz |
Fecha de borrado lógico, opcional |
created_by / updated_by |
uuid |
Usuarios de auditoría, opcionales |
CREATE TABLE clientes.cat_modelos_comerciales (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
empresa_id BIGINT NOT NULL,
codigo VARCHAR(30) NOT NULL,
nombre VARCHAR(100) NOT NULL,
descripcion TEXT,
is_activo BOOLEAN NOT NULL DEFAULT true,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
deleted_at TIMESTAMPTZ,
created_by UUID,
updated_by UUID,
CONSTRAINT uq_modelos_comerciales_empresa_id UNIQUE (empresa_id, id),
CONSTRAINT uq_modelos_comerciales_empresa_codigo UNIQUE (empresa_id, codigo)
);
ALTER TABLE clientes.cat_modelos_comerciales ENABLE ROW LEVEL SECURITY;
CREATE POLICY rls_modelos_comerciales_empresa
ON clientes.cat_modelos_comerciales
USING (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT)
WITH CHECK (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT);
Deuda técnica antes de usarla¶
- Semántica: definir qué pregunta responde «modelo comercial» y cómo se diferencia de canal, modalidad de venta y acuerdos comerciales.
- Migración: inventariar los códigos reales del legacy y decidir para cada uno si pertenece aquí o a otro catálogo; no copiar filas por nombre de tabla.
- Relación y vigencia: confirmar si un cliente puede tener varios modelos y si hay fechas de inicio y fin. La FK opcional actual presupone como máximo uno a la vez y no guarda historial; si esa suposición falla, habrá que sustituirla por una relación con vigencia.
- Uso de datos: la FK opcional comprueba la identidad y empresa del modelo, pero no impide cargar códigos duplicados en significado respecto de otros catálogos. Podría requerirse reclasificar datos después.
UNIQUE (empresa_id, id) permite la FK compuesta desde mae_clientes y garantiza la misma empresa. No resuelve las decisiones funcionales pendientes. Los campos de auditoría y la política RLS siguen el patrón de la nueva propuesta.