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 elusuario_idpor path: un usuario podría enumerar las empresas de otro, y no aplica la regla deroot. - 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
EmpresaLoginReadque 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).
EmpresaLoginReadpasa a declararfrom_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.