List Roles

1. Roles Viewing

Roles List Viewing Sequence

Step	Action	Details
1	Access List Roles	Navigate to Roles & Permissions > List Roles from the main navigation menu.
2	View Page Header	Review the page title "Role Management" at the top of the page.
3	View Roles Table	Review the table displaying all roles with their details including Name, Description, Permissions Count, Created At, and Updated At columns.
4	Review Role Information	Each row shows complete information for a single role in the system.

Roles Table Columns

Column	Description
Select	Checkbox for selecting individual roles for batch operations.
Name	The unique name identifier for the role (e.g., Admin, Operator, Super admin).
Description	Detailed description explaining the purpose and scope of the role.
Permissions Count	Total number of permissions assigned to this role (e.g., "14 permissions").
Created At	Date and timestamp when the role was first created in M/D/YYYY, H:MM:SS AM/PM format.
Updated At	Date and timestamp of the most recent modification to the role in M/D/YYYY, H:MM:SS AM/PM format.
Actions	Open menu button (three dots icon) providing access to Edit and Delete options.

Existing Roles Overview

Role Name	Permissions Count	Description	Purpose
Xmarket Ops Team	1	Xmarket Ops Team All market activities.	—

2. Role Creation

Role Creation Initiation Sequence

Step	Action	Details
1	Click Add Role Button	Locate and click the Add Role button at the top of the page, next to the page title.
2	Open Creation Dialog	A dialog titled "Create New Role" appears with the subtitle "Add a new role to the system."
3	View Empty Form	The dialog displays empty fields for Role Name, Description, and a list of available permissions.

Role Creation Fields Completion Sequence

Step	Action	Details
1	Enter Role Name	Type a unique name for the role in the Role Name textbox (required field).
2	Enter Description	Type a clear description explaining the role's purpose and scope in the Description textbox (required field).
3	Review Permissions List	Scroll through the list of 21 available permissions displayed with checkboxes.
4	Select Permissions	Check the boxes next to each permission you want to assign to this role.
5	Review Selections	Verify all selected permissions align with the role's intended purpose.
6	Save or Cancel	Click Save to create the role or Close to discard and return to the roles list.

Role Creation Dialog Fields

Field	Description	Required
Role Name	Unique identifier for the role (e.g., "Content Manager", "Reviewer"). Must be unique across all roles.	Yes
Description	Detailed explanation of the role's purpose, responsibilities, and scope. Helps administrators understand when to assign this role.	Yes
Select Permissions	List of checkboxes for all 21 available system permissions. Check each permission to include in the role.	At least one

3. Role Editing

Role Editing Access Sequence

Step	Action	Details
1	Locate Role	Find the role you want to edit in the Roles List table.
2	Click Open Menu	Click the Open menu button (three dots icon) in the Actions column for the selected role.
3	Select Edit Option	A dropdown menu appears with Edit and Delete options. Click Edit.
4	Open Edit Dialog	The "Edit Role" dialog appears with the subtitle "Edit an existing role's details."
5	View Current Settings	All fields are pre populated with the role's current name, description, and permission selections.

Role Editing Modification Sequence

Step	Action	Details
1	Modify Role Name	Update the text in the Role Name field if you want to rename the role (optional).
2	Modify Description	Update the text in the Description field to clarify or expand the role's purpose (optional).
3	Review Current Permissions	Scroll through the permissions list to see which permissions are currently checked for this role.
4	Add Permissions	Check additional permission boxes to grant new capabilities to the role.
5	Remove Permissions	Uncheck permission boxes to revoke capabilities from the role.
6	Verify Changes	Review all modifications to ensure they align with the role's intended purpose.
7	Save or Cancel	Click Save to apply changes or Close to discard modifications and return to the roles list.

Edit Role Dialog Behavior

