Saltar a contenido

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_aplicacion deja de tener UNIQUE(empresa_id, aplicacion_id) total: pasa a índice único parcial WHERE deleted_at IS NULL y 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 DELETE de 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 UNIQUE total — impide revincular una aplicación después de desvincularla y borra el historial de tenencia.
  • DELETE en 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.