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_clientesy asignarcliente_idyfecha_conversional prospecto en una misma transacción. La FK exige que ambos pertenezcan a la misma empresa. La restricciónUNIQUE (empresa_id, cliente_id)permite varios prospectos sin convertir, pero impide convertir dos prospectos al mismo cliente. - El par
cliente_id/fecha_conversiones 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 alCHECKy 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_idestá informado, la interfaz muestra «Convertido a cliente»; la fase guardada solo conserva la última etapa previa.VISITA_AGENDADAse obtiene de la agenda de Fuerza de Ventas. Antes de implementar el flujo, definir siDESCARTADOpermite reapertura y rechazar transiciones o conversiones incompatibles. promotor_idconserva el UUID defuerza_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 índiceix_mae_prospectos_empresa_promotorse conserva para las consultas por promotor.ciudad_idconserva el UUID decore.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, mapearnombre_negocio,nombre_contacto,direccion_textoy demás datos del origen; revisar duplicados y conversiones históricas antes de aplicar la unicidad decliente_id. Los triggers habituales de auditoría deben gestionar las marcas de tiempo y usuarios conforme al resto de CRM.