User Points System

At a Glance

What This Section Does

The page has four tabs: Overview (summary stats), User points (table of users with points and ranks), History (point transaction history), and Settings (system configuration and enabled settings values).

Who Should Use This

1. Admins who see User Points in the sidebar and need to view or manage the user point system
2. Users who need to review point balances, ranks, history, or system settings

Most Common Tasks

1. View summary stats on the Overview tab
2. View and search the User points table (current points, ranks, changes)
3. View History of point transactions (type, amount, date)
4. View or edit Settings (user point system enable/disable, min value, min deposit)

Before You Start

1. Make sure you have these permissions:
   1. user_point: Required to manage user points, ranks, and system settings.

Overview

Section	Description
Overview	Page for managing user points, ranks, and system settings.
Main Tabs	Overview, User points, History, Settings

View & Search Features

Feature	Description
Overview stats	Overview tab shows Total Users with Points, Total Points Distributed, Average Points Per User, Users with Rank Changes.
User points table	User points tab: Search... textbox, Rank combobox, table with User, Current Points, Current Rank, Last Points, Last Rank, Point Change, Rank Change, Updated At, Actions (Show History button).
History table	History tab: Search by username or user ID textbox, All Types combobox, Filter by Created Date button, Created At combobox, table with User, Type, Amount, Date, Additional Data.
Settings	Settings tab: System Configuration and Enabled Settings values sections, each with an Edit button.

Manage Features

Feature	Description
Show History	User points tab: each row has a Show History button in the Actions column.
Edit (Settings)	Settings tab: Edit button next to User Point System and next to Enabled Settings values.
User link	In User points and History tables, the User cell contains a link (e.g. to /admin/users/{id}).

1. User Point System Management

Purpose

View and manage the user point system: summary statistics, per-user points and ranks, point transaction history, and system settings.

When to Use

Use this page when you need to monitor point distribution, look up a user’s points or rank, review point history by type/date, or change system settings (e.g. minimum investment value, minimum deposit amount).

Key Features

1. Overview tab: Four summary metrics (Total Users with Points, Total Points Distributed, Average Points Per User, Users with Rank Changes).
2. User points tab: Sortable/filterable table of users with current/last points and ranks, point/rank change, and Show History per row.
3. History tab: Table of point transactions with User, Type, Amount, Date, and Additional Data (button observed: "1").
4. Settings tab: User Point System switch (Enabled, observed as checked and disabled when not editing), and Enabled Settings values with Edit buttons.

2. Tabs & Content Structure

Main Tabs

Tab	Description
Overview	Default tab. Shows four stat blocks: Total Users with Points (e.g. "56"), Total Points Distributed (e.g. 6,080), Average Points Per User (e.g. "108.57"), Users with Rank Changes (e.g. "52"). No table.
User points	Table of users with points. Columns: User, Current Points, Current Rank, Last Points, Last Rank, Point Change, Rank Change, Updated At, Actions. Search... and Rank combobox above table. Rows per page (e.g. "10"), pagination (e.g. 1-10 of 56).
History	Table of point transactions. Columns: User, Type, Amount, Date, Additional Data. Search by username or user ID, All Types combobox, Filter by Created Date, Created At combobox. Pagination (e.g. 1-10 of 1847).
Settings	System Configuration: "User Point System" with description "Enable or disable the user point system", Edit button, and a switch Enabled. Enabled Settings values: Edit button; Creator Market And Invest Min Value (e.g. "30"): "Minimum investment value for creator market points"; Minimum Deposit Amount (e.g. "10"): "Minimum deposit amount required to earn points".

Column Descriptions (User points tab)

Column	Description
User	Avatar or initial (e.g. "J", "9") and username or ID as link to /admin/users/{uuid}.
Current Points	Numeric (e.g. 1,020, 860, 570, 530).
Current Rank	Rank with # (e.g. #1, #2, #6).
Last Points	Numeric (e.g. 1,020, 0, 10).
Last Rank	Rank with # (e.g. #1, #0, #26).
Point Change	Numeric (e.g. 0, 570, 520, 10).
Rank Change	"—" or signed change (e.g. +5, -20, +2, +3).
Updated At	Date/time (e.g. Feb 10 2026, 07:00).
Actions	Show History button.

