Permissions List

1. Permissions Viewing Function

Permissions List Viewing Sequence

Step	Action	Details
1	Access List Permissions	Navigate to Roles & Permissions > List Permissions from the main navigation menu.
2	View Page Header	Review the page title "Permission Management" at the top of the page.
3	View Permissions Table	Review the table displaying all 21 system permissions with their Name, Key, Description, Created At, and Updated At columns.
4	Browse All Permissions	Scroll through the table or adjust rows per page to view all available permissions.
5	Check Total Permissions	View the pagination indicator showing "1 to 21 of 21" total permissions.

Permissions Table Columns

Column	Description
Select	Checkbox for selecting individual permissions for batch operations.
Name	The display name of the permission shown in user interfaces (e.g., Admin Market Management, Presale Pending Review).
Key	The unique system identifier or code for the permission used internally (e.g., admin_market, presale_pending_review).
Description	Detailed explanation of what capabilities the permission grants to users.
Created At	Date and timestamp when the permission 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 permission in M/D/YYYY, H:MM:SS AM/PM format, or dash (hyphen) if never updated.
Actions	Open menu button (three dots icon) providing access to Edit option.

2. Complete Permissions Catalog

Permissions Management Category

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

Markets Category

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

Presale Category

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

Users Category

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

System Category

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

3. Permission Editing Function

Permission Editing Access Sequence

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

Permission Editing Modification Sequence

Step	Action	Details
1	Review Display Name	Check the current Display Name field showing the permission's human readable name.
2	Modify Display Name	Update the text in the Display Name field to change how the permission appears in interfaces (editable).
3	Review Permission Key	Note that the Permission Key field is disabled and cannot be changed (system identifier is permanent).
4	Modify Description	Update the text in the Description field to clarify or expand what the permission allows (optional field).
5	Verify Changes	Review all modifications to ensure they accurately represent the permission's purpose.
6	Save or Close	Click Save to apply changes or Close to discard modifications and return to the permissions list.

Edit Permission Dialog Fields

Field	Description	Editable	Notes
Display Name	The human readable name shown in role creation dialogs and user interfaces.	Yes	Changes how the permission is labeled throughout the system.
Permission Key	The unique system code identifier (e.g., admin_market, roles_manage).	No	Disabled field, cannot be modified to maintain system integrity.
Description	Optional explanatory text describing what the permission allows users to do.	Yes	Helps administrators understand when to assign this permission.

Edit Permission Behavior

Behavior	Description
Pre Populated Fields	All editable fields display current values when the dialog opens.
Locked Permission Key	The Permission Key field is always disabled to prevent breaking system references.
Optional Description	The Description field is marked as optional and can be left empty if desired.
Save Updates Immediately	Clicking Save applies all changes immediately and updates the Updated At timestamp in the table.

4. Search Function

Permission Search Sequence

Step	Action	Details
1	Locate Search Field	Find the "Search permissions..." textbox at the top of the page.
2	Enter Search Term	Type keywords related to the permission name, key, or description you want to find.
3	View Filtered Results	The table updates to show only permissions matching your search criteria.
4	Review Matches	Examine the filtered results to find the specific permission you need.
5	Clear Search	Delete the text from the search field to return to viewing all 21 permissions.

Search Behavior

Behavior	Description
Real Time Filtering	The table may update dynamically as you type, or may require full keyword entry depending on implementation.
Multiple Field Search	Search may match against permission Name, Key, or Description fields.
Case Sensitivity	Search behavior may be case sensitive depending on implementation. Try both lowercase and title case if needed.
No Results Display	When no permissions match your search, the table shows "No data found." or similar message.
Pagination Updates	The pagination indicator updates to show the count of filtered results instead of total permissions.

5. Select All Function

Select All Permissions 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 permissions on the current page.
3	View Selected Rows	All permission rows display checked checkboxes indicating they are selected.
4	Perform Batch Action	Use selected permissions for bulk operations (if available in future updates).
5	Deselect All	Click the Select all checkbox again to deselect all permissions.

