0042. Cambio de empresa de la sesión¶
Estado: Aceptado Fecha: 2026-10-05 Autor: Duval Alcivar Módulo(s) afectado(s): app/domains/usuarios/, tests/unit/auth/, docs/adr/
Contexto¶
La empresa activa de una sesión vive en el claim empresa_id del access
token (ADR 0030). El login en dos pasos elige la empresa (ADR 0018) y
/auth/refresh la mantiene: no existe forma de cambiar de empresa con la
sesión activa. Sin endpoint, el usuario tendría que cerrar sesión y volver a
entrar para trabajar en otra de sus empresas.
El frontend ya lista las empresas con acceso (GET /auth/empresas, ADR 0038) y
tiene el selector, pero no puede cambiar: el empresa_id del JWT manda, así que
hay que reemitir los tokens, no alcanza con estado local.
Decisión¶
Se agrega POST /api/v1/auth/cambiar-empresa, con body
{refresh_token, empresa_id}:
- Valida el refresh token (existe, no vencido, no revocado) → usuario.
- Valida el usuario activo y su rol.
- Valida el acceso a la empresa destino:
root→ cualquiera activa; el resto → asignada. Sin acceso →403. - Revoca el refresh viejo y emite un par nuevo (access + refresh) para la empresa destino.
- Bitácora con la acción
cambio_empresa. DevuelveTokenResponse.
El frontend reemplaza ambos tokens. La credencial es el refresh token (como
en /auth/refresh), no el access: no exige Bearer.
Alternativas descartadas¶
- Sólo access token +
{empresa_id}, sin rotar el refresh — el refresh viejo guarda la empresa anterior: el próximo/auth/refreshrevertiría el cambio solo. - Reusar
/auth/login/empresa— necesita un pre-token (y por tanto la contraseña): obligaría a re-autenticar. - Guardar la empresa activa en el servidor — el diseño es stateless: la empresa la fija el claim del token (ADR 0030).
- Cambiar de empresa en el frontend con estado local — el backend autoriza
por el claim
empresa_id; el estado local no cambia el token.
Consecuencias¶
- OpenAPI suma 1 endpoint bajo
/api/v1/auth. - El frontend debe reemplazar access y refresh tras el cambio (el refresh viejo queda revocado).
- Reutiliza la validación de acceso a empresa (extraída a
_validar_acceso_empresa, compartida con el login) y la emisión de tokens del login. - La bitácora suma la acción
cambio_empresa.
Qué no cubre¶
- Elegir empresa al iniciar sesión: es el login en dos pasos (ADR 0018).
- RLS a nivel de base: sigue sin middleware en este servicio.