0037. Acceso de root sin asignaciones y navegación filtrada por la empresa¶
Estado: Aceptado Fecha: 2026-10-05 Autor: Duval Alcivar Módulo(s) afectado(s): app/domains/usuarios/, app/domains/dashboard/, tests/unit/auth/, tests/unit/dashboard/, docs/adr/
Contexto¶
root es el acceso total por rol: no lleva permisos en el token y el dashboard
le devuelve todo lo habilitado a su empresa (ADR 0031 y 0036). Pero el login
seguía tratándolo como a cualquier usuario: el paso 1 listaba sólo las
empresas de rel_usuario_empresa y fallaba con SinEmpresasError si no había
ninguna, y el paso 2 (elegir_empresa) sólo aceptaba una empresa asignada. Un
root sin asignaciones —el caso normal, porque su acceso no se otorga por
asignación sino por rol— no podía ni iniciar sesión. Además, el dashboard le
mostraba aplicaciones habilitadas sin módulos, mientras al usuario normal ya
se le descartaban (ADR 0036).
Faltaba separar dos planos que estaban mezclados: los permisos de usuario (quién ve qué, según rol y concesiones) y la navegación de la empresa (qué aplicaciones y módulos tiene habilitada la empresa). El primero depende del usuario; el segundo, no.
Decisión¶
Se separan los dos planos y se ajusta el login de root (que no depende de
asignaciones):
- Login, paso 1: si el usuario es
root, se devuelven todas las empresas activas de la plataforma (listar_empresas_activas), no las asignadas. El resto sigue viendo sólo sus empresas derel_usuario_empresa(ADR 0028). - Login, paso 2 (
elegir_empresa):rootpuede elegir cualquier empresa activa; se valida que exista (existe_empresa), no que esté asignada. El resto mantiene la validación por asignación. - Dashboard: una aplicación habilitada a la empresa sin módulos no se
devuelve, para
rooty para el resto. Es navegación de empresa, así que aplica a todos por igual. - El usuario no
rootno cambia: sigue acotado a sus empresas y a sus permisos.
El token sigue llevando empresa_id (ADR 0030); lo que cambia es quién puede
elegir la empresa, no el aislamiento por empresa.
Alternativas descartadas¶
- Dar a
rootuna empresa comodín u omitirempresa_iden el token — el servicio entero está scopeado por empresa (ADR 0004 y 0010 transversales); romperlo obligaría a bifurcar cada consulta. - Asignar a
roottodas las empresas enrel_usuario_empresa— convierte un acceso por rol en datos de asignación y hay que mantenerlo cada vez que se crea una empresa; el acceso deja de ser implícito. - Seguir mostrando a
rootlas aplicaciones sin módulos — incoherente con el usuario normal y llena el frontend de entradas vacías. - Resolver el filtrado de módulos en el frontend — repartiría la regla de empresa entre backend y frontend, justo lo que el ADR 0036 evitó.
Consecuencias¶
- Un
rootsin empresas asignadas inicia sesión y elige cualquier empresa activa; el dashboard y el menú ya lo muestran todo (ADR 0036). - El repository de usuarios suma
listar_empresas_activas();existe_empresa()se reutiliza para el paso 2 deroot. - Queda explícita la separación permisos de usuario / navegación de empresa: el filtro por módulos se aplica en el plano de empresa, no en el de permisos.
- Refina ADR 0036 en el punto «Root ve todo lo habilitado»: la aplicación
habilitada sin módulos deja de viajar para
root.
Qué no cubre¶
- Escribir asignaciones o navegación: el cambio es de lectura y de login.
- Autorización por acción de cada endpoint (ADR 0031):
rootsigue accediendo por rol, sin lista de permisos. - RLS a nivel de base: el filtro por empresa es de aplicación.