Saltar a contenido

0023. RLS por dependencia y empresa fijada en cada transacción

Estado: Aceptado Fecha: 2026-10-05 Autor: Duval Alcivar Módulo(s) afectado(s): app/core/db.py, app/core/tenancy.py Modifica a: ADR 0012 transversal (allí la empresa se fija en un middleware, una vez por request) Evidencia: commit 05b4f51 (2026-10-05); ADR 0008 del servicio (2026-10-05); app/core/db.py (listener after_begin); app/core/tenancy.py.

Contexto

El transversal 0012 fija la empresa en un middleware, una vez por request. Aquí la empresa debe salir sólo del access token y mantenerse vigente durante toda la transacción, incluso después de los commit() que hacen los services.

Decisión

  • La empresa sale sólo del access token.
  • set_config('app.current_empresa_id', ..., true) se ejecuta en un listener after_begin de cada transacción.
  • La identidad se exige con la dependencia SesionEmpresa, no con middleware.

Hay dos razones concretas. Una excepción lanzada en un middleware no pasa por los manejadores de error de FastAPI, así que el 401/403 no sale con el formato {"detail"}. Y un SET único por request no se reaplica tras un commit() del service.

La regla se adoptó en el resto de la plataforma: crm-svc-clientes la fija al inicio de cada transacción en el commit 9fd639d (2026-10-13) y core-svc-identidad la documenta en su ADR 0046 (2026-10-20).

Alternativas descartadas

  • Middleware global — el error no pasa por los manejadores de FastAPI y el valor se pierde tras el primer commit.
  • Fijar sólo al abrir la sesión — se pierde tras el primer commit() del service.

Consecuencias

El transversal 0012 queda desactualizado en su sección de middleware. La regla de fondo no cambia: empresa_id viene del JWT, nunca del request.


Estos ADR se escribieron después de la implementación; la fecha corresponde al commit que introdujo la decisión, no a la publicación en este sitio (2026-11-09).