Vật phẩm thưởng

Đường dẫn: Menu → Nội dung & cấu hình → Vật phẩm thưởng (/games/{gameId}/reward-items)

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; cấu hình cần REWARD_ITEM/WRITE.

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

Khai báo vật phẩm có thể dùng trong quà và phần thưởng.

Gợi ý trong Portal (frontend/src/app/(portal)/games/[gameId]/reward-items/page.tsx): Chọn các món đã Publish trong Shop để dùng ở Tặng quà, Điểm danh, Campaign và các luồng phần thưởng. Định nghĩa tên, icon, loại và trần ở Shop. Món pending chưa thể bật làm phần thưởng. Gỡ món đang được campaign, điểm danh hoặc quà chờ phát dùng sẽ bị chặn và hiển thị nơi đang dùng. 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ải danh sách item từ Shop và chọn món hợp lệ.
2. Thêm/gỡ món trong Reward Items; kiểm tra enabled state và nội dung phản hồi.

Lưu ý an toàn

Kiểm tra item key và hiệu lực trước khi lưu; không phát vật phẩm trực tiếp nếu chưa xác minh người nhận.

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ể tải món từ Shop” hoặc “Không thể cập nhật Vật phẩm thưởng” → xác minh catalog/reward item còn tồn tại, game scope và 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.