clientes.rel_clientes_promotores¶
Propósito¶
Registra la asignación de clientes a promotores. Un cliente puede estar asignado a varios promotores a la vez; todos los asignados pueden verlo y atenderlo. Cada fila representa una asignación del par cliente/promotor. No existe un titular ni se guarda una bandera para distinguirlo.
La asignación es por cliente completo. Una posible asignación por local se diseñará después, si se confirma esa necesidad. El día y el orden de visita pertenecen a la planificación de rutas y no a esta relación.
Estructura propuesta¶
| Columna | Tipo | Regla |
|---|---|---|
id |
uuid |
Clave primaria |
empresa_id |
bigint |
Empresa propietaria |
cliente_id |
uuid |
Cliente asignado |
promotor_id |
uuid |
Promotor asignado; referencia lógica a fuerza_ventas.mae_promotores.id, sin FK física |
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.rel_clientes_promotores (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
empresa_id BIGINT NOT NULL,
cliente_id UUID NOT NULL,
promotor_id UUID NOT NULL,
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_rel_clientes_promotores_empresa_id UNIQUE (empresa_id, id),
CONSTRAINT fk_rel_clientes_promotores_cliente
FOREIGN KEY (empresa_id, cliente_id)
REFERENCES clientes.mae_clientes (empresa_id, id)
);
CREATE INDEX ix_rel_clientes_promotores_empresa_cliente
ON clientes.rel_clientes_promotores (empresa_id, cliente_id);
CREATE INDEX ix_rel_clientes_promotores_empresa_promotor
ON clientes.rel_clientes_promotores (empresa_id, promotor_id);
ALTER TABLE clientes.rel_clientes_promotores ENABLE ROW LEVEL SECURITY;
CREATE POLICY rls_rel_clientes_promotores_empresa
ON clientes.rel_clientes_promotores
USING (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT)
WITH CHECK (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT);
Consulta y reglas de negocio¶
- Varios promotores pueden estar asignados al mismo cliente. No hay
is_promotor_principal, rol de titular niUNIQUE (empresa_id, cliente_id, promotor_id). No se usaON DELETE CASCADE, para conservar la asignación ante eliminaciones accidentales. - Antes de crear una asignación, validar que cliente y promotor estén activos y sin borrado lógico. La FK hacia
mae_clientesasegura existencia y misma empresa del cliente, pero no ese estado;promotor_idno tiene FK física, por lo que su existencia, empresa y estado deben validarse mediante la integración con Fuerza de Ventas. - Una asignación activa y sin borrado lógico permite al promotor ver y atender al cliente. La actividad efectivamente realizada registra su propio
promotor_id. El supervisor ve los clientes de sus promotores subordinados activos mediante la relación de supervisión desvc-fuerza_ventas; no se insertan asignaciones duplicadas para él. Si varios subordinados comparten un cliente, la consulta devuelve una sola ficha. RLS por empresa no implementa por sí sola este control de acceso individual; debe aplicarse en la autorización del servicio o en políticas adicionales. mae_promotoreses una referencia lógica al otro servicio en la misma base CRM; no se declara FK física entre schemas de distintos servicios ni se crea una proyección local solo para almacenar el identificador. Esta propuesta no define ni modifica su estructura. La migración desdei137t_cliente_promotordebe trasladar las asignaciones disponibles sin inventar relaciones que no estén respaldadas por el sistema legado.