Player list

1. What this page does

The Player list page (/player) serves as the central hub for finding, inspecting, and managing all player accounts across the website. Use this page to:

• Search and inspect player profiles, registered banks, mobile numbers, and VIP ranks.
• Audit and update account verification states.
• Execute manual deposits or confiscate credits during operational or technical discrepancies.
• Directly grant active promotions to individual accounts.
• Access the comprehensive Edit Player page (/player/[id]/edit) to inspect 6 dedicated tabs: Overview, Promotions, Wallet & Points, Action logs, Betting history, and Sign-in history.

This page is designed for system administrators and customer support staff managing daily player operations.

---

2. Before you start

• Required permissions:
  • You must have the 'Players' permission to view, search, create, or delete players.
  • You must have the 'Deposit for player' permission to perform manual deposits.
  • You must have the 'Withdraw for player' permission to perform manual confiscations.
  • You must have the 'Site bank accounts' update permission to edit a player's bank account.
  • If you lack phone or bank permissions, those sensitive numbers will appear masked as ****.
  • If you lack player password permissions, the 4-digit PIN is hidden and cannot be updated.
• Things to prepare:
  • New player details (mobile number, 4-digit PIN, full name, bank name, and account number).
  • Transfer slip image and explanation note for manual balance adjustments.
  • New bank passbook photo when updating a player's registered payout account.

---

3. Screen layout

This guide covers both the main player directory and the individual player edit view:

1. Player list table view (/player)

1. Page header: Shows the page title Player list and the Create player button for opening the new account modal.
2. Search & Filters: Features a quick text search bar, the Search button, the Advanced toggle for deeper criteria, and active filter badge tags.
3. Table toolbar: Includes a refresh button (spinning arrows), total player count indicator, and sorting dropdown.
4. Data table: Displays player accounts, rank badges, bank details, and action buttons in each row.
5. Pagination bar: Located at the bottom of the table to switch pages and select row counts (10, 20, 50, 100 items).

2. Player edit view (/player/[id]/edit)

Accessed by clicking a player's username or pressing the edit button in the table:

1. Page header: Shows breadcrumbs, page title Edit Player | [Username], and the Back button to return to the player table.
2. Player profile hero:
   • Left side: Avatar, full name, @username, VIP rank badge, phone number, registration date, last active timestamp, and account status badge.
   • Right side: 4 stat summary cards for Main balance, Points, Diamonds (spinner score), and Spin tickets.
3. 6 Main navigation tabs: Overview, Promotion, Wallet & Points, Action History, Betting History, and Sign-in History.
4. Sticky action bar: Docked at the bottom of the screen with Back, Cancel, and Save (enabled only when form changes occur).

---

4. Search and filters

1. Filters in the player directory

Filter / Field	Type	Options and usage	Result
Search players	Text input	Enter username, account name, bank number, referral code, or phone number and press Search	Filters table to matching accounts
Advanced	Button	Press to show or hide the 4 additional filter criteria	Opens advanced filter drawer
Status (Advanced)	Dropdown	Choose: All status, Active, or Inactive	Filters players by account active status
Rank (Advanced)	Dropdown	Select specific rank tier or All ranks	Displays only players within that VIP rank
Player bank (Advanced)	Dropdown	Select a specific bank institution	Filters players registered with that bank
Registration date (Advanced)	Date range picker	Select start and end dates	Shows players registered within that period
Clear all	Button	Click the clear filter pill below search bar	Resets all active filters to default
Sort by	Dropdown	Options: Default, Newest, or Oldest	Re-orders table by registration timestamp

2. Filters in the player edit view

Tab	Filter / Field	How to use	Result
Wallet & Points	Asset category tabs	Select: Player balance log, Points, Lucky wheel, Tickets, Check-ins, Missions, Leaderboard, Reports	Filters specific points and activity sub-logs
Betting History	Provider & Date picker	Select date range and specific game provider	Filters game rounds by provider and time
Sign-in History	Timeframe dropdown	Select timeframe option	Audits recent logins (IP, browser, device)

---

5. Data table

1. Columns in the player list table

Column	What you see	What it means	Badges or symbols
Registered date	Date and time (e.g. 21 Oct 2026, 14:30:15)	Timestamp when account was created	Click header to sort ascending or descending
Rank	Rank icon and badge (e.g. Bronze, Gold)	Player's current VIP rank tier	Colored badge matching rank tier
Player username	Player's username	System account identifier. Click name to open edit view	Bold text link
Bank	Bank logo and abbreviation	Primary bank registered for deposit/withdrawal	Bank color logo
Account name	First and last name	Real name of the bank account holder	Regular text (shows - if blank)
Account number	Bank account digits (e.g. 1234567890)	Bank account number	Masked as **** if unauthorized
Phone number	10-digit mobile number	Registered phone for OTP verification	Masked as **** if unauthorized
Status	Verification badge	Account identity verification state	Green = Verified, Red = Unverified
Manage	Action buttons	Available operations for this player	See action button details below

