Missions by Rank

1. What this page does

The Missions by Rank page allows administrators to configure recurring daily, weekly, and monthly missions tailored to each player rank (level) so players can earn rewards such as points, lucky wheel tickets, and diamonds. Administrators can enable or disable missions, set deposit, turnover, or daily login targets independently for each rank, reorder lobby mission cards, and review comprehensive performance analytics and reward claim history. Legacy mission history pages automatically redirect to this page.

---

2. Before you start

• Required Permissions:
  • You must have the 'Missions by rank' permission in Roles to view and modify mission sets for each rank.
  • You must have the 'Missions by rank - report and history' permission in Roles to access the report and reward claim history tab.
  • If you only possess the report permission, you will be able to inspect reports and claim logs, but you cannot alter mission targets or rewards.
• Prerequisites:
  • Member Ranks: Member ranks must be configured first in Players > Rank Config. The system fetches these ranks to display the selector list.
  • Mission Structure: Plan targets and rewards appropriate for each rank level (e.g. entry-level ranks have lower targets to encourage engagement, while VIP ranks offer higher targets with premium rewards).

---

3. Screen layout

When opening this page, you will see the following key areas:

1. Page Header: Displays the breadcrumb Missions by rank, page title, and system description.
2. Page Tabs:
   • Missions by rank: Manage and configure missions for each rank.
   • Report and history: Performance summary, claim trends, category breakdowns, and player reward claim logs.
3. Rank Selector (Left Panel): Lists all configured ranks ordered by tier level, displaying each rank's badge, name, and the count of active missions.
4. Selected Rank Header: Shows the rank badge, rank name, active missions summary (e.g., "5 of 13 active"), and last update info.
5. Search and Order Controls: Search bar to filter missions by title, plus drag-and-drop handles and ordering buttons.
6. Mission Cards: Displays cards for each category (e.g. Daily Login, Daily Deposit, Slot Turnover, Casino Turnover) with an active switch and edit button.
7. Bottom Action Bar: Displays Cancel and Save missions buttons whenever changes are made.

---

4. Search and filters

Filters on Missions by Rank Tab

• Search missions...: Type a mission name or category (e.g. Slot, Deposit) to filter the cards on screen.

Filters on Report and History Tab

Field / Filter	Type	Options / How to use	Result
Period	Quick preset buttons	Choose: Today, 7 days, 30 days, or Custom (up to 92 days)	Filters summary statistics, trend charts, and the claim history table by date range.
Mission Category	Dropdown	Select All categories or a specific type such as Daily Login, Daily Deposit, Slot	Filters reports and tables to show only the selected category.
Search player...	Text input	Type a player username in the search box above the history table	Displays only reward claims made by that player.
Clear	Button	Press the Clear button next to the search box	Resets the search query to show all records.
Refresh (Circular Arrow)	Button	Press to fetch the latest analytics and claim records	Instantly reloads report numbers and table rows.

---

5. Data tables

Reward Claim History Table (Report & History Tab)

Column	What you see	Meaning	Badge or Symbol
Claimed At	Date and time (e.g. 21/10/2026, 15:45)	Timestamp when the player claimed the reward	Standard date/time format
Player	Player username (e.g. vip_user01)	Account that completed the mission and claimed the reward	Bold username text
Mission	Category icon and mission name (e.g. Slot)	Mission category completed	Category icon
Rank	Rank badge and name	Player's rank at the time of claim	Rank icon and badge
Reward	Reward badges (e.g. +100 Points, +2 Tickets)	Items credited to the player's wallet	• Orange: Points • Red: Wheel tickets • Blue: Diamonds

Categories Breakdown Table (Report & History Tab)

Column	What you see	Meaning	Badge or Symbol
Category	Icon and category title (e.g. Daily Deposit)	Mission type where rewards were claimed	Category icon
Players	Number of unique players (e.g. 1,250)	Total distinct players who completed this mission	Right-aligned number
Total Claims	Claim count with percentage bar	Total times rewards were claimed, with a visual share % bar	Number and blue progress bar
Rewards Paid	Summary badges of rewards paid out	Aggregate rewards disbursed for this category	Orange, red, and blue badges

---

6. Step-by-step

1. Selecting and enabling missions for a rank

1. Navigate to Activities > Missions by rank from the main menu.
2. In the left panel, select the target member rank (e.g. Bronze or Gold).
3. In the mission cards on the right, locate the mission you want to enable.
4. Toggle the switch on the card to Active (Green). (If the mission has never been configured with a target and reward, the edit form will expand automatically).
5. Enter the target and reward amounts as explained in Section 7.
6. Scroll down and press Save missions on the bottom action bar.

