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_ides opcional. Su FK compuesta garantiza que el contacto elegido esté vinculado a ese cliente y limita la selección a uno por cliente, sinis_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.