Especificación Técnica: rel_usuario_sucursal¶
Esquema: core.identidad
Base de Datos: core
Servicio: svc-identidad
Propósito: Relación N:M entre usuarios y sucursales asignadas por empresa.
1. Justificación y Mejoras de Arquitectura¶
- Define las sucursales operativas de cada usuario.
- Unique (usuario_id, sucursal_id) impide asignaciones duplicadas.
- RLS por subconsulta: la tabla no tiene
empresa_idpropio, pero el aislamiento se resuelve a través de la sucursal referenciada (la empresa demae_sucursales). Sin esta política, un usuario vería qué usuarios acceden a sucursales de otras empresas (ADR 0012 transversal:rel_usuario_sucursalestá en la lista de tablas con RLS).
2. Definiciones de Implementación¶
Table core.identidad.rel_usuario_sucursal {
id uuid [pk, default: `gen_random_uuid()`]
usuario_id uuid [not null, ref: > mae_usuarios.id]
sucursal_id uuid [not null, ref: > mae_sucursales.id]
// 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 {
(usuario_id, sucursal_id) [unique, name: 'uq_rel_usuario_sucursal']
}
}
CREATE TABLE IF NOT EXISTS core.identidad.rel_usuario_sucursal (
id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
usuario_id UUID NOT NULL,
sucursal_id UUID NOT NULL,
-- 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 uq_rel_usuario_sucursal UNIQUE (usuario_id, sucursal_id),
CONSTRAINT fk_rel_usuario_sucursal_usuario FOREIGN KEY (usuario_id) REFERENCES core.identidad.mae_usuarios (id),
CONSTRAINT fk_rel_usuario_sucursal_sucursal FOREIGN KEY (sucursal_id) REFERENCES core.identidad.mae_sucursales (id)
);
-- Row-Level Security
-- No tiene `empresa_id` propio: el aislamiento se resuelve a través de la
-- sucursal referenciada (la empresa de `mae_sucursales`).
ALTER TABLE core.identidad.rel_usuario_sucursal ENABLE ROW LEVEL SECURITY;
CREATE POLICY aislamiento_empresa ON core.identidad.rel_usuario_sucursal
FOR ALL
USING (
sucursal_id IN (
SELECT s.id FROM core.identidad.mae_sucursales s
WHERE s.empresa_id = NULLIF(current_setting('app.current_empresa_id', true), '')::BIGINT
)
);
-- Comentarios
COMMENT ON COLUMN core.identidad.rel_usuario_sucursal.usuario_id IS 'Usuario';
COMMENT ON COLUMN core.identidad.rel_usuario_sucursal.sucursal_id IS 'Sucursal';