2. Editing mission targets and rewards

1. Select the member rank in the left panel.
2. Click the pencil icon (Edit) or click the card title of the mission you want to modify.
3. The card expands into an inline form. Configure:
   • Target: Enter the required amount (e.g. 500 THB deposit or 1000 THB turnover).
   • Reset cycle: Choose Daily, Weekly, or Monthly.
   • Rewards: Select reward types (Points, Tickets, Diamonds) and enter reward quantities.
4. Review the auto-generated bilingual preview text (Thai and English) in the bottom box.
5. Click Done to collapse the card.
6. Press Save missions on the bottom action bar.

3. Reordering mission cards

1. Select the member rank in the left panel.
2. Click and hold the 6-dots handle on the left edge of a card, then drag it up or down to reposition.
3. Alternatively, click the Move up or Move down arrow buttons on the card.
4. Once arranged, press Save missions on the bottom action bar. The new order will immediately reflect in the player lobby.

4. Exporting claim history to CSV

1. Switch to the Report and history tab.
2. Select the desired date period and category filter.
3. Scroll down to the Reward claim history section.
4. Click Export CSV at the top right of the table.
5. The system downloads mission-rewards-<start>_<end>.csv to your computer (up to 5,000 records per export).

---

7. Edit / Add forms

Mission editing is performed directly within each mission card. The fields are as follows:

Field	Required?	What to enter	Example	Rules & Constraints
Target	Required	Numerical target value player must reach	500 (THB) or 3 (Days)	• Login mission: count in days • Other missions: amount in THB (> 0)
Reset cycle	Required	How often the mission counter resets	Daily	Choose: Daily, Weekly, or Monthly
Reward type	Required	Types of rewards awarded upon completion	Points	Choose from: Points, Tickets, or Diamonds
Reward amount	Required	Quantity of reward received	50	Positive integer greater than 0
Active switch	Required	Enable or disable this mission for the rank	Active (Green)	On or Off

---

8. Popups and dialogs (Popup / Modal)

1. Live Changes Confirmation Dialog

• When it opens: When clicking Save missions after modifying numbers or disabling a mission that is currently Active in the system.
• What you see: A warning modal listing the modified missions, noting that new targets take effect immediately. In-progress players must fulfill the new targets.
• What to do: Review the affected missions carefully, then click the blue Save button (or click Cancel to review).
• Result: Changes take effect immediately. Players who already claimed rewards keep them; uncompleted players must meet the new requirements.

2. Discard Changes Confirmation Dialog

• When it opens: When selecting a different member rank on the left while unsaved changes exist in the current rank.
• What you see: A warning that unsaved edits will be lost.
• What to do: Click Discard to abandon changes, or click Keep editing to stay and save your changes first.
• Result: If discarded, all pending changes are reset and the page switches to the newly selected rank.

3. Version Conflict Dialog

• When it opens: When clicking Save missions, but another administrator has modified and saved the same rank's missions in the meantime.
• What you see: An alert indicating that the screen data does not match the latest database version.
• What to do: Click Load latest to fetch the latest settings, then re-apply your changes.
• Result: Prevents accidental overwrites of coworker updates.

---

9. Statuses and badges

Badge / Symbol	Color	Meaning	Next Action
Active	Green	Mission is active and available to players in this rank.	Normal operational state.
Inactive	Gray	Mission is disabled and hidden from players in the lobby.	Toggle switch to green when ready to activate.
Cycle: Daily	Blue	Target progress resets every day at 00:00.	Players can complete and claim once per day.
Cycle: Weekly	Blue	Target progress resets every Monday at 00:00.	Players can complete and claim once per week.
Cycle: Monthly	Blue	Target progress resets on the 1st of each month at 00:00.	Players can complete and claim once per month.
Red Card Border	Red	Active mission that is missing required target or reward values.	Click edit and fill in valid targets and rewards.

---

10. Frequently asked questions / Troubleshooting

• Why does the edit form open automatically when turning on a mission?
  • Active missions require valid target and reward values greater than 0. If the mission was previously unconfigured, the system automatically expands the form so you can fill in the values before activation.
• Why does a red border appear around a mission card when saving?
  • An active mission card has an empty or zero target or reward amount. Check the flagged card, enter valid numbers, and save again.
• Do existing players receive retroactive rewards when targets are adjusted?
  • Players who have already claimed their reward in the active cycle keep their reward without deductions or bonus payouts. Players who have not yet claimed must meet the newly updated target to receive the newly configured reward.
• How do I hide a specific mission from players?
  • Select the member rank, toggle the mission's active switch to Inactive (Gray), and press Save missions. The card will immediately disappear from the player lobby.