Shop

Đường dẫn: Menu → Nội dung & cấu hình → Shop (/games/{gameId}/catalog)

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

Điều kiện hiển thị: Có game đang chọn và quyền CATALOG/READ; chỉnh sửa/publish cần WRITE/PUBLISH.

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

Quản lý danh mục sản phẩm hiển thị trong Shop.

Gợi ý trong Portal (frontend/src/app/(portal)/games/[gameId]/catalog/page.tsx): Nơi duy nhất tạo và sửa định nghĩa vật phẩm, gói mua và sản phẩm trong game. Publish để áp dụng cho người chơi. Sản phẩm mới luôn ở trạng thái draft — phải bấm Publish mới có hiệu lực với game client. Sửa 1 sản phẩm đã publish sẽ tạo phiên bản draft mới, cần publish lại để áp dụng. ‘Ngừng bán’ chuyển sản phẩm đã publish sang disabled — không xóa, có thể khôi phục lại bằng Rollback. Rollback áp dụng lại đúng giá trị của 1 lần thay đổi trước đó, lấy từ audit log. 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ạo/cập nhật catalog item rồi kiểm tra giá, item kind và asset.
Preview import nếu dùng JSON; publish hoặc rollback theo lịch sử sau khi xác nhận sản phẩm đúng game.

Lưu ý an toàn

Xác nhận loại sản phẩm, giá và trạng thái. Thay đổi cấu hình có thể ảnh hưởng ngay đến người chơi.

Lỗi thường gặp

“Không thể rollback” → không có lịch sử thay đổi cho sản phẩm; “Không thể xem trước import”/“Thao tác catalog thất bại” → sửa lỗi trong detail API.

Liên quan

Mở bán sản phẩm Shop · 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