Saltar a contenido

clientes.rel_clientes_contactos

Propósito

Vincula contactos y clientes dentro de una misma empresa CRM. Un cliente puede tener varios contactos y una misma persona puede vincularse a varios clientes, incluso del mismo grupo económico. Cada vínculo se registra expresamente. El cargo es propio de la relación. Origen legacy: i134t_contacto_cartera_clientes.

Estructura propuesta

Columna Tipo Regla
id uuid Clave primaria
empresa_id bigint Empresa propietaria
cliente_id uuid Cliente vinculado, obligatorio
contacto_id uuid Contacto vinculado, obligatorio
cargo_en_cliente varchar(150) Cargo específico para este cliente, 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.rel_clientes_contactos (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    empresa_id BIGINT NOT NULL,
    cliente_id UUID NOT NULL,
    contacto_id UUID NOT NULL,
    cargo_en_cliente VARCHAR(150),
    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_contactos_empresa_id UNIQUE (empresa_id, id),
    CONSTRAINT uq_rel_clientes_contactos_par
        UNIQUE (empresa_id, cliente_id, contacto_id),
    CONSTRAINT fk_rel_clientes_contactos_cliente
        FOREIGN KEY (empresa_id, cliente_id)
        REFERENCES clientes.mae_clientes (empresa_id, id),
    CONSTRAINT fk_rel_clientes_contactos_contacto
        FOREIGN KEY (empresa_id, contacto_id)
        REFERENCES clientes.mae_contactos_cliente (empresa_id, id)
);

CREATE INDEX ix_rel_clientes_contactos_empresa_contacto
    ON clientes.rel_clientes_contactos (empresa_id, contacto_id);

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

-- Ejecutar después de crear ambas tablas. La columna ya se declaró en mae_clientes.
ALTER TABLE clientes.mae_clientes
    ADD CONSTRAINT fk_mae_clientes_contacto_principal
        FOREIGN KEY (empresa_id, id, contacto_principal_id)
        REFERENCES clientes.rel_clientes_contactos
            (empresa_id, cliente_id, contacto_id);

Reglas de vinculación

  • El par (empresa_id, cliente_id, contacto_id) es único aun tras un borrado lógico. Si se restablece un vínculo, se reactiva la misma fila; no se crea un segundo par.
  • mae_clientes.contacto_principal_id es opcional. Su FK compuesta garantiza que el contacto elegido esté vinculado a ese cliente y limita la selección a uno por cliente, sin is_principal. El alta sigue cliente → contacto → vínculo → selección del principal. No se añade un campo separado de representante legal: los contactos vinculados representan al cliente para su gestión comercial.
  • Las FKs aseguran existencia y misma empresa, pero no vigencia administrativa. Para impedir nuevos vínculos hacia clientes inactivos o borrados lógicamente, aplicar la validación transaccional acordada para locales. Si un vínculo principal se desactiva o borra lógicamente, habrá que impedirlo o quitar primero la selección; una FK sola no detecta esa condición. Las relaciones históricas permanecen al desactivar después a un cliente.
  • En la migración se deben identificar contactos repetidos sin fusionar personas únicamente por compartir nombre o correo, y reconstruir cada vínculo legacy con su cliente.