> For the complete documentation index, see [llms.txt](https://codehas.gitbook.io/repair-box/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codehas.gitbook.io/repair-box/users.md).
# π₯ Users
The Users module gives you full control over who can access your system, what they can do, and how they interact with the platform. You can create new users, assign roles, activate or deactivate access, and manage account details with ease.
This helps maintain a secure, role-based environment for your business operations.
***
#### π§° Key Features
* Create new users with role-based access
* Assign roles (e.g., Admin, Technician, Staff)
* Toggle user status (Activate/Deactivate)
* Edit user info, including password
* Delete users from the system
* Prevent login for deactivated users
* Email uniqueness enforced β one account per email address
***
#### π User Management Actions
**β Create a New User**
To add a user to your system:
1. Enter a unique name
2. Provide a valid, unique email address
3. Set a secure password
4. Assign a user role
5. Set status to either Activated or Deactivated
> π« Deactivated users are stored in the system (email is reserved) but cannot log in until reactivated.
***
**βοΈ Edit User**
You can update a userβs:
* Name
* Email
* Password
* Role
* Status (Activate/Deactivate)
Changes are applied immediately and affect the userβs access and permissions.
***
**ποΈ Delete User**
Remove a user from the system permanently. This is useful when:
* An employee has left your organization
* An account was created in error
* You want to clean up unused accounts
> β οΈ Note: Deletion is permanent and cannot be undone.
***
#### π€ User Details
*This information may be visible to others where applicable.*
* Name β Full name of the user *(Required)*
* Email β Unique and valid email address *(Required)*
* Password β A secure password for login *(Required)*
***
#### βοΈ User Settings
*Manage access and role-based permissions.*
* Role β Select the appropriate role for this user. Roles control permissions and access across the system *(Required)*
* Status β Toggle to activate or deactivate the user.
* β Activated β User can log in
* π« Deactivated β User cannot log in, but the account remains stored (email is reserved)
***
#### π§ Actions
* Cancel β Return to the user list without saving
* Save β Save the new user and apply all entered details
