Especificación Técnica: rel_grupo_destinatario_usuario¶
Esquema: core.notificaciones
Base de Datos: core
Servicio: svc-notificaciones
Propósito: Relación N:M entre grupos de destinatarios y usuarios: define qué usuarios integran cada grupo dentro de una empresa.
1. Justificación y Mejoras de Arquitectura¶
usuario_ides una referencia lógica asvc-identidad(maestromae_usuarios): se conserva como UUID sin FOREIGN KEY, igual que en el fuente, porque el usuario no vive en este esquema.- FK compuesta a
mae_grupos_destinatarios (empresa_id, id): la pertenencia al grupo queda restringida a la misma empresa (RLS no protege las FKs). - Unique parcial
UNIQUE (grupo_id, usuario_id) WHERE deleted_at IS NULLimpide duplicar un usuario en el mismo grupo; reutilizable tras borrado lógico.
2. Definiciones de Implementación¶
Table core.notificaciones.rel_grupo_destinatario_usuario {
id uuid [pk, default: `gen_random_uuid()`]
empresa_id bigint [not null]
grupo_id uuid [not null]
usuario_id uuid [not null, note: 'Referencia lógica a core.identidad.mae_usuarios (sin FK)']
// Auditoría General
is_activo boolean [not null, default: `true`, note: 'Estado lógico del registro']
created_at timestamptz [not null, default: `now()`, note: 'Fecha de creación']
updated_at timestamptz [not null, default: `now()`, note: 'Fecha de última actualización']
deleted_at timestamptz [note: 'Fecha de eliminación lógica']
created_by uuid [note: 'Usuario creador']
updated_by uuid [note: 'Usuario modificador']
Indexes {
(grupo_id, usuario_id) [unique, name: 'uq_rel_grupo_destinatario_usuario', note: 'WHERE deleted_at IS NULL']
(empresa_id) [name: 'ix_rel_grupo_destinatario_usuario_empresa_id']
}
}
Ref: mae_grupos_destinatarios.(empresa_id, id) < rel_grupo_destinatario_usuario.(empresa_id, grupo_id)
CREATE TABLE IF NOT EXISTS core.notificaciones.rel_grupo_destinatario_usuario (
id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
empresa_id BIGINT NOT NULL,
grupo_id UUID NOT NULL,
usuario_id UUID NOT NULL, -- referencia lógica a svc-identidad (mae_usuarios), sin FK
-- Auditoría General
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 fk_rel_grupo_destinatario_usuario_grupo
FOREIGN KEY (empresa_id, grupo_id)
REFERENCES core.notificaciones.mae_grupos_destinatarios (empresa_id, id)
);
CREATE UNIQUE INDEX IF NOT EXISTS uq_rel_grupo_destinatario_usuario ON core.notificaciones.rel_grupo_destinatario_usuario (grupo_id, usuario_id) WHERE deleted_at IS NULL;
CREATE INDEX IF NOT EXISTS ix_rel_grupo_destinatario_usuario_empresa_id ON core.notificaciones.rel_grupo_destinatario_usuario (empresa_id);
-- Comentarios
COMMENT ON COLUMN core.notificaciones.rel_grupo_destinatario_usuario.empresa_id IS 'Empresa propietaria de la relación';
COMMENT ON COLUMN core.notificaciones.rel_grupo_destinatario_usuario.grupo_id IS 'Grupo de destinatarios (FK compuesta con empresa_id)';
COMMENT ON COLUMN core.notificaciones.rel_grupo_destinatario_usuario.usuario_id IS 'Usuario miembro del grupo (referencia lógica a svc-identidad)';