Tặng quà

Đường dẫn: Menu → Người chơi & giao dịch → Tặng quà (/games/{gameId}/reward-gifts)

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

Gửi quà cần GRANT_REVOKE_ITEM/MUTATE; preview/danh sách ledger cần ECONOMY_LEDGER/READ. Khi bật approval_workflow, Support Agent có thể gửi yêu cầu chờ duyệt; Game Owner hoặc Super Admin duyệt.

Điều kiện hiển thị: Có game đang chọn; sidebar probe cần ECONOMY_LEDGER/READ; gửi grant cần GRANT_REVOKE_ITEM/MUTATE. Approval workflow có thể biến gửi batch thành yêu cầu chờ duyệt.

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

Tạo và theo dõi lô quà gửi 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

Tải danh sách đối tượng và yêu cầu preview; sửa lỗi UID/phần thưởng trước khi xác nhận.
Đọc kết quả preview; gửi batch kèm lý do. Nếu approval_workflow yêu cầu, batch chờ Game Owner duyệt trước khi phát.

MFA / duyệt: tạo quà gọi GRANT_REVOKE_ITEM/MUTATE và có step-up. Khi approval_workflow bật, yêu cầu phải được Game Owner hoặc Super Admin khác duyệt.

Lưu ý an toàn

Xác nhận game, nhóm người nhận, vật phẩm và lý do trước khi gửi. Ghi rõ reason khi thao tác thay đổi dữ liệu.

Lỗi thường gặp

“Preview đã thay đổi” → dữ liệu preview không còn khớp; tải preview lại rồi mới gửi. “Không thể gửi batch” → xem detail từ API, kiểm tra quyền MUTATE, reason và điều kiện approval.

Liên quan

Phát quà đền bù · 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