Operator guideENplayersactivitieshistorycomments

Players / Activity Log

Standalone player activity history page with filters for activity, device, date range, PID, country, tags, and comment-group context.

Reader view

Clean portal guidance

This page keeps the operator explanation, field and action descriptions, and screenshots visible without exposing repo paths, raw sidecars, or editorial-only implementation details.

Narrative content

Page body

What this page shows

Players / Activity Log is the standalone history view for player-related activities, comments, CRM actions, and tagged operational events.

When to use it

Use this page when you need to:

  • inspect comments or operational history across players
  • filter activity by date range, activity type, device, PID, or country
  • narrow the result set with include/exclude tags or comment groups
  • compare desktop vs mobile activity in the current result set
  • inspect activity rows on a map or open row-level JSON/detail blocks
  • export filtered activity rows

How to read it

This page is history-first. Operators typically set filters first, then read the resulting table or open row-level detail inside the activity component.

Above the table, the FE shows three summary cards built from the currently loaded result set:

  • Total Activities
  • Desktop
  • Mobile

Key columns exposed by the FE configuration include:

  • ID
  • Activity
  • Method
  • User
  • Comment Group
  • CRM User
  • CRM Role
  • Device
  • IP Address
  • Time

When the activity filter is set to COMMENT, the table changes shape:

  • the main text column becomes Comment Data
  • the table exposes Comment Group, CRM User, and CRM Role
  • expanded row detail swaps Description and Additional Data ordering to prioritise comment payloads

Verification status

  • status: verified_backend
  • last verified: 2026-04-18
  • note: FE filters, summary cards, export path, map flow, and backend activity route are traced through useGetUserActivities, useGetActivities, useGetCommentGroups, and ActivityController.getUserActivities.
Calculation notes

Calculations

calculation

Activity Stats Scope

The three summary cards are calculated from the currently loaded result set after filters are applied, not from a separate backend totals endpoint.

Verification State
verified_backend
calculation

Device Type Normalization

The FE normalizes `deviceType` and `userDeviceType` to lower-case and uses the normalized result to classify rows into `desktop`, `mobile`, or no device bucket.

Verification State
verified_backend
Grid columns

Columns

field

ID

Internal activity-log row id shown as `#<id>`.

Data Type
integer
field

Activity

Human-readable activity or event type.

Data Type
string
field

Method

Trigger or method associated with the activity row.

Data Type
string
field

Description

Main text body for the row. In `COMMENT` mode the table prioritises `dataJson` and labels the column `Comment Data`.

Data Type
mixed
field

User

Player email rendered as a link to the player workspace.

Data Type
string
field

Comment Group

Visible only in `COMMENT` mode. Shows the grouped comment bucket attached to the row.

Data Type
string
field

CRM User

Backoffice actor attached to the row when available.

Data Type
string
field

CRM Role

Role label of the CRM actor attached to the comment row.

Data Type
string
field

Device

Device-type badge shown as `desktop` or `mobile`.

Data Type
enum
field

IP Address

IP value for the row. When present, the table exposes an inline location button that opens the map dialog.

Data Type
ip
field

Time

Timestamp of the activity row plus relative-time helper text.

Data Type
datetime
field

Detailed Information

Expanded row block that shows description, additional data/JSON, and the recorded user-agent string.

Data Type
structured_block
Filter dictionary

Filters

field

Description

Free-text search across activity description content.

Type
text
field

Activity

Restricts the log to one activity code or activity family.

Type
select
field

Group

Comment-only filter that restricts the result set to one comment group id.

Type
select
field

Device

Filters rows by desktop or mobile device type.

Type
select
field

Start

Lower bound of the activity date range.

Type
date
field

End

Upper bound of the activity date range.

Type
date
field

Country

Filters activity rows by player country code.

Type
select
field

PID

Filters activity rows by affiliate PID. Backend resolution checks `nx.user_kpi_summary.affiliate_pid` first and then falls back to `public.users.additional_data->>'pid'`.

Type
text
field

User ID

Restricts the log to one player ID.

Type
text
field

Include Tags

Keeps only rows whose players have at least one of the selected tags.

Type
multi_select
field

Exclude Tags

Removes rows whose players have any of the selected tags.

Type
multi_select
Metric dictionary

Metrics

metric

Total Activities

Total number of rows in the currently loaded result set.

Data Type
integer
Verification State
verified_backend
metric

Desktop

Count of currently loaded rows resolved to `desktop` device type.

Data Type
integer
Verification State
verified_backend
metric

Mobile

Count of currently loaded rows resolved to `mobile` device type.

Data Type
integer
Verification State
verified_backend
Operational notes

Notes

item

CSV export uses the same route with `csvDownload=true`.

item

`pid` resolution first checks `nx.user_kpi_summary.affiliate_pid` and then falls back to `public.users.additional_data->>'pid'`.

item

`includeTags` and `excludeTags` are translated into SQL clauses against `public.users.tags`.

item

`commentGroupId` is matched from `UserActivities.data_json->>'groupId'`.

item

This page is distinct from the `Comments` and `Activity Log` tabs inside the player workspace because it supports broad, standalone filtering.

Related references

Related pages

pageDashboard / Player Statistics

Top-player table for winners, losers, and depositors, with rank, player identity, level, and amount shown in a compact comparison view.

pagePlayers / API Requests

Inspection page for player-related API event logs, with payload search, system and time filters, row-level JSON export, and a three-mode request/response viewer.

pagePlayers / Banking

Banking tab inside the player workspace with transaction filters, a paginated banking grid, analytics cards, CSV export, and automatic-withdrawal availability.

pagePlayers / Bonus Detail

Read-only detail page for one issued bonus, showing user, bonus, transaction, issuer, game, and lifecycle metadata.

pagePlayers / Bonuses

Cross-player issued-bonus inventory with server-side filters, preview popover, CSV export, and navigation into one issued-bonus detail page.

pagePlayers / Detail Workspace

Main player workbench at `/player/[playerId]` with tabbed sections, player-level actions, and modal-based operator workflows.