Game Registry

Đường dẫn: Menu → Quản trị hệ thống → Game Registry (/admin/games)

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
game_registry	READ	Super Admin, Game Owner, Analyst, Auditor
game_registry	ADMIN	Super Admin

Danh sách yêu cầu GAME_REGISTRY/READ; tạo/sửa/chuyển trạng thái là GAME_REGISTRY/ADMIN toàn cục và thao tác tạo game chỉ Super Admin.

Điều kiện hiển thị: Route toàn cục /admin/games, không gắn game scope. Đọc cần GAME_REGISTRY/READ; create/update cần GAME_REGISTRY/ADMIN toàn cục.

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

Đăng ký và quản lý các game trong Portal.

Gợi ý trong Portal (frontend/src/app/(portal)/admin/games/page.tsx): Quản lý toàn bộ game của studio — tạo game mới, sửa thông tin cơ bản và đổi trạng thái. Đây là nơi duy nhất tạo ra 1 game_id mới cho toàn hệ thống. Bấm ‘Sửa’ trên 1 dòng để đổi tên hiển thị, tiền tệ mặc định, múi giờ hoặc trạng thái. Bấm ‘API Key’ để cấp/thu hồi key cho game client — bắt buộc trước khi game có thể gọi API liên kết người chơi. Bấm biểu tượng khiên để nhập OAuth web client của Play Games: Portal dùng nó đổi server auth code của app lấy token và xác minh người chơi khi link (bắt buộc khi chạy xác minh thật). Lọc theo trạng thái để nhanh chóng tìm game đã archived hoặc inactive. Đổi trạng thái sang ‘archived’ không xóa dữ liệu — chỉ ẩn khỏi các danh sách mặc định. Đây là route hệ thống không gắn gameId; quyền được kiểm tra trên tài khoản/phiên toàn cục.

Các thao tác thường gặp

1. Tìm game theo id/tên/trạng thái và kiểm tra cấu hình hiện hành.
2. Tạo game chỉ Super Admin; trước lưu xác nhận game id duy nhất, tiền tệ và timezone.

MFA: cấu hình Play Games và chuyển economy mode yêu cầu step-up; tạo game cần Super Admin và GAME_REGISTRY/ADMIN toàn cục.

Lưu ý an toàn

Xác minh game id và cấu hình môi trường trước khi tạo; quyền game_registry được giới hạn theo vai trò.

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

“invalid game status” → chỉ dùng active/inactive/archived. Create/update bị forbidden → xác minh GAME_REGISTRY/ADMIN toàn cục; quyền read không cho tạo game.

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.