Row action buttons (Manage column)

Button	Icon / Color	Action	Notes / Conditions
Favorite star	Star icon / Yellow when active	Pins this player for quick tracking	Stored locally in your browser
Promotion	Gift box icon / Purple	Opens modal to grant a promotion directly	Available if promotions module is enabled
Deposit	Hand coin icon / Green	Opens Manual Deposit popup	Requires deposit permission
Withdraw	Cash icon / Orange	Opens Manual Confiscate popup	Requires withdraw permission
Edit	Pencil icon / Blue	Opens comprehensive edit view for all 6 tabs	Always available with view/edit access
Delete	Trash icon / Red	Removes player account permanently	Requires status to be set to Inactive first

2. Bank history table (Overview tab of Edit view)

Column	What you see	What it means	Badges or symbols
Bank	Bank logo and abbreviation	Bank previously registered	Color bank logo
Account name	Full name	Name of bank account holder	Regular text
Account number	Account number	Bank account digits	Masked as **** if unauthorized
Active period	Date and time	When this account was registered	Date & time format
Status	Usage badge	Whether this is the active account	Green badge = Current, Gray badge = Archived

3. Betting history table (Betting History tab of Edit view)

Column	What you see	What it means	Badges or symbols
Bet time	Date and time	Exact time the bet was placed	Standard timestamp
Provider / Game	Provider logo & game title	The game title played	Bold title text
Bet amount	Currency amount (e.g. 100.00)	Amount wagered on that round	Number format
Win/Loss	Currency amount	Net payout outcome	Green badge = Win (+), Red badge = Loss (-)
Round status	Status label	Settlement status of the bet	Green badge = Settled, Yellow badge = In-play

---

6. Step by step

1. Creating a new player

1. Go to Players > Player list from the left navigation.
2. Press Create player in the top right corner.
3. Fill in required fields in the modal: phone number, 4-digit PIN, real name, bank, and account number.
4. Press Create player.
5. A green success message appears, and the new player is immediately listed in the table.

2. Searching and filtering players

1. Type your keyword (phone, username, name) in Search players.
2. For specific segments, click Advanced.
3. Choose Status, Rank, Player bank, or a Registration date range.
4. Press Search.
5. To clear filters, click Clear all in the active filter pill list.

3. Executing a manual deposit

1. Find the target player in the table.
2. Press the Deposit button (green hand coin) in the Manage column.
3. In Deposit Info, enter the amount and optionally select a promotion.
4. In Bank Account, choose the receiving site bank.
5. In Attach Slip, upload transfer receipt evidence.
6. In Remark, choose a reason (e.g. delayed banking notification) and enter notes.
7. Press Submit manual deposit request.

4. Executing a manual credit confiscation

1. Find the target player in the table.
2. Press the Withdraw button (orange cash icon) in the Manage column.
3. In Withdrawal Info, enter the deduction amount.
4. In Bank Account, verify the linked bank if applicable.
5. In Attach Slip, upload irregularity proof if needed.
6. In Remark, choose the deduction reason (e.g. incorrect data or duplicated bonus).
7. Confirm the operation to deduct balance.

5. Inspecting and editing player details

1. Click the player's username or the Edit (blue pencil) icon.
2. The system opens the comprehensive player edit view (/player/[id]/edit).
3. In the Overview tab:
   • Update first name, last name, or mobile phone number.
   • Adjust account status (Active, Inactive, Suspended).
   • Toggle account identity verification.
   • View current 4-digit PIN or click Change password to set a new PIN.
4. Notice the Save button in the bottom sticky action bar becomes active.
5. Press Save to confirm changes.

6. Updating player bank account

1. In the player edit view, navigate to the Overview tab and locate the Bank details card.
2. Press the Edit player bank button to open the modal.
3. Select a new bank institution from active system banks.
4. Enter the account holder's name matching the passbook.
5. Type the new account number (10 to 15 digits).
6. Press Save in the modal.
7. The new bank becomes active immediately and the previous one moves to history.

7. Deleting a player

1. Verify the account status first. If still Active, enter the edit view, change status to Inactive, and press Save.
2. Return to the table and press the Delete (red trash) icon in that player's row.
3. In the confirmation popup, review the player's name and confirm deletion.
4. The account is permanently removed from the system.

---

7. Edit or add page

1. Create player modal fields (CreatePlayerModal)

Field	Required?	What to enter	Example	Validation rules
Phone number	Required	10-digit mobile number	0812345678	Exactly 10 digits starting with 0, must be unique
PIN code	Required	4-digit numeric login PIN	1234	Numbers only, exactly 4 digits
Confirm PIN	Required	Repeat the 4-digit PIN	1234	Must match PIN code
First name	Required	Legal first name on passbook	John	2 to 30 characters, no special symbols
Last name	Required	Legal last name on passbook	Doe	2 to 30 characters, no special symbols
Bank	Required	Select an active bank	Select KBANK	Must select from enabled system banks
Account number	Required	Bank account number	0123456789	Numbers only, minimum 10 digits
Referral code	Optional	Friend's referral code	AB12CD34	8 alphanumeric characters

