Saltar a contenido

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 ni UNIQUE (empresa_id, cliente_id, promotor_id). No se usa ON 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_clientes asegura existencia y misma empresa del cliente, pero no ese estado; promotor_id no 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 de svc-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_promotores es 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 desde i137t_cliente_promotor debe trasladar las asignaciones disponibles sin inventar relaciones que no estén respaldadas por el sistema legado.