Usuarios

En Horizon, un usuario es una persona con credenciales de acceso (correo y contraseña). Lo que puede hacer depende de su rol y del nodo del árbol al que pertenece — no de un permiso global suelto.

Dónde gestionar usuarios

Dashboard → Configuración → Usuarios

Desde ahí puedes:

Ver la lista de usuarios visibles en tu alcance.
Invitar a alguien nuevo por correo.
Asignar o ajustar el rol dentro del nodo correspondiente.
Activar o desactivar accesos cuando alguien deja la operación.

Solo verás usuarios de tu subtree. Un administrador de Capricornio no administra cuentas de Quantum, aunque ambos dependan del mismo integrador.

Roles disponibles por tipo de empresa

Horizon asigna roles según el tipo de nodo (node_type) de la empresa a la que pertenece la membresía:

Tipo de nodo	Roles que puedes asignar
`distributor`	`distributor_admin`, `distributor_supervisor`
`integrator`	`integrator_admin`, `integrator_supervisor`
`end_client`	`client_admin`, `client_supervisor`

Al invitar, el formulario solo muestra roles inferiores al tuyo en la jerarquía. Si intentas asignar un rol que no te corresponde, la API lo rechaza — el dashboard filtra opciones para evitar errores.

Qué implica cada rol (resumen)

Rol	Uso típico
`distributor_admin`	Partner que crea integradores y clientes finales; ve KPIs agregados, no GPS unitario
`distributor_supervisor`	Supervisión del distribuidor con permisos de lectura ampliados en su nivel
`integrator_admin`	MSP que opera clientes finales, configura integraciones GPS y da soporte operativo
`integrator_supervisor`	Supervisión del integrador sobre su cartera de clientes
`client_admin`	Administrador técnico del transportista: flotillas, unidades, geocercas, usuarios
`client_supervisor`	Supervisor que puede aprobar comandos GPS sensibles (paro de motor, reinicio remoto)

Los consumidores finales por WhatsApp no se crean como usuarios de dashboard en el flujo estándar: su acceso se vincula al número de teléfono registrado por un client_admin.

Asociación a empresa (nodo del árbol)

Cada invitación crea una membresía: (usuario, nodo, rol).

Un mismo usuario puede pertenecer a varios nodos — por ejemplo, alguien que trabaja en dos clientes finales del mismo integrador.
En cada sesión del dashboard debe haber un nodo activo. Sin él, no hay permisos efectivos.
Si alguien tiene más de una membresía, la UI pide elegir contexto al iniciar sesión.

Al invitar desde un integrador con varios clientes, selecciona el cliente destino (campo de tenant) para que la membresía quede en el nodo correcto.

Flujo recomendado de alta

Confirma que la empresa (end_client o nodo superior) ya existe en el árbol.
Invita al correo corporativo con el rol mínimo necesario — empieza por client_supervisor u operador vía WhatsApp, no por admin si no hace falta.
Pide al usuario que complete el registro desde el enlace del correo.
Si usará WhatsApp, registra su número de teléfono en su perfil para que el agente lo identifique.

Problemas frecuentes

Situación	Qué revisar
La invitación no llegó	Carpeta de spam; reenvía desde Usuarios. El toast indica si se creó pero no se entregó el correo.
No ve menús esperados	Rol insuficiente o nodo activo incorrecto.
No puede invitar cierto rol	Solo puedes asignar roles por debajo del tuyo en la misma empresa.

Para permisos detallados por pantalla, consulta Roles y permisos.