clientes.cat_estados_prospecto¶
Propósito¶
Clasifica la fase de seguimiento de un prospecto en cada empresa CRM. Los códigos iniciales por evaluar con el negocio son NUEVO, EN_CALIFICACION, PROPUESTA_PRESENTADA y DESCARTADO. El catálogo no almacena CONVERTIDO_A_CLIENTE: la conversión se determina por mae_prospectos.cliente_id y fecha_conversion. Tampoco almacena VISITA_AGENDADA, que corresponde a la agenda de actividades de Fuerza de Ventas.
is_activo es el campo administrativo de auditoría y no describe la fase comercial. No se añade is_fase_cierre ni otra bandera de negocio.
Estructura propuesta¶
| Columna | Tipo | Regla |
|---|---|---|
id |
uuid |
Clave primaria |
empresa_id |
bigint |
Empresa propietaria |
codigo |
varchar(30) |
Código único por empresa |
nombre |
varchar(100) |
Nombre visible de la fase |
orden_fase |
integer |
Orden de presentación positivo |
descripcion |
varchar(255) |
Explicación opcional |
is_activo |
boolean |
Estado administrativo; por defecto true |
created_at / updated_at |
timestamptz |
Fechas de auditoría obligatorias |
deleted_at |
timestamptz |
Borrado lógico, opcional |
created_by / updated_by |
uuid |
Usuarios de auditoría, opcionales |
CREATE TABLE clientes.cat_estados_prospecto (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
empresa_id BIGINT NOT NULL,
codigo VARCHAR(30) NOT NULL,
nombre VARCHAR(100) NOT NULL,
orden_fase INTEGER NOT NULL,
descripcion VARCHAR(255),
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_cat_estados_prospecto_empresa_id UNIQUE (empresa_id, id),
CONSTRAINT uq_cat_estados_prospecto_empresa_codigo
UNIQUE (empresa_id, codigo),
CONSTRAINT ck_cat_estados_prospecto_orden_positivo
CHECK (orden_fase > 0)
);
CREATE INDEX ix_cat_estados_prospecto_empresa_orden
ON clientes.cat_estados_prospecto (empresa_id, orden_fase);
ALTER TABLE clientes.cat_estados_prospecto ENABLE ROW LEVEL SECURITY;
CREATE POLICY rls_cat_estados_prospecto_empresa
ON clientes.cat_estados_prospecto
USING (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT)
WITH CHECK (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT);
Uso y decisiones pendientes¶
mae_prospectos.estado_prospecto_iddebe apuntar a una fila de la misma empresa desde el alta. La aplicación debe elegir expresamente la fase inicial; no se codifica un UUID fijo como valor predeterminado.- Para presentar el estado actual,
cliente_idinformado prevalece y se muestra «Convertido a cliente». Si todavía no se convirtió, se muestra la fase del catálogo. Tras convertir, la fase guardada conserva la última etapa de seguimiento y no se interpreta como estado actual del cliente. - Las fases y su orden, las reglas de reapertura y la posibilidad de descartar un prospecto requieren validación con el negocio antes de poblar el catálogo. Si
DESCARTADOimpide convertir, esa regla debe validarse en la operación o mediante una validación transaccional; una FK no puede imponerla por sí sola.