Profile cosmetics

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

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
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

Điều kiện hiển thị: Có game đang chọn và quyền PROFILE_CATALOG/READ; gán cosmetic lên hồ sơ còn cần PLAYER_PROFILE/WRITE.

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

Quản lý cosmetic trang trí hồ sơ.

Gợi ý trong Portal (frontend/src/components/profile/profile-cosmetic-manager.tsx): Catalog badge/huân chương và khung avatar của từng game. Ownership và expiration do server quản lý. 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ạo/cập nhật cosmetic và liên kết asset đã có.
2. Lưu cấu hình rồi kiểm tra catalog; thao tác gán lên hồ sơ người chơi cần quyền player profile riêng.

Lưu ý an toàn

Xác minh asset, điều kiện mở khóa và trạng thái trước khi lưu.

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

Cosmetic không khả dụng → xác minh asset, cấu hình catalog và quyền PROFILE_CATALOG; thao tác gán cho người chơi cần PLAYER_PROFILE/WRITE.

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.