Economy Anomalies

Đường dẫn: Menu → Người chơi & giao dịch → Economy Anomalies (/games/{gameId}/economy-anomalies)

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
economy_ledger	READ	Super Admin, Game Owner, Live Ops, Economy Admin, Support Agent, Finance, Analyst, Auditor
economy_ledger	WRITE	Super Admin, Game Owner, Live Ops

Điều kiện hiển thị: Có game đang chọn và quyền ECONOMY_LEDGER/READ; chấp nhận giá trị cần WRITE.

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

Rà soát bất thường trong ledger kinh tế.

Gợi ý trong Portal (frontend/src/app/(portal)/games/[gameId]/economy-anomalies/page.tsx): Danh sách các lần POST /sync từ Game Client bị từ chối vì vượt ngưỡng chống gian lận (Task E.2) — số dư báo cáo tăng vọt bất thường trong 1 lần đồng bộ, hoặc cộng dồn nhiều lần sync trong 5 phút vượt ngưỡng cho phép. ‘Vượt ngưỡng 1 lần sync’ = 1 request báo tăng quá nhiều vàng trong 1 lần (ví dụ hack bộ nhớ). ‘Vượt ngưỡng cộng dồn 5 phút’ = nhiều request nhỏ hợp lệ riêng lẻ nhưng dồn lại bất thường trong cửa sổ 5 phút. Số dư chính thức trên server KHÔNG bị ảnh hưởng bởi các lần bị từ chối này. 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

Lọc anomaly và mở ledger/progress liên quan để xác minh nguồn.
Chỉ chấp nhận progress khi đã đối chiếu; thao tác ghi audit và không sửa số dư wallet trực tiếp.

Lưu ý an toàn

Mở chi tiết ledger và xác minh nguồn phát sinh trước khi chuyển xử lý; số dư lấy từ ledger append-only.

Lỗi thường gặp

“Không thể chấp nhận giá trị” → kiểm tra anomaly còn hiện hành và quyền ECONOMY_LEDGER/WRITE; xem thông điệp chi tiết từ API.

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.

Áp dụng cho Portal v1.2.2