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
downgradeparcial 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>_empresacoincide con docs-sql. - Sin
NULLIF(docs-sql) — sin empresa en la sesión,''::BIGINTrompe la consulta con un error de conversión en lugar de devolver 0 filas.
Consecuencias¶
FORCEaplica 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; susGRANTirán en una migración posterior.- Las políticas difieren de docs-sql en
NULLIF,FORCEy el sufijo con el prefijocat_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.