2. Player edit view sections (/player/[id]/edit)

Tab 1: Overview

• Personal details: First name, last name, mobile phone number.
• Security: Current 4-digit PIN visibility and change PIN dialog.
• Account status: Radio selection between Active, Inactive, and Suspended.
• Account verification: Boolean toggle switch.
• Bank details: Active bank card, Edit player bank button, and historical bank records table.

Tab 2: Promotion

Displays active promotional campaigns attached to this player, wagering requirements, and expiration dates.

Tab 3: Wallet & Points

Provides asset balances and sub-tab logs for main balance, reward points, spinner diamonds, free spin tickets, check-in history, mission completions, and behavior reports.

Tab 4: Action History

Audit trail showing all staff members who inspected or modified this account, with exact timestamps and changed fields.

Tab 5: Betting History

Comprehensive game round history showing bet timestamps, provider, game title, stake amount, win/loss outcome, and round settlement state.

Tab 6: Sign-in History

Historical player login logs displaying login timestamps, IP addresses, device types (mobile/desktop), browsers, and operating systems.

---

8. Popups and modals

1. Create player modal (CreatePlayerModal)

• Triggered by: Pressing Create player in the top right corner.
• What you see: Form fields for mobile phone, PIN code, names, bank institution, and account number.
• Action required: Fill all required fields and press Create player.
• Outcome: Creates a new player account and adds them to the table.

2. Manual deposit modal (PlayerDepositModal)

• Triggered by: Pressing Deposit (green hand coin) in the player row.
• What you see: 4 tabs: Deposit Info, Bank Account, Attach Slip, and Remark.
• Action required: Enter amount, pick receiving site bank, attach slip, select reason, and confirm.
• Outcome: Credits balance directly into player wallet with an audited transaction record.

3. Manual confiscate modal (PlayerWithdrawModal)

• Triggered by: Pressing Withdraw (orange cash icon) in the player row.
• What you see: 4 tabs: Withdrawal Info, Bank Account, Attach Slip, and Remark.
• Action required: Enter deduction amount, select reason, attach optional proof, and confirm.
• Outcome: Deducts credits from player balance immediately.

4. Grant promotion modal (PlayerPromotionModal)

• Triggered by: Pressing Promotion (purple gift box) in the player row.
• What you see: List of eligible active promotional offers.
• Action required: Select target promotion, review requirements, and press Save.
• Outcome: Binds the promotion to the player's account.

5. Edit player bank modal (PlayerBankEditDialog)

• Triggered by: Pressing Edit player bank in the Overview tab of the edit view.
• What you see: Bank selection dropdown, account holder names, and bank account number.
• Action required: Select bank, type accurate holder names and account digits, and press Save.
• Outcome: Sets new bank as active and archives previous bank record to history table.

6. Delete confirmation modal (ConfirmModal)

• Triggered by: Pressing Delete (red trash) on an Inactive player.
• What you see: Warning message and target player's username.
• Action required: Verify account name and click Confirm.
• Outcome: Account is permanently deleted from the database.

---

9. Statuses and badge colors

Status badge	Color	Meaning	Next action
Verified	Green	Player identity and bank account verified	None; player can deposit and withdraw freely
Unverified	Red	Account not yet validated	Audit player details before toggling verified
Active	Green	Account enabled; player can log in and bet	Normal operations; must set Inactive before deletion
Inactive	Gray	Account disabled; player cannot log in	Set to this state before deleting or to pause account
Suspended	Red	Account frozen due to detected irregularities	Audit bet history and behavior reports before unblocking
Current (Bank)	Green	Primary active bank account for transactions	Used by system for incoming and payout processing
Archived (Bank)	Gray	Previously registered bank account	Retained for audit purposes; cannot be used
****	Gray	Sensitive data masked due to insufficient staff permissions	Contact manager for permission if needed

---

10. Common questions and troubleshooting

• Why are phone numbers or bank accounts displayed as ****? Your staff role lacks permission to view unmasked banking or phone credentials. Contact your manager to grant permissions in the Roles page.
• Why can't I delete a player? The system prohibits deleting active accounts. Open the player edit view, set account status to Inactive, press Save, and return here to delete.
• Why is the Save button grayed out in the edit view? The Save button enables only when changes are made to form fields. In view-only mode or when no fields are modified, the button remains disabled.
• What if a player forgets their 4-digit PIN? Authorized staff can open the player edit view, click the eye icon in Security to view the existing PIN, or press Change password to assign a new 4-digit PIN.
• Why didn't player balance update after deposit or confiscation? Press the refresh button (spinning arrows) in the table toolbar to pull latest data. If unchanged, check the Action logs tab in the edit view.
• Does updating bank account erase wallet balance? No. Wallet credits and bet histories remain completely intact; only the payout destination account changes.
• How do I audit which staff member edited an account? Open the player edit view and click the Action History tab to see a chronological log of all updates made to that player.