Column Descriptions (History tab)

Column	Description
User	Avatar or initial and username/ID as link to /admin/users/{uuid}.
Type	Text (e.g. creatorMarketGoesLive, creatorMarketAndInvestMinValue, marketGoesLiveWithLiquidity, matchOrder).
Amount	Numeric (e.g. 30, 10).
Date	Date/time (e.g. Feb 10 2026, 19:58).

Key Notes

1. User points table: Rank combobox label was observed.
2. History table: All Types and Created At comboboxes were present; options were not opened.

3. Accessing the User Point System Management Page

Purpose

Open the User Point System Management page from the admin sidebar.

Steps

Step	Action	Details
1	Log in to back office	e.g. https://xmarket.app/admin.
2	Click User Points in sidebar	Click User Points.
3	Verify page	Overview tab selected.

Outcome

The User Point System Management page is open with the Overview tab visible and the four summary stats displayed.

4. Using the Overview Tab

Purpose

View high-level statistics for the user point system.

When to Use

Use when you need a quick summary of how many users have points, total points distributed, average points per user, and how many users had rank changes.

Steps

Step	Action	Details
1	Open Overview tab	Overview is the default tab when opening the page.
2	Read stats	Total Users with Points (e.g. "56"), Total Points Distributed (e.g. 6,080), Average Points Per User (e.g. "108.57"), Users with Rank Changes (e.g. "52").

Outcome

You have seen the current overview metrics for the user point system.

Key Notes

1. No search or filter on the Overview tab; it is read-only summary content.

5. Using the User Points Tab

Purpose

View the list of users with points, their current and previous points and ranks, and point/rank changes. Optionally search, filter by rank, and open history for a user.

When to Use

Use when you need to find a user’s points or rank, compare current vs last period, or open that user’s point history.

Steps

Step	Action	Details
1	Open User points tab	Click the User points tab. URL may update to ?activeTab=user_points.
2	Use Search (optional)	Type in the Search... textbox to filter by user.
3	Use Rank filter (optional)	Use the Rank combobox to filter by rank.
4	Review table	Check User, Current Points, Current Rank, Last Points, Last Rank, Point Change, Rank Change, Updated At.
5	Open user (optional)	Click the user name/link to go to /admin/users/{uuid}.
6	Show History (optional)	Click Show History in the Actions column for a row to view that user’s point history.

Outcome

You have viewed the user points table and can open user details or history.

Key Notes

1. Current Rank and Last Rank use # (e.g. #1, #26). Rank Change shows "—" when unchanged or values like +5, -20, +2.
2. Point Change can be 0 or positive (e.g. 570, 520, 10).
3. User cell can show an avatar image or an initial letter plus username or numeric ID.

6. Using the History Tab

Purpose

View the history of point transactions: user, type, amount, date, and additional data.

When to Use

Use when you need to audit point awards, filter by type or date, or look up transactions for a specific user.

Steps

Step	Action	Details
1	Open History tab	Click the History tab, or navigate to ?activeTab=history.
2	Search (optional)	Use Search by username or user ID to find a user.
3	Filter by type (optional)	Use the All Types combobox.
4	Filter by date (optional)	Click Filter by Created Date and/or use the Created At combobox.
5	Review table	Columns: User (link to admin user), Type, Amount, Date, Additional Data (button e.g. "1").

Outcome

You have viewed the point transaction history.

Key Notes

1. Type values observed: creatorMarketGoesLive (amount 30), creatorMarketAndInvestMinValue (10), marketGoesLiveWithLiquidity (10), matchOrder (10).
2. Date format observed: e.g. Feb 10 2026, 19:58.

7. Using the Settings Tab

Purpose

View system configuration for the user point system: enable/disable and enabled settings values.

When to Use

Use when you need to turn the user point system on or off or change minimum values for earning points.

Steps

