Saltar a contenido

0038. Empresas con acceso del usuario autenticado

Estado: Aceptado Fecha: 2026-10-05 Autor: Duval Alcivar Módulo(s) afectado(s): app/domains/usuarios/, tests/unit/auth/, docs/adr/

Contexto

El frontend necesita un selector de empresa para el usuario que ya tiene sesión (AppLayout): con qué empresa está trabajando y a cuáles puede cambiar. Hoy las empresas sólo se exponen en el paso 1 del login (ADR 0030), junto al pre-token, que es de un solo uso: una vez emitido el access token, no hay forma de volver a preguntar a qué empresas tiene acceso el usuario.

El listado existente (GET /usuarios/{usuario_id}/empresas, ADR 0028) es del CRUD administrativo y recibe el usuario_id por la URL: no sirve para «mis empresas» y permitiría pedir las de otro. Además, root debe ver todas las empresas activas sin depender de asignaciones (ADR 0037).

Decisión

Se agrega GET /api/v1/auth/empresas, protegido por JWT con get_current_user:

Aspecto Definición
Respuesta list[EmpresaLoginRead] (id, razon_social, nombre_comercial)
Identidad Del access token, nunca de la URL ni del cuerpo
root Todas las empresas activas, sin importar asignación
Resto Sólo las de rel_usuario_empresa, como en el login
Filtro Sólo activas: deleted_at IS NULL (ADR 0015)

El service (AuthService.listar_empresas_acceso) reutiliza los métodos del repository que ya usan el login (listar_empresas_activas y listar_empresas_usuario), así que la regla de visibilidad es una sola y no puede divergir entre el login y el listado.

Alternativas descartadas

  • Reusar GET /usuarios/{usuario_id}/empresas — es administrativo y recibe el usuario_id por path: un usuario podría enumerar las empresas de otro, y no aplica la regla de root.
  • Recibir la empresa o el usuario por query/body — abre la puerta a leer el acceso de otro usuario; el token ya trae la identidad.
  • Un método de visibilidad nuevo en el repository — duplicaría la regla del login; se reutilizan los métodos existentes.
  • Devolver el contrato completo MaeEmpresasRead — expone columnas que el selector no necesita; se reutiliza el contrato mínimo del paso 1.

Consecuencias

  • El frontend puede armar el selector de empresa con la sesión activa y reutiliza el tipo EmpresaLoginRead que ya conoce del login.
  • OpenAPI del servicio suma 1 endpoint bajo /api/v1/auth.
  • La respuesta sólo lista: no cambia de empresa (emitir un token nuevo para otra empresa queda fuera de este ADR).
  • EmpresaLoginRead pasa a declarar from_attributes: se puede proyectar directamente desde el ORM.

Qué no cubre

  • Cambiar de empresa (reemitir un access/refresh para otra empresa del usuario): es otro endpoint y otra decisión.
  • Paginación: un usuario pertenece a pocas empresas.