Overview
User management is accessible from the Users page (/Users/Users.jsx). This interface allows administrators to:
- Create and manage user accounts
- Assign roles and positions
- Configure user locations and supervisors
- Control user access through activation/deactivation
- Reset user passwords
- Search and filter users
Permissions Required
Access to user management features requires specific permissions:| Action | Permission |
|---|---|
| View users | ver_usuarios |
| Create users | crear_usuario |
| Edit users | editar_usuario |
| Delete/deactivate users | eliminar_usuario |
| Restore users | restaurar_usuario |
| Assign permissions | Admin role or asignar_permisos |
Users with the Admin role have access to all user management features by default.
Creating a New User
To create a new user account:Configure Optional Fields
Set additional user attributes:
User role from the catalog (
rolesUsuario). Examples: Admin, Manager, UserUser position from the catalog (
puestosUsuario)Select from available cities. Uses
id_ciudad field.Assign a supervisor from the list of available supervisors
Password Generation
The system automatically generates a secure password (12 characters) containing:
- Uppercase letters
- Lowercase letters
- Numbers
- Special characters (@#$%&*_-+!)
sendMail service.Editing Users
To modify an existing user account:- Click the three-dot menu on the user row
- Select Edit from the dropdown
- Modify any fields in the user form
- Click Save to apply changes
When editing, the password field is not displayed or modified. Use the Reset Password function to change passwords.
User Actions
Reset Password
To send a password reset email:- Click the three-dot menu on the user row
- Select Reset Password
- Confirm the action
- System sends recovery email using
sendRecoveryPassword(email)
The user must have a valid email address for password reset to work.
Deactivate User
To deactivate a user account:- Click the three-dot menu on the user row
- Select Deactivate
- Confirm the action
- Cannot log into the system
- Show
estatus: "Inactivo"in the database - Remain in the system and can be restored
- Are still visible when “Show Inactive” toggle is enabled
Restore User
To restore a deactivated user:- Enable the Show Inactive toggle
- Find the deactivated user (shown with neutral chip)
- Click the three-dot menu
- Select Restore
- Confirm the action
Activo and they can log in again.
Bulk Deactivate
To deactivate multiple users at once:- Check the boxes next to users you want to deactivate
- Click the Deactivate Selected button in the toolbar
- Confirm the bulk action
Promise.all().
Searching and Filtering
Search Bar
The search functionality filters users by:- Name (
nombre) - Username
- Role (
rol) - Position (
puesto) - City (
ciudad)
Show Inactive Toggle
By default, only active users are displayed. Enable the Show Inactive switch to view deactivated users.User Status Display
Users are displayed in a table with the following columns:| Column | Description |
|---|---|
| Name | User’s full name |
| Username | Login username |
| Email address | |
| Role | Assigned role |
| City | User’s assigned city |
| Status | Active (success chip) or Inactive (neutral chip) |
| Actions | Dropdown menu with available actions |
Row Selection
Users can be selected using checkboxes for bulk operations:- Click the header checkbox to select all visible users
- Click individual checkboxes to select specific users
- Selected count is displayed in the bulk action button
URL Parameters and Highlighting
The user table supports focus highlighting via URL parameters:- The matching user row is highlighted with primary color background
- The page scrolls to bring the user into view
- Highlight lasts for 4 seconds
- Search is cleared and inactive users are shown
Data Loading
User data is loaded from three services in parallel:Error Handling
The user management interface handles several error states:Network Errors
When the API is unreachable, users see:- Error icon with descriptive message
- Retry button to reload data
- Error detection using regex:
/failed to fetch|network/i
Permission Errors
Users withoutver_usuarios permission see:
- Lock icon with “No Permission” message
- Message to contact administrator
Session Verification
While verifying authentication session:- Loading spinner is displayed
- “Verifying session” message shown
Best Practices
User Account Management
- Always assign appropriate roles and permissions
- Use meaningful usernames (avoid generic names)
- Ensure email addresses are valid and monitored
- Regularly review inactive users
- Document reason for user deactivation (if needed)
Integration with Other Features
User management integrates with:- Permissions System: Assign granular permissions via the Permissions drawer
- Email Service: Automatic credential delivery and password reset
- Activity Logs: User actions are tracked in security logs
- Cities & Locations: User location assignment for reporting
- Supervisor Hierarchy: Organizational structure management
Related Pages
- Permissions - Configure role-based access control
- Settings - System configuration
- Locations - Manage cities and countries