Saltar a contenido

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

  1. 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 de rel_usuario_empresa (ADR 0028).
  2. Login, paso 2 (elegir_empresa): root puede elegir cualquier empresa activa; se valida que exista (existe_empresa), no que esté asignada. El resto mantiene la validación por asignación.
  3. Dashboard: una aplicación habilitada a la empresa sin módulos no se devuelve, para root y para el resto. Es navegación de empresa, así que aplica a todos por igual.
  4. El usuario no root no 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 root una empresa comodín u omitir empresa_id en el token — el servicio entero está scopeado por empresa (ADR 0004 y 0010 transversales); romperlo obligaría a bifurcar cada consulta.
  • Asignar a root todas las empresas en rel_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 root las 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 root sin 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 de root.
  • 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): root sigue accediendo por rol, sin lista de permisos.
  • RLS a nivel de base: el filtro por empresa es de aplicación.