Behavior	Description
Pre Populated Fields	All fields display current values when the dialog opens, allowing you to see existing settings before making changes.
Checked Permissions	Permissions currently assigned to the role appear with checked boxes, making it easy to see current capabilities.
Unchecked Permissions	Permissions not assigned to the role appear with unchecked boxes, ready to be selected if needed.
Save Updates Immediately	Clicking Save applies all changes immediately and updates the Updated At timestamp in the table.

4. Role Deletion

Role Deletion Sequence

Step	Action	Details
1	Locate Role	Find the role you want to delete in the Roles List table.
2	Click Open Menu	Click the Open menu button (three dots icon) in the Actions column for the selected role.
3	Select Delete Option	A dropdown menu appears with Edit and Delete options. Click Delete.
4	Confirm Deletion	A confirmation dialog may appear asking you to confirm the deletion (implementation dependent).
5	Complete Deletion	The role is removed from the system and disappears from the roles list.

Role Deletion Considerations

Consideration	Details
Irreversible Action	Once a role is deleted, it cannot be recovered. You must recreate it manually if needed.
User Impact	Deleting a role affects all users currently assigned to that role. Plan user reassignments before deletion.
Permission Loss	Users assigned to the deleted role lose all associated permissions immediately upon deletion.
System Roles	Some system critical roles may be protected from deletion to maintain platform functionality.

5. Search Function

Role Search Sequence

Step	Action	Details
1	Locate Search Field	Find the "Search roles..." textbox at the top of the page, below the Add Role button.
2	Enter Search Term	Type keywords related to the role name or description you want to find.
3	View Filtered Results	The table updates automatically to show only roles matching your search criteria.
4	Review Matches	Examine the filtered results to find the specific role you need.

Search Behavior

Behavior	Description
Real Time Filtering	The table updates dynamically as you type, providing instant feedback on search results.
Case Sensitivity	Search may be case sensitive depending on implementation. Try both lowercase and title case if needed.
No Results Display	When no roles match your search, the table shows "No data found." message.

6. Available Permissions Catalog

Permissions Management Category

Permission	Display Name	Description	Key
Manage Permissions	Manage Permissions	View all permissions and assign roles	roles_manage
List Roles	List Roles	View all roles and role information	roles_list
List Permissions	List Permissions	View all permissions and permission matrix	permissions_list

Markets Category

Permission	Display Name	Description	Key
Admin Market Management	Admin Market Management	Manage admin created markets	admin_market
Creator Market Management	Creator Market Management	Manage creator submitted markets	creator_market
Market Categories	Market Categories	Manage market categories	market_categories
Market Tags	Market Tags	Manage market tags	market_tags

Presale Category

Permission	Display Name	Description	Key
Presale Pending Review	Presale Pending Review	Review and approve presale market submissions	presale_pending_review
Presale Revenue Share	Presale Revenue Share	Manage presale revenue distribution	presale_revenue_share
Presale Fee Shares	Presale Fee Shares	Manage presale fee structures	presale_fee_shares

Users Category

Permission	Display Name	Description	Key
Back office Staff Management	Back office Staff Management	Manage back office staff users and roles	back_office_staff
Platform Users Management	Platform Users Management	Manage platform users	platform_users
User Deposits	User Deposits	Manage user deposits	user_deposits
User Withdrawals	User Withdrawals	Manage user withdrawals	user_withdrawals

System Category

Permission	Display Name	Description	Key
Governance Management	Governance Management	Manage governance settings, revenue buyback and token burn	governance_manage
System Configuration	System Configuration	Configure system settings and variables	system_configuration
QT and Fees Management	QT and Fees Management	Manage QT tokens and fee parameters	system_qt_and_fees
Bot Management	Bot Management	Manage bot operations and configurations	bot_management
Dashboard Analytics	Dashboard Analytics	Access to dashboard analytics and system metrics	dashboard_analytics
Referral	Referral	View all referrals	referral

7. Select All Function

Select All Roles Sequence

