0008. Empresa del request: sólo del token, fijada en cada transacción¶
Estado: Aceptado Fecha: 2026-10-05 Autor: David Garcia Módulo(s) afectado(s): app/core/tenancy.py, app/core/db.py
Contexto¶
La RLS (ADR 0006) necesita la empresa de cada request en la variable de sesión
app.current_empresa_id (ADR 0006 y 0012 transversales). crm-svc-clientes la
tomó de una cabecera de forma provisional mientras identidad no existía (su
ADR 0006). Identidad ya emite el token con empresa_id, así que este servicio
no necesita ese paso.
Decisión¶
- La empresa sale sólo del access token (ADR 0007), nunca de una cabecera, la ruta o el cuerpo.
- La dependencia
SesionEmpresaexige la identidad (401 antes de abrir la sesión) y fija la empresa en la sesión de base de datos. set_config('app.current_empresa_id', ..., true)en cadaafter_begin: local a la transacción y reaplicado en cada transacción nueva, también después de uncommit()del service.- Los repositorios no filtran por empresa: lo hacen las políticas RLS.
- Identidad y empresa se resuelven con dependencias, no con middleware.
Alternativas descartadas¶
- Cabecera
X-Empresa-Id— el cliente elegiría la empresa y la RLS no aislaría nada. SETde sesión (sintrue) — la empresa queda pegada a la conexión del pool y la hereda el siguiente request, de otra empresa.- Fijarla una sola vez al abrir la sesión — tras el primer
commit()la transacción siguiente no la ve. - Middleware — una excepción lanzada ahí no pasa por los manejadores de errores (respondería 500, no 401) y queda por fuera de CORS.
- Filtrar por
empresa_iden cada repository — un olvido expone datos de otra empresa; la RLS falla cerrado.
Consecuencias¶
- Una sesión sin empresa (
obtener_sesion) no ve filas de tablas con RLS: sólo la usan rutas sin identidad, como/ready. - Cambiar de empresa es pedir otro token a identidad.
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.