Tiền tệ & tiến trình

Đường dẫn: Menu → Nội dung & cấu hình → Tiền tệ & tiến trình (/games/{gameId}/currencies)

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

Điều kiện hiển thị: Có game đang chọn và quyền REWARD_ITEM/READ; lưu cấu hình cần REWARD_ITEM/WRITE.

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

Tra cứu cấu hình tiền tệ và tiến trình được Portal quản lý.

Gợi ý trong Portal (frontend/src/app/(portal)/games/[gameId]/currencies/page.tsx): Khai báo các loại tiền tệ và chỉ số tiến trình mà game này dùng. Portal dựa vào đây để kiểm tra đồng bộ từ app (/sync), trần phần thưởng và hiển thị trang người chơi. Mọi thay đổi cần MFA và lý do, được ghi vào audit log. Đổi trần có hiệu lực ngay với các lần sync và phần thưởng tiếp theo. 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. Đọc cấu hình kinh tế hiện tại của game và xác nhận currency/progress key.
2. Lưu cấu hình với reason khi yêu cầu; không thao tác số dư cá nhân, số dư suy ra từ ledger.

Lưu ý an toàn

Kiểm tra đơn vị, khóa cấu hình và tác động dự kiến; không sửa số dư trực tiếp vì wallet được tính từ ledger.

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 thể lưu” → kiểm tra validation từ API và quyền REWARD_ITEM/WRITE; đối chiếu currency/progress key trước khi gửi lại.

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.