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 listenerafter_beginde 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).