Saltar a contenido

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_id debe 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_id informado 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 DESCARTADO impide convertir, esa regla debe validarse en la operación o mediante una validación transaccional; una FK no puede imponerla por sí sola.