0028. Tenencia y RLS: historial de aplicaciones, bloqueo de borrado y dos pools¶
Estado: Aceptado
Fecha: 2026-11-05
Autor: Duval Alcivar
Módulo(s) afectado(s): svc-identidad (core_sigfa), tenencia, RLS y aprovisionamiento
Modifica a: ADR 0004, ADR 0008, ADR 0016
Origen: ADR 0016 de implementación, ADR 0033 de implementación, ADR 0046 de implementación, ADR 0054 de implementación, ADR 0057 de implementación, ADR 0059 de implementación, ADR 0060 de implementación
Contexto¶
Los ADR 0004, 0008 y 0016 describían el alta transaccional con usuario inicial, clon de plantilla y DELETE directo; la implementación acotó el alcance y agregó historial y bloqueo.
Decisión¶
rel_empresa_aplicaciondeja de tenerUNIQUE(empresa_id, aplicacion_id)total: pasa a índice único parcialWHERE deleted_at IS NULLy conserva historial; desvincular es borrado lógico y volver a vincular inserta fila nueva.- Agregar una aplicación a una empresa ya no clona la plantilla de navegación.
- El
DELETEde una empresa con sucursales activas responde 409 (bloqueo temporal), no borrado en cascada ni incondicional. - La RLS se fija por transacción con un listener (
set_config(..., true)), no con un rol privilegiado ni con middleware global. - Hay dos pools: tenant con RLS y panel administrativo con
BYPASSRLS, cada uno con su token (scope=admin). - El alta de empresa crea la empresa y, opcionalmente, materializa la plantilla; no crea usuario administrador inicial ni publica outbox en esta fase.
Alternativas descartadas¶
- Mantener el
UNIQUEtotal — impide revincular una aplicación después de desvincularla y borra el historial de tenencia. DELETEen cascada — destruye sucursales activas sin confirmación y sin poder auditar.- Middleware global que fija la RLS — no permite mezclar tenant y administración dentro del mismo proceso.
Consecuencias¶
Los clientes deben tratar el 409 como estado transitorio, no como error definitivo. El historial hace que las consultas de aplicaciones vigentes siempre filtren deleted_at IS NULL; el pool administrativo queda restringido al token scope=admin.
Se incorporó a este sitio el 2026-11-09. La fecha del ADR corresponde a la última decisión de implementación que resume, no a la fecha de publicación en este sitio.