Step	Action	Details
1	Locate Select All Checkbox	Find the checkbox in the table header row labeled "Select all".
2	Click Select All	Click the checkbox to select all visible roles on the current page.
3	View Selected Rows	All role rows display checked checkboxes indicating they are selected.
4	Perform Batch Detele	Use selected roles for bulk Deletion.
5	Deselect All	Click the Select all checkbox again to deselect all roles.

Select All Behavior

Behavior	Description
Current Page Only	Select all affects only roles visible on the current page, not all roles across all pages.
Visual Feedback	Selected rows may display visual highlighting to indicate selection status.
Individual Selection	You can also click individual row checkboxes to select specific roles one at a time.

Overview

Back-office staff must be assigned the permission key to access and whitelisted to operate market.

No.	Feature	Permission Key	Whitelist Type
1	Roles List Viewing	roles_list	-
2	Role Creation	roles_list	-
3	Role Editing	roles_list	-
4	Role Deletion	roles_list	-
5	Search Function	roles_list	-

Roles List Viewing

Step	Instruction
1	Navigate to Roles & Permissions > List Roles from the main navigation menu.
2	The page displays "Role Management" as the title with 5 existing roles.
3	Review the table showing: Xmarket Ops Team (1 perm), Treasury Ops (2 perms), Admin (14 perms), Operator (7 perms), Super admin (21 perms).
4	Each role row displays Name, Description, Permissions Count, Created At, Updated At, and Actions.
5	Use the table to understand current role structure and permission distribution in the system.

Role Creation

Step	Instruction
1	Click the Add Role button at the top of the page.
2	The "Create New Role" dialog opens with empty fields.
3	Enter a unique Role Name that clearly identifies the role's purpose.
4	Enter a detailed Description explaining when and why to assign this role.
5	Scroll through the list of 21 permissions and check each one needed for this role.
6	Verify all selections align with the role's intended responsibilities.
7	Click Save to create the role or Close to cancel.
8	The new role appears in the table with current timestamps and permission count.

Role Editing

Step	Instruction
1	Locate the role to edit in the Roles List table.
2	Click the Open menu button (three dots) in the Actions column.
3	Select Edit from the dropdown menu.
4	The "Edit Role" dialog opens with all fields pre populated with current values.
5	Modify the Role Name if renaming the role (optional).
6	Update the Description to clarify the role's purpose (optional).
7	Check additional permission boxes to grant new capabilities to the role.
8	Uncheck permission boxes to revoke capabilities from the role.
9	Click Save to apply all changes or Close to discard modifications.
10	The Updated At timestamp in the table updates to reflect the modification time.

Role Deletion

Step	Instruction
1	Locate the role to delete in the Roles List table.
2	Click the Open menu button (three dots) in the Actions column.
3	Select Delete from the dropdown menu.
4	Confirm the deletion if prompted by a confirmation dialog.
5	The role is permanently removed from the system and disappears from the table.
6	Note: Users previously assigned this role lose all associated permissions immediately.

Search Function

Step	Instruction
1	Locate the "Search roles..." textbox at the top of the page.
2	Type keywords from the role name or description you want to find.
3	The table filters automatically to show only matching roles.
4	If no matches are found, "No data found." appears in the table.
5	Clear the search field to return to viewing all roles.

Product Glossary

