Saltar a contenido

clientes.mae_prospectos

Propósito

Registra la ficha inicial de un posible cliente y su conversión, si ocurre. Al convertirlo se guarda el cliente_id resultante y la fecha_conversion; así se reemplaza el booleano in_cliente de i286t_prospectos por una relación verificable. Cada cliente puede provenir, como máximo, de un prospecto. Las actividades anteriores a la conversión permanecen vinculadas al prospecto; las nuevas se registran para el cliente.

Por ahora se guarda un promotor asignado actualmente, opcional. No se presupone que sea quien captó el prospecto. El origen de captación y el historial de asignaciones se definirán cuando el negocio establezca esas reglas. La fase de seguimiento se guarda en estado_prospecto_id; sus valores concretos siguen sujetos a validación. is_activo es el campo administrativo de auditoría, no una fase ni un estado de conversión.

Estructura propuesta

Columna Tipo Regla
id uuid Clave primaria
empresa_id bigint Empresa propietaria
nombre varchar(200) Nombre del prospecto o negocio, obligatorio
marca varchar(200) Marca comercial, opcional
contacto varchar(150) Persona de contacto inicial, opcional
correo varchar(254) Correo de contacto, opcional
telefono varchar(50) Teléfono de contacto, opcional
direccion text Dirección o referencia inicial, opcional
ciudad_id uuid Referencia lógica opcional a core.identidad.cat_ciudades.id
promotor_id uuid Referencia lógica opcional a fuerza_ventas.mae_promotores.id, sin FK física
estado_prospecto_id uuid Fase de seguimiento obligatoria, de la misma empresa
cliente_id uuid Cliente creado al convertir, vacío antes de convertir
fecha_conversion date Fecha de negocio de la conversión, vacía antes de convertir
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.mae_prospectos (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    empresa_id BIGINT NOT NULL,
    nombre VARCHAR(200) NOT NULL,
    marca VARCHAR(200),
    contacto VARCHAR(150),
    correo VARCHAR(254),
    telefono VARCHAR(50),
    direccion TEXT,
    ciudad_id UUID,
    promotor_id UUID,
    estado_prospecto_id UUID NOT NULL,
    cliente_id UUID,
    fecha_conversion DATE,
    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_mae_prospectos_empresa_id UNIQUE (empresa_id, id),
    CONSTRAINT uq_mae_prospectos_empresa_cliente UNIQUE (empresa_id, cliente_id),
    CONSTRAINT ck_mae_prospectos_conversion_pareja
        CHECK ((cliente_id IS NULL) = (fecha_conversion IS NULL)),
    CONSTRAINT fk_mae_prospectos_estado
        FOREIGN KEY (empresa_id, estado_prospecto_id)
        REFERENCES clientes.cat_estados_prospecto (empresa_id, id),
    CONSTRAINT fk_mae_prospectos_cliente
        FOREIGN KEY (empresa_id, cliente_id)
        REFERENCES clientes.mae_clientes (empresa_id, id)
);

CREATE INDEX ix_mae_prospectos_empresa_promotor
    ON clientes.mae_prospectos (empresa_id, promotor_id);
CREATE INDEX ix_mae_prospectos_empresa_estado
    ON clientes.mae_prospectos (empresa_id, estado_prospecto_id);
CREATE INDEX ix_mae_prospectos_empresa_ciudad
    ON clientes.mae_prospectos (empresa_id, ciudad_id);

ALTER TABLE clientes.mae_prospectos ENABLE ROW LEVEL SECURITY;
CREATE POLICY rls_mae_prospectos_empresa
    ON clientes.mae_prospectos
    USING (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT)
    WITH CHECK (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT);

Conversión e integración

  • Crear mae_clientes y asignar cliente_id y fecha_conversion al prospecto en una misma transacción. La FK exige que ambos pertenezcan a la misma empresa. La restricción UNIQUE (empresa_id, cliente_id) permite varios prospectos sin convertir, pero impide convertir dos prospectos al mismo cliente.
  • El par cliente_id/fecha_conversion es obligatorio conjuntamente. Una vez registrada, la conversión no debe retirarse ni cambiarse por la operación normal; cualquier corrección requiere un proceso controlado. Esa inmutabilidad y la exigencia de que el cliente esté activo y sin borrado lógico al convertir necesitan validación transaccional adicional al CHECK y a la FK antes de implementar la migración ejecutable. Un cliente que se desactive posteriormente sigue vinculado por motivos históricos.
  • La fase inicial se selecciona explícitamente del catálogo de la misma empresa. Si cliente_id está informado, la interfaz muestra «Convertido a cliente»; la fase guardada solo conserva la última etapa previa. VISITA_AGENDADA se obtiene de la agenda de Fuerza de Ventas. Antes de implementar el flujo, definir si DESCARTADO permite reapertura y rechazar transiciones o conversiones incompatibles.
  • promotor_id conserva el UUID de fuerza_ventas.mae_promotores. Aunque ambas tablas residen en la base física CRM, no se declara FK física entre schemas de distintos servicios; la integración con Fuerza de Ventas valida su existencia y vigencia. El índice ix_mae_prospectos_empresa_promotor se conserva para las consultas por promotor.
  • ciudad_id conserva el UUID de core.identidad.cat_ciudades, en otra base física. La integración valida su existencia; no se declara FK entre bases ni se crea una proyección local solo para almacenar el identificador.
  • Al migrar i286t_prospectos, mapear nombre_negocio, nombre_contacto, direccion_texto y demás datos del origen; revisar duplicados y conversiones históricas antes de aplicar la unicidad de cliente_id. Los triggers habituales de auditoría deben gestionar las marcas de tiempo y usuarios conforme al resto de CRM.