Dashboard
Đường dẫn: Menu → Tổng quan → Dashboard (/games/{gameId}/dashboard)
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 |
|---|---|---|
| dashboard_kpi | READ | Super Admin, Game Owner, Live Ops, Economy Admin, Support Agent, Finance, Analyst, Auditor |
Điều kiện hiển thị: Có game đang chọn và quyền DASHBOARD_KPI/READ để probe dashboard thành cô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ì”Bảng tổng hợp chỉ số và hoạt động của game.
Gợi ý trong Portal (frontend/src/app/(portal)/games/[gameId]/dashboard/page.tsx): Tổng quan chỉ số vận hành của game: DAU, người chơi mới, doanh thu IAP/quảng cáo theo ngày. Dữ liệu được tổng hợp theo lô (batch), không phải realtime. Đổi khoảng ngày ‘Từ’/‘Đến’ để xem lại lịch sử. Nhãn trạng thái dữ liệu (fresh/delayed/failed) cho biết độ mới của lần tổng hợp gần nhất — không phải lỗi hiển thị. Doanh thu quảng cáo hiện ‘chưa có nguồn dữ liệu’ nếu game chưa cấu hình AdMob — khác với bằng 0. 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 đúng game ở bộ chọn; đọc khoảng thời gian và nguồn dữ liệu đang hiển thị.
- Mở từng thẻ/bảng chỉ số để xem chi tiết; đối chiếu thời điểm cập nhật trước khi báo số liệu.
Lưu ý an toàn
Phần tiêu đề “Lưu ý an toàn”Kiểm tra game đang chọn trước khi đọc chỉ số. Dữ liệu tổng hợp có thể trễ theo trạng thái ingestion.
Lỗi thường gặp
Phần tiêu đề “Lỗi thường gặp”“Không thể tải dashboard.” thường do request, API hoặc dịch vụ lỗi: xác minh game đang chọn, API/ingestion và thử tải lại sau khi dịch vụ ổn định. “Bạn không có quyền xem dashboard của game này.” là 403: nhờ admin xác nhận game scope và grant DASHBOARD_KPI/READ.
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