Saltar a contenido

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}:

  1. Valida el refresh token (existe, no vencido, no revocado) → usuario.
  2. Valida el usuario activo y su rol.
  3. Valida el acceso a la empresa destino: root → cualquiera activa; el resto → asignada. Sin acceso → 403.
  4. Revoca el refresh viejo y emite un par nuevo (access + refresh) para la empresa destino.
  5. Bitácora con la acción cambio_empresa. Devuelve TokenResponse.

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/refresh revertirí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.