Term	Description
List Roles	The administrative interface for viewing, creating, editing, and deleting user roles in the X Market platform.
Role	A named collection of permissions that defines what actions a user can perform in the system. Roles are assigned to users to grant them specific capabilities.
Role Management	The system for creating, modifying, and organizing roles to control user access and capabilities across the platform.
Role Name	The unique identifier for a role used throughout the system (e.g., Admin, Operator, Super admin). Must be unique and descriptive.
Description	Explanatory text that clarifies the purpose, scope, and appropriate use cases for a role.
Permission	A specific capability or access right that can be granted to a role, allowing users with that role to perform particular actions in the system.
Permissions Count	The total number of permissions assigned to a role, displayed in the format "X permissions" (e.g., "14 permissions").
Select Permissions	The section in role creation/edit dialogs displaying all available permissions as checkboxes for assignment to the role.
Add Role Button	Action button at the top of the page that opens the Create New Role dialog for adding new roles to the system.
Create New Role Dialog	Modal window for creating a new role, containing fields for Role Name, Description, and permission selection.
Edit Role Dialog	Modal window for modifying an existing role's name, description, and permission assignments.
Open Menu Button	Action button (three dots icon) in the Actions column that reveals Edit and Delete options for a role.
Search Roles Field	Text input field for filtering the roles table by searching for keywords in role names or descriptions.
Roles List Table	The main data table displaying all roles with columns for selection, name, description, permissions count, timestamps, and actions.
Created At	Timestamp indicating when a role was first created in the system, displayed in M/D/YYYY, H:MM:SS AM/PM format.
Updated At	Timestamp showing the most recent modification to a role, displayed in M/D/YYYY, H:MM:SS AM/PM format.
Xmarket Ops Team	Existing role with 1 permission designed for operational team members handling market activities with restrictions on fee settings and withdrawal approval.
Treasury Ops	Existing role with 2 permissions focused on treasury and financial management operations.
Admin	Existing role with 14 permissions providing administrative access including user management and most platform functions.
Operator	Existing role with 7 permissions designed for day to day operational market tasks with standard management permissions.
Super admin	Existing role with all 21 permissions providing complete system access and control over all platform functions.
Manage Permissions	Permission allowing users to view all permissions and assign roles to other users. Code: roles_manage.
Admin Market Management	Permission for managing admin created markets. Code: admin_market.
Creator Market Management	Permission for managing creator submitted markets. Code: creator_market.
Market Categories	Permission for managing market categories. Code: market_categories.
Market Tags	Permission for managing market tags. Code: market_tags.
Presale Pending Review	Permission for reviewing and approving presale market submissions. Code: presale_pending_review.
Presale Revenue Share	Permission for managing presale revenue distribution. Code: presale_revenue_share.
Presale Fee Shares	Permission for managing presale fee structures. Code: presale_fee_shares.
Back office Staff Management	Permission for managing back office staff users and their role assignments. Code: back_office_staff.
Platform Users Management	Permission for managing platform users. Code: platform_users.
User Deposits	Permission for managing user deposit transactions. Code: user_deposits.
User Withdrawals	Permission for managing user withdrawal transactions. Code: user_withdrawals.
Governance Management	Permission for managing governance settings, revenue buyback, and token burn operations. Code: governance_manage.
System Configuration	Permission for configuring system settings and variables. Code: system_configuration.
QT and Fees Management	Permission for managing QT tokens and fee parameters. Code: system_qt_and_fees.
Bot Management	Permission for managing bot operations and configurations. Code: bot_management.
List Roles Permission	Permission for viewing all roles and role information. Code: roles_list.
Dashboard Analytics	Permission for accessing dashboard analytics and system metrics. Code: dashboard_analytics.
Referral	Permission for viewing all referral related data. Code: referral.
Permission Code	The unique system identifier for a permission, used internally by the platform (e.g., roles_manage, admin_market).
Save Button	Confirmation button in creation/edit dialogs that applies changes and closes the dialog.
Close Button	Action button in dialogs that discards unsaved changes and returns to the roles list.
No Data Found	Message displayed in the table when search filters return no matching roles.
Real Time Filtering	Search functionality that updates table results dynamically as keywords are typed.
System Critical Roles	Roles essential for platform operation that may be protected from deletion to maintain functionality.
Pre Populated Fields	Form fields in the Edit Role dialog that display current values when opened, ready for modification.
Case Sensitivity	Search behavior characteristic where uppercase and lowercase letters are treated differently in search queries.