Step	Action	Details
1	Open Settings tab	Click the Settings tab, or navigate to ?activeTab=settings.
2	View System Configuration	User Point System: description "Enable or disable the user point system." Edit button. Switch Enabled.
3	View Enabled Settings values	Edit button. Creator Market And Invest Min Value: value "30", description "Minimum investment value for creator market points". Minimum Deposit Amount: value "10", description "Minimum deposit amount required to earn points".
4	Edit (optional)	Click Edit to change configuration or settings.

Outcome

You have viewed the current system configuration and enabled settings values. If you clicked Edit, you can change them.

Key Notes

1. When not editing, the Enabled switch was disabled.
2. Edit buttons were present for both System Configuration and Enabled Settings values.

8. Filtering & Search

Purpose

Narrow the User points and History lists using search and filter controls.

Available Filters

Tab	Filter / Control	Description	How to Use
User points	Search...	Text search	Type in the Search... textbox.
User points	Rank	Rank filter	Combobox labeled Rank (options not opened).
History	Search by username or user ID	User search	Textbox placeholder "Search by username or user ID".
History	All Types	Type filter	Combobox All Types.
History	Filter by Created Date	Date filter	Button Filter by Created Date.
History	Created At	Sort or filter	Combobox Created At.

Key Notes

1. User points and History both have Rows per page and pagination below the table.
2. URL query activeTab reflects the selected tab (user_points, history, settings).

9. Troubleshooting

Issue	Inferred
User Points not in sidebar	User Points was visible if it is missing, access may depend on role or environment.
Page not loading	Navigating to /admin/user-point loaded /admin/user-point/manage with Overview selected.
Empty or missing data	Overview showed numeric stats; User points had 56 rows; History had 1847 rows.

10. Best Practices

Reviewing Points and Ranks

1. Use Overview for aggregate stats, then User points to inspect individual users and Rank Change / Point Change.
2. Use the User link to open the user’s admin profile when you need more context.
3. Use History to verify point transactions by Type and Date.

Using Filters

1. Use Search... (User points) or Search by username or user ID (History) to find a specific user.
2. Use Rank (User points) and All Types / Filter by Created Date (History) to narrow results before paging.

Settings

1. Check Settings to confirm the system is Enabled and to see Creator Market And Invest Min Value and Minimum Deposit Amount before changing behavior.
2. Use Edit when you need to change configuration or values.

Product Glossary

Term	Description
Additional Data	Column in History tab; contains a button with a numeric label (e.g. "1").
All Types	History tab for filtering by transaction type.
Created At	History tab (sort or filter by date).
Creator Market And Invest Min Value	Setting on Settings tab: "Minimum investment value for creator market points" (e.g. "30").
Current Points	Column on User points tab: user’s current point balance.
Current Rank	Column on User points tab: user’s current rank (e.g. #1, #6).
Enabled	Switch on Settings tab under User Point System; when checked, system is enabled.
Enabled Settings values	Section on Settings tab containing Creator Market And Invest Min Value and Minimum Deposit Amount.
Filter by Created Date	Button on History tab.
History	Tab showing point transaction history (User, Type, Amount, Date, Additional Data).
Last Points	Column on User points tab: user’s points in the previous period.
Last Rank	Column on User points tab: previous rank (e.g. #1, #26).
Minimum Deposit Amount	Setting on Settings tab: "Minimum deposit amount required to earn points" (e.g. "10").
Overview	Tab showing Total Users with Points, Total Points Distributed, Average Points Per User, Users with Rank Changes.
Point Change	Column on User points tab: change in points (e.g. 0, 570, 10).
Rank	Combobox on User points tab (filter by rank).
Rank Change	Column on User points tab: change in rank (e.g. +5, -20).
Settings	Tab showing System Configuration and Enabled Settings values, with Edit buttons.
Show History	Button in Actions column on User points tab; intended to show history for that user.
System Configuration	Section on Settings tab: User Point System enable/disable and Edit button.
User Point System	Label on Settings tab: "Enable or disable the user point system."
User Point System Management	Page heading.
User points	Tab showing table of users with points, ranks, and Show History action.
Users with Rank Changes	Stat on Overview tab (e.g. "52").