Select All Behavior

Behavior	Description
Current Page Only	Select all affects only permissions visible on the current page based on rows per page setting.
Visual Feedback	Selected rows may display visual highlighting to indicate selection status.
Individual Selection	You can also click individual row checkboxes to select specific permissions one at a time.
Future Functionality	Batch operations may be added in future updates for managing multiple permissions simultaneously.

6. Permission Functional Area

Category	Permissions Count	Purpose
Permissions Management	3	Control access to role and permission management functions.
Markets	4	Manage various market creation and categorization features.
Presale	3	Control presale market review, revenue sharing, and fee distribution.
Users	4	Manage staff, platform users, deposits, and withdrawals.
System	7	Control governance, configuration, monitoring, analytics, and operational tools.

Overview

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

No.	Key Features	Permission Key	Whitelist Type
1	Permissions List Viewing	permissions_list	-
2	Permission Editing	permissions_list	-
3	Complete Permissions Catalog	permissions_list	-
4	Search & Filter	permissions_list	-
5	Select All Function	permissions_list	-

Permissions List Viewing

Step	Instruction
1	Navigate to Roles & Permissions > List Permissions from the main navigation menu.
2	The page displays "Permission Management" as the title with all 21 system permissions.
3	Each permission row shows Name, Key, Description, Created At, Updated At, and Actions.
4	Most permissions were created on 7/17/2025 at 5:49:28 PM with matching Updated At timestamps.
5	Manage Permissions was created later on 7/19/2025 at 4:16:16 PM and shows dash (hyphen) for Updated At.
6	Use this view to understand all available permissions and their system codes.

Permission Editing

Step	Instruction
1	Locate the permission to edit in the Permissions List table.
2	Click the Open menu button (three dots) in the Actions column.
3	Select Edit from the dropdown menu.
4	The "Edit Permission" dialog opens with all fields pre populated with current values.
5	Update the Display Name if you want to change how the permission is labeled in interfaces.
6	Note that Permission Key is disabled and cannot be changed (preserves system integrity).
7	Update the Description field to clarify or expand the permission's purpose (optional).
8	Click Save to apply all changes or Close to discard modifications.
9	The Updated At timestamp in the table updates to reflect the modification time.

Search Function

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

Best Practices for List Permissions

Practice	Description
Clear Display Names	Use concise, descriptive display names that immediately communicate what the permission allows (e.g., "User Withdrawals" not "Permission 12").
Detailed Descriptions	Write comprehensive descriptions explaining exactly what capabilities the permission grants and when it should be included in roles.
Never Change Permission Keys	The system prevents this, but understand that permission keys are permanent identifiers. Changing display names is safe and encouraged for clarity.
Document Permission Usage	Maintain external documentation listing which permissions are included in which roles to understand access patterns.
Regular Audits	Periodically review all permission descriptions to ensure they accurately reflect current system capabilities.
Consistent Naming Conventions	Establish naming patterns for display names (e.g., always end with "Management" for admin functions, "View" for read only).
Group Related Permissions	When assigning permissions to roles, group related permissions together (e.g., all market management permissions in one role).
Test Permission Changes	After editing permission names or descriptions, verify they display correctly in role creation dialogs and other interfaces.
Preserve System Permissions	Avoid editing core system permissions unless necessary. Focus edits on custom permissions if your system allows them.
Use Search for Quick Reference	When creating or editing roles, use the search function to quickly find specific permissions by keyword.

Product Glossary

