Business features

---

1. Player operations

Route: /users, /users/:id — permission userManagement

Action	Description
List & filter	Search, filter meta from API
Player detail	Profile, wallet, reserved balance
Ban / Unban	Lock/unlock account
Terminate	Permanent deletion (with preview first)
Update status	Change account status

---

2. Payment transactions

Route: /transactions, /transactions/:id — permission transactionManagement

flowchart LR
  A[Payment transaction] --> B{Status}
  B -->|Failed sync| C[Retry sync game wallet]
  B -->|Refund needed| D[Refund single / all]
  B -->|Review| E[Update status + detail view]

• Aggregate statistics (getTransactionStats)
• Full payment transaction detail
• Retry sync game wallet on error
• Single or bulk refund

---

3. Withdrawals

Withdrawal Requests (/withdrawal-requests)

Action	API
Approve	POST /payment/admin/withdrawals/:id/approve
Reject	POST .../reject
Complete	POST .../complete
Retry payout	POST .../retry-payout
View payout log	GET .../payout-log

Flagged Withdrawals (/flagged-withdrawals)

• Profit analysis for unusual withdrawals
• Adjust user balance when needed

---

4. Multi-tier wallets

Game Wallets (/wallets)

• Sync balance per wallet
• Aggregate statistics
• Recall all — recall all game wallets (batch job + CSV export)

USD Wallets (/usd-wallets)

• System-wide summary
• Ledger with filter/export
• Approve/reject USD withdrawal requests
• Linked credit transactions

Credit Wallets (/credit-wallets)

• Summary + CDN credits ledger
• CSV export

---

5. System account management

Admins (/admins)

• CRUD admin accounts
• Granular permissions: grant / revoke / set
• Reset password

Super Agents (/super-agents)

• Create, suspend, terminate
• Cash funding / withdrawal
• Game mappings, wallet transactions
• Assign agents

Agents (/agents)

• Create CDN agent, rates, popup permissions
• Payment & wallet transactions
• Wallet transfer
• Create child shop

Shops (/shops)

• Cross-agent shop detail
• Rates, credit adjust, suspend/terminate

Cashiers (/cashiers)

• CRUD, report, shifts
• Fraud indicators

---

6. Platform configuration

Module	Route	Capabilities
Domains	/domains	CRUD domain, game mappings, analytics, kiosk health
Game Providers	/game-providers	CRUD, reorder, agent balances sync
VFX Config	/vfx-config	Background presets, schedules
Transaction Limits	/transaction-limits	Config limits, fraud flags
Provider Fees	/provider-fees	Payment gateway fee configuration
API Logs	/integration-logs	Game/payment/webhook logs (super admin)

---

7. Support & notifications

Support Tickets (/tickets)

• Search, filter, reply
• Update status, mark done
• Support stats dashboard

Notifications (super admin)

Type	Route	Purpose
Broadcasts	/broadcasts	System-wide notifications, credential SMS batch
In-app popups	/in-app-popups	Popup targeting player/agent/shop

AdminNotificationBell — polls inbox broadcasts every 2 minutes.

---

8. Manual Game Deposits

Route: /manual-game-deposits

Manual deposit flow into game account:

1. Admin views pending list
2. Confirm or reject
3. Update game account if needed

---

9. Finance Corrections

FinanceCorrectionDebitModal — adjust financial ledger via POST /admin/finance-corrections.

See also: Admin Financial Correction Debit Spec.

---

10. Admin vs CDN Portals comparison

Feature	Admin	Super Agent / Agent / Shop
Permission-based access	✅ 14 permissions	Auth only
Player ban/terminate	✅	Shop: ban only
Payment refund	✅	—
Game wallet recall	✅	—
Create super agent/agent	✅	Super Agent: agent only
Provider fees edit	✅	Read-only
Integration logs	✅	—
Support tickets	✅	—
Global broadcasts	✅	Delegate only

---

Implementation notes

1. Dev port 3000 — CRA default.
2. React Query — logout must call queryClient.clear() to avoid cache leak.
3. Build — postbuild-spa-fallback.js creates 404.html for deep links.
4. E2E — Playwright tests in test:e2e, test:visual.
5. Reference host: dev-admin.kioskservice.club.