Saltar a contenido

0003. RLS por empresa en la misma migración que su tabla

Estado: Propuesto Fecha: 2026-09-25 Autor: Kevin Delgado Lopez Módulo(s) afectado(s): alembic/versions/

Contexto

Toda tabla del servicio lleva empresa_id y se aísla por empresa con RLS (ADR 0002 y 0012 transversales). --autogenerate no detecta la RLS, así que se escribe a mano, y las fuentes no coinciden en cómo: docs-sql usa rls_<tabla>_empresa sin NULLIF ni FORCE; la propuesta 0019 usa aislamiento_empresa con NULLIF, FORCE y WITH CHECK; la guía de la plantilla sugiere en un ejemplo una migración aparte para la RLS y en sus reglas lo contrario. Hace falta un patrón único antes de migrar las tablas restantes.

Decisión

Cada tabla con empresa_id recibe su RLS en la misma migración que la crea, con este patrón (el de la migración 20260925_001):

ALTER TABLE clientes.<tabla> ENABLE ROW LEVEL SECURITY;
ALTER TABLE clientes.<tabla> FORCE ROW LEVEL SECURITY;
CREATE POLICY rls_<tabla>_empresa ON clientes.<tabla>
  USING (empresa_id = NULLIF(current_setting('app.current_empresa_id', true), '')::BIGINT)
  WITH CHECK (empresa_id = NULLIF(current_setting('app.current_empresa_id', true), '')::BIGINT);

downgrade() quita la política antes de borrar la tabla. El esquema va literal en la migración, no leído de la configuración.

Alternativas descartadas

  • RLS en una migración aparte — entre las dos migraciones la tabla existe sin aislamiento, y un downgrade parcial puede dejarla sin política.
  • Política aislamiento_empresa (propuesta 0019) — el mismo nombre en todas las tablas no identifica cuál falla en logs y errores; rls_<tabla>_empresa coincide con docs-sql.
  • Sin NULLIF (docs-sql) — sin empresa en la sesión, ''::BIGINT rompe la consulta con un error de conversión en lugar de devolver 0 filas.

Consecuencias

  • FORCE aplica la política también al dueño de la tabla, pero un superusuario la salta siempre: en local (postgres) no se ve el filtro. Se verá con el rol de aplicación, cuando exista; sus GRANT irán en una migración posterior.
  • Las políticas difieren de docs-sql en NULLIF, FORCE y el sufijo con el prefijo cat_ completo; hay que avisar a docs-sql para alinearlo.
  • Toda migración nueva que cree una tabla debe revisarse contra este patrón.

Media página como máximo. Si el ADR crece más que eso, probablemente estás documentando el diseño completo del módulo, no una decisión puntual — separa.