User role

In the system, system admin, super admins, and system developers have the capability to create different types of roles, such as "Admin," "Sales Manager," or "Salesperson." They can then assign specific permissions to these roles, allowing them to control what actions and functionalities each role can access within the system. This empowers administrators to manage user access and tailor permissions according to different job responsibilities and levels of authority.

Navigation to the page

• Login as an Admin > System > Roles

Navigation to User Roles

Functionality

Roles

When the user goes to the Roles screen, they can see a list of all the roles that have been created in the system. This list displays the names of the roles and allows the user to quickly view and access the details of each role. It provides a convenient overview of the existing roles and their properties.

Even though there's a space for a description in the GRID, currently there's no way to write a description for the user role using the user interface (UI). This might be added in the future.

Create Role form

When the user clicks on the "Create Role" button, they will be taken to a form where they can input the name of the new role and select which permissions to assign to it. The user has the option to choose one or more permissions to include in the role.

The "Name" field in the form is required, so the user must provide a name for the role.

If the user decides not to assign any permissions to the role, they can still save the new role without any assigned permissions.

Required field validation

Once the user clicks on the "Submit" button in the form, a success banner will appear on the screen, indicating that the role has been successfully created.

Create role success banner

---

View Role

When the user clicks on the "View" button of a specific role, they will be taken to a page where they can view the details of that role. On this page, they can see the name of the role and the list of permissions that have been granted for that particular role. This view provides a clear overview of the role and its associated permissions.

View role details

---

Edit Role

Edit role

When the user clicks on the "Edit" button for a particular role, they will be directed to a form where they can make changes to the role's name and the permissions assigned to it. After updating the necessary information, the user will be redirected back to the Roles screen.

A success banner will appear on the screen, indicating that the changes to the role have been successfully saved. This way, the user can easily manage and modify role details with ease.

Update role success banner

---

Delete Role

In the system, users can delete roles if they have the necessary permission to do so. When a user clicks on the "Delete" button for a role, a confirmation pop-up message will appear, asking them to confirm the deletion.

If the user clicks on the "OK" button in the pop-up, the role will be deleted, and a success banner will appear to notify the user that the role has been successfully removed from the system.

When a role is deleted, it's removed entirely from the database, unless it's being used elsewhere, like in the permissions section. If the role is marked as default (which is determined by the database), it can't be deleted.

Delete Role Confirmation

Delete role success banner

Database tables and queries

Below are the related DB tables:

• roles

Paths

Function Path

app/Http/Controllers/Admin/RoleController.php

The roles we create are displayed in a dropdown menu within the user creation form. This allows us to select the desired user role and assign permissions to the specific users we create.