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, incluye correo o usuario, rol destino y tenant, pero nunca 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 |
|---|---|
Nuevo usuario | Abre el formulario de creación de usuarios. |
Crear usuario | Crea la cuenta después de completar los campos de identidad y rol requeridos. |
Editar usuario | Cambia los detalles del usuario, el estado o la asignación de roles. |
Guardar | Persiste las ediciones del usuario. |
Activate | Permite al usuario acceder nuevamente al inquilino. |
Deactivate | Bloquea el acceso sin borrar el historial del usuario. |
Crear ticket | Abre una solicitud de soporte con esta página ya adjunta como contexto. |
Ejemplos operativos
Ejemplo 1: para crear un usuario, entra a Usuarios, usa Nuevo usuario, 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 Editar rol, 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 Usuarios 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 | UsuariosDesktop usa contextualHintPageId="users" y monta UsuariosManagementPanel. |
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 getPerfil, updatePerfil, listUsuarios, createUser y actualización de roles desde el frontend. |