Guía de uso
Usuarios
Los usuarios administran las cuentas del equipo, la incorporación, el estado activo y la postura de acceso a nivel de inquilino.
Intención de la página
La intención de los Usuarios es controlar quién puede ingresar a Ballista y qué estado de cuenta tienen.
Contexto para soporte
Para problemas de acceso, incluya el correo electrónico o el nombre de usuario del usuario, la función de destino y el inquilino, pero nunca incluya contraseñas.
Cómo funciona
Usuarios es una página de administración para crear, editar, activar o desactivar cuentas de equipo. Debe ser utilizado únicamente por personal autorizado.
La página conecta la identidad con el acceso de los inquilinos y la asignación de roles. Se debe revisar un registro de usuario junto con los permisos de función cuando alguien no puede ver o cambiar un módulo.
La incorporación depende de datos precisos del usuario. Si se crea una cuenta con el correo electrónico, la función o el inquilino incorrectos, el acceso posterior y los registros de auditoría se vuelven confusos.
Botones y acciones
| Acción | Qué hace |
|---|---|
New user | Abre el formulario de creación de usuarios. |
Create user | Crea la cuenta después de completar los campos de identidad y rol requeridos. |
Edit user | Cambia los detalles del usuario, el estado o la asignación de roles. |
Save | Persiste las ediciones del usuario. |
Activate | Permite al usuario acceder nuevamente al inquilino. |
Deactivate | Bloquea el acceso sin borrar el historial del usuario. |
Create Ticket | Abre una solicitud de soporte con esta página ya adjunta como contexto. |
Ejemplos operativos
Ejemplo 1: para crear un usuario, entra a Users, usa New user, nombre completo, email, contraseña inicial y rol. Al guardar, el usuario queda disponible para iniciar sesión según los permisos.
Ejemplo 2: para asignar un rol a alguien existente, busca el usuario, usa Edit role, selecciona Admin, Supervisor u Operador, y guarda. El cambio afecta que páginas y acciones pueden usar.
Ejemplo 3: si un usuario no ve Facturación o Informes, revisa primero Users para confirmar rol asignado y después Roles para confirmar permisos de ese rol.
Ejemplo 4: nunca pegues contraseñas en tickets. Si el problema es acceso, reporta email, rol esperado, inquilino y mensaje visible.
Cómo se lee en el código
| Archivo | Qué hace |
|---|---|
frontend/src/pages/users/users.desktop.tsx | UsersDesktop usa contextualHintPageId="users" y monta UsersManagementPanel. |
frontend/src/modules/users/components/users-management-panel.tsx | El panel consulta usuarios, roles y permisos; permite crear, usuario, editar rol y expandir matriz RBAC cuando el permiso lo permite. |
frontend/src/lib/api/endpoints/users.api.ts | Los endpoints de usuarios sostienen getProfile, updateProfile, listUsers, createUser y actualización de roles desde el frontend. |