Saltar a contenido

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_id es una referencia lógica a svc-identidad (maestro mae_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 NULL impide 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)';