Term	Description
List Permissions	The administrative interface for viewing and editing the 21 system permissions available for assignment to roles.
Permission	A specific capability or access right that defines what actions a user can perform in the system. Permissions are assigned to roles, which are then assigned to users.
Permission Management	The system for viewing, organizing, and editing permissions that control access to platform features and functions.
Permission Name	The human readable display name for a permission shown in user interfaces (e.g., Admin Market Management, User Withdrawals).
Permission Key	The unique system identifier or code for a permission used internally by the platform (e.g., admin_market, user_withdrawals). Cannot be changed after creation.
Permission Description	Explanatory text that clarifies what capabilities the permission grants and when it should be assigned to roles.
Permissions List Table	The main data table displaying all 21 permissions with columns for selection, name, key, description, and timestamps.
Created At	Timestamp indicating when a permission 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 permission's display name or description, shown in M/D/YYYY, H:MM:SS AM/PM format or dash (hyphen) if never updated.
Open Menu Button	Action button (three dots icon) in the Actions column that reveals the Edit option for a permission.
Edit Permission Dialog	Modal window for modifying a permission's display name and description while preserving the unchangeable permission key.
Search Permissions Field	Text input field for filtering the permissions table by searching for keywords in permission names, keys, or descriptions.
Select All Checkbox	Checkbox in the table header row that selects or deselects all visible permissions on the current page.
Manage Permissions	Permission allowing users to view all permissions and assign them to roles. Key: roles_manage.
Admin Market Management	Permission for managing admin created markets. Key: admin_market.
Creator Market Management	Permission for managing creator submitted markets. Key: creator_market.
Market Categories	Permission for managing market categories. Key: market_categories.
Market Tags	Permission for managing market tags. Key: market_tags.
Presale Pending Review	Permission for reviewing and approving presale market submissions. Key: presale_pending_review.
Presale Revenue Share	Permission for managing presale revenue distribution. Key: presale_revenue_share.
Presale Fee Shares	Permission for managing presale fee structures. Key: presale_fee_shares.
Back office Staff Management	Permission for managing back office staff users and their role assignments. Key: back_office_staff.
Platform Users Management	Permission for managing platform users. Key: platform_users.
User Deposits	Permission for managing user deposit transactions. Key: user_deposits.
User Withdrawals	Permission for managing user withdrawal transactions. Key: user_withdrawals.
Governance Management	Permission for managing governance settings, revenue buyback, and token burn operations. Key: governance_manage.
System Configuration	Permission for configuring system settings and variables. Key: system_configuration.
QT and Fees Management	Permission for managing QT tokens and fee parameters. Key: system_qt_and_fees.
Bot Management	Permission for managing bot operations and configurations. Key: bot_management.
List Roles Permission	Permission for viewing all roles and role information in the List Roles interface. Key: roles_list.
List Permissions Permission	Permission for viewing all permissions and the permission matrix in the List Permissions interface. Key: permissions_list.
Bridge Monitoring	Permission for viewing operation bridge monitoring data and status. Key: operation_bridge.
Dashboard Analytics	Permission for accessing dashboard analytics and system metrics. Key: dashboard_analytics.
Referral	Permission for viewing all referral related data and statistics. Key: referral.
Display Name	The editable human readable label for a permission shown throughout the admin interface and role creation dialogs.
Permission Key Field	Disabled dropdown in the Edit Permission dialog showing the unchangeable system code for the permission.
Description Field	Optional editable text area in the Edit Permission dialog for explaining the permission's purpose and scope.
Save Button	Confirmation button in the Edit Permission dialog that applies changes and closes the dialog.
Close Button	Action button in dialogs that discards unsaved changes and returns to the permissions list.
No Data Found	Message displayed in the table when search filters return no matching permissions.
Real Time Filtering	Search functionality that may update table results dynamically as keywords are typed.
System Identifier	The permission key that serves as a permanent, unchangeable reference used by the platform's access control system.
Pre Populated Fields	Form fields in the Edit Permission dialog that display current values when opened, ready for modification.
Functional Area	Logical grouping of related permissions (Permissions Management, Markets, Presale, Users, System) for organizational clarity.
Access Control	The system of permissions and roles that determines what actions users can perform on the platform.
Permission Matrix	A comprehensive view of all permissions and their assignments across different roles, viewable with the List Permissions permission.
Case Sensitivity	Search behavior characteristic where uppercase and lowercase letters may be treated differently in search queries.