Economy Admin

Lộ trình: Economy Admin

Quản lý vật phẩm, phần thưởng và thao tác economy có reason, MFA hoặc phê duyệt khi được yêu cầu.

Sau lộ trình này bạn có thể

• Phân biệt item bán với item thưởng không bán và tạo cấu hình trong game scope.
• Thực hiện grant/revoke có reason, lượng nhỏ và kiểm tra ledger sau đó.
• Nhận biết mutation cần MFA, approval và idempotency.

Quyền theo backend

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

Bảng dưới đây lấy quyền endpoint từ dữ liệu permissions.json do T.3 sinh trực tiếp từ backend. Grant không tự đảm bảo menu hoặc feature flag đang bật.

Bảng permission mô tả grant endpoint; menu, điều kiện module, scope game và MFA còn được kiểm tra riêng.

Thứ tự học

1. Vật phẩm thưởng — 15 phút
2. Tiền tệ & tiến trình — 15 phút
3. Tặng quà — 15 phút
4. Economy Anomalies — 15 phút
5. Phát quà đền bù — 20 phút

Bài thực hành

Bài 1: Tạo vật phẩm không bán

Mục tiêu: Tạo định nghĩa phần thưởng chỉ dùng trong game test.

Dữ liệu chuẩn bị: game test_t5_economy_game; item test_t5_economy_reward

Vai trò cần: Economy Admin

Các bước (chỉ dev/staging):

1. Mở Vật phẩm thưởng và tạo item không bán với định danh test.
2. Kiểm tra loại, số lượng và mô tả trước khi lưu.
3. Xác minh item xuất hiện trong danh sách game test.

Kết quả mong đợi: Item được tạo ở đúng game, không trở thành sản phẩm Shop bán cho người chơi.

Bài 2: Tặng quà test có lý do

Mục tiêu: Thực hành grant cho player test và đọc ledger.

Dữ liệu chuẩn bị: player test_t5_economy_player; item test; game test_t5_economy_game

Vai trò cần: Economy Admin/Super Admin; reviewer riêng nếu workflow áp dụng

Các bước (chỉ dev/staging):

1. Mở Tặng quà, xác minh player và game test.
2. Nhập item, lượng nhỏ và reason cụ thể; hoàn tất MFA/approval nếu Portal yêu cầu.
3. Đọc kết quả grant, ledger và audit để đối chiếu.

Kết quả mong đợi: Grant thành công đúng một lần; ledger/audit ghi đúng player, item, reason.

Bài 3: Đọc anomaly sandbox

Mục tiêu: Phân loại cảnh báo mà không sửa ledger trực tiếp.

Dữ liệu chuẩn bị: game test_t5_economy_game; dữ liệu anomaly sandbox

Vai trò cần: Economy Admin đọc; thao tác sửa cần quyền cụ thể

Các bước (chỉ dev/staging):

1. Mở Economy Anomalies và chọn hàng test.
2. So sánh sự kiện nguồn với ledger và khoảng thời gian.
3. Ghi kết luận/đề nghị xử lý theo quy trình; không sửa số dư trực tiếp.

Kết quả mong đợi: Anomaly được giải thích bằng nguồn dữ liệu và ledger append-only.

Chú ý

Chỉ dùng tài khoản, game và dữ liệu sandbox được cấp. Không chạy thao tác lên hệ thống live; không đưa token, mật khẩu, PII hoặc purchase token vào ghi chú. Mọi ví dụ game/player bên trên là tên marker test_, cần được tạo riêng theo quy trình môi trường.

Tự đánh giá

• Tôi biết cách xác nhận đúng game/scope trước thao tác.
• Tôi phân biệt quyền đọc, ghi, publish và mutation.
• Tôi biết khi nào cần reason, MFA step-up hoặc duyệt độc lập.
• Tôi chỉ dùng dữ liệu test và biết cách dừng/chuyển escalations.

Sai lầm thường gặp

• Sửa số dư trực tiếp thay vì tạo bút toán qua API được cấp.
• Gửi grant lặp khi request chậm hoặc chưa kiểm tra trạng thái đầu tiên.
• Chọn sai player/item hoặc bỏ trống reason.
• Coi quyền đọc ledger là quyền mutation.