Bảng xếp hạng
Đường dẫn: Menu → Vận hành → Bảng xếp hạng (/games/{gameId}/leaderboards)
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 |
|---|---|---|
| leaderboard | READ | Super Admin, Game Owner, Live Ops, Economy Admin, Support Agent, Finance, Analyst, Auditor |
| leaderboard | WRITE | Super Admin, Game Owner, Live Ops |
Điều kiện hiển thị: Có game đang chọn, quyền LEADERBOARD/READ và probe/module bảng xếp hạng khả dụng; sidebar có thể ẩn khi module không sẵn sàng.
Màn hình này dùng để làm gì
Phần tiêu đề “Màn hình này dùng để làm gì”Quản lý bảng xếp hạng và phần thưởng liên quan.
Gợi ý trong Portal (frontend/src/components/leaderboards/leaderboard-list.tsx): Quản trị bảng điểm theo game, rà kết quả tuần và phát thưởng qua hộp thư người chơi. 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
Phần tiêu đề “Các thao tác thường gặp”- Chọn bảng/mùa giải cần quản lý; kiểm tra trạng thái và khoảng thời gian.
- Cập nhật cấu hình hoặc phần thưởng theo quyền; kiểm tra trạng thái module và không phát thưởng trước khi xác minh người nhận.
Lưu ý an toàn
Phần tiêu đề “Lưu ý an toàn”Kiểm tra mùa giải, điều kiện và phần thưởng trước khi phát; menu chỉ hiện khi quyền đọc và module cho phép.
Lỗi thường gặp
Phần tiêu đề “Lỗi thường gặp”Màn hình bị ẩn hoặc không tải → kiểm tra quyền LEADERBOARD/READ và probe/module của game; không kết luận bảng đã bật chỉ từ quyền truy cập.
Liên quan
Phần tiêu đề “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.
Áp dụng cho Portal v1.2.2