Players

Đường dẫn: Menu → Người chơi & giao dịch → Players (/games/{gameId}/players)

Ai dùng được

Đây là quyền endpoint theo backend/src/admin_portal/core/permissions.py; các thao tác nhạy cảm như PII có kiểm tra step-up riêng. Super Admin vượt ma trận bằng quyền khẩn cấp.

Tài nguyên endpoint	Hành động cần	Vai trò được backend cho phép
player_profile	READ	Super Admin, Game Owner, Live Ops, Economy Admin, Support Agent, Finance, Analyst, Auditor
economy_ledger	READ	Super Admin, Game Owner, Live Ops, Economy Admin, Support Agent, Finance, Analyst, Auditor

Điều kiện hiển thị: Có game đang chọn và quyền PLAYER_PROFILE/READ; các tab ledger cần ECONOMY_LEDGER/READ.

Màn hình này dùng để làm gì

Tra cứu hồ sơ người chơi trong game đang chọn.

Gợi ý trong Portal (frontend/src/app/(portal)/games/[gameId]/players/page.tsx): Tìm kiếm theo nickname public, public_id, tên hiển thị, player UID hoặc ID liên kết nền tảng (Play Games/Game Center). Lọc theo trạng thái (active/disabled) để thu hẹp danh sách. Bấm ‘Xem hồ sơ’ để vào chi tiết ví, giao dịch và entitlement của người chơi đó. Dữ liệu nghiệp vụ được giới hạn theo gameId đang chọn.

Các thao tác thường gặp

1. Tìm bằng player UID trong game đang chọn; xác nhận đúng kết quả trước khi mở hồ sơ.
2. Dùng tab giao dịch/ledger cần thiết để đối chiếu hỗ trợ; không mở hoặc xuất PII nếu chưa có quyền và step-up.

Lưu ý an toàn

Tìm bằng ID người chơi; chỉ dùng thông tin cần thiết cho yêu cầu hỗ trợ. PII cần quyền và step-up riêng.

Chú ý

Trước khi xác nhận thay đổi có thể ảnh hưởng người chơi, kiểm tra đúng game, đối tượng, giá trị và lý do. Không dùng dữ liệu người chơi thật trong ví dụ hoặc ảnh chụp.

Lỗi thường gặp

Không tìm thấy player → kiểm tra player UID và game scope. Lỗi hồ sơ/ledger → xác minh endpoint PLAYER_PROFILE/READ hoặc ECONOMY_LEDGER/READ; không thử truy cập PII vượt quyền.

Liên quan

Quy trình thường gặp · Audit Log · Vai trò và quyền

Kiểm tra lần cuối với Portal v1.2.2. Hướng dẫn được đối chiếu mã nguồn; chưa chạy thao tác trên dev stack.