Saltar a contenido

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 SesionEmpresa exige 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 cada after_begin: local a la transacción y reaplicado en cada transacción nueva, también después de un commit() 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.
  • SET de sesión (sin true) — 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_id en 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.