0006. Empresa del request provisional hasta que exista svc-identidad¶
Estado: Propuesto Fecha: 2026-09-29 Autor: Kevin Delgado Lopez Módulo(s) afectado(s): app/core/security.py, app/api/deps.py, app/main.py
Contexto¶
La RLS (ADR 0003) necesita saber la empresa de cada request, y los ADR 0006 y 0012 transversales dicen que sale del JWT de svc-identidad y que un middleware la fija una vez por request. svc-identidad todavía no existe, así que no hay token que validar, pero el CRUD ya necesita una empresa para probarse.
Decisión¶
- Un middleware en
app/core/security.pydejarequest.state.empresa_iduna vez por request, antes del router. - Provisional: la empresa sale de la cabecera
X-Empresa-Id, y sólo conENVIRONMENT=local. En cualquier otro entorno la cabecera se ignora. get_db_empresa(app/api/deps.py) fija la empresa conset_config('app.current_empresa_id', ..., true), local a la transacción. Por eso el repository haceflush+refreshantes delcommit.- Las rutas de lectura no piden la empresa (la RLS filtra). Las que escriben
usan
EmpresaActual, que responde 401 si el request no la trae. - Cuando exista el JWT sólo cambia
identificar_empresa: el resto queda igual.
Alternativas descartadas¶
- Aceptar la cabecera en todos los entornos — cualquiera podría mandar otra empresa y leer o escribir sus datos; la RLS no serviría de nada.
- Empresa fija en el código (
empresa_id = 1) — mete un valor falso en el negocio y habría que buscarlo y quitarlo después. SETde sesión (sintrue) — la empresa queda pegada a la conexión del pool y el siguiente request, de otra empresa, la heredaría.
Consecuencias¶
- Fuera de local el servicio falla cerrado: las escrituras dan 401 y, con un rol de aplicación, las lecturas no ven filas hasta que exista el JWT.
- Swagger (
/docs) no manda la cabecera: para escribir en local se usa Postman, curl oInvoke-RestMethod. - Con
postgres(superusuario) la RLS no filtra; el aislamiento real se verá con el rol de aplicació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.