Thư viện ảnh

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

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

Quyền asset được kiểm tra theo kind. Đọc/list `game` cần GAME_REGISTRY/READ; upload `game` cần GAME_REGISTRY/ADMIN. Các kind còn lại dùng resource tương ứng và READ cho list, WRITE cho upload.

Điều kiện hiển thị: Có phiên và game đang chọn; sidebar xuất hiện nếu có read probe catalog/reward item/profile catalog. API kiểm tra READ khi list theo resource từng kind; game list cần GAME_REGISTRY/READ và upload cần GAME_REGISTRY/ADMIN.

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

Tra cứu tài sản hình ảnh dùng bởi catalog, phần thưởng và hồ sơ.

Gợi ý trong Portal (frontend/src/app/(portal)/games/[gameId]/assets/page.tsx): Toàn bộ ảnh đã tải lên cho game này, chia theo loại (vật phẩm, tiền tệ, catalog, avatar, icon game). Tải nhiều ảnh cùng lúc, xem ảnh đang được dùng ở đâu, sao chép URL và xóa ảnh thừa. Ảnh tải lên ở tab nào thuộc loại đó; quyền xem và tải lên theo từng loại (ví dụ icon game cần quyền quản trị Game Registry). Ảnh trùng nội dung với ảnh đã có sẽ không tạo bản mới. Chỉ xóa được ảnh chưa dùng. Ảnh chưa dùng quá 7 ngày cũng được hệ thống tự dọn. Muốn đổi ảnh của một vật phẩm / tiền tệ… thì sửa ở form của mục đó (chọn ảnh từ thư viện hoặc tải ảnh mới). Ô tìm kiếm và bộ lọc áp dụng trên trang đang xem (50 ảnh/trang). 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. Chọn kind asset trước khi tải; kiểm tra đúng game và conversion/quality.
2. Tra cứu asset bằng quyền READ của resource theo kind; upload dùng WRITE, riêng asset game cần GAME_REGISTRY/ADMIN.

Lưu ý an toàn

Lọc theo loại và game; xác nhận asset được tham chiếu trước khi thay đổi hoặc xóa.

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

List asset bị từ chối → kiểm tra kind, game scope và READ grant của resource tương ứng; list game cần GAME_REGISTRY/READ. Upload bị từ chối → kiểm tra định dạng/kích thước cùng WRITE grant; upload game cần GAME_REGISTRY/ADMIN.

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.