Remote Config

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

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
remote_config	READ	Super Admin, Game Owner, Live Ops, Economy Admin, Analyst, Auditor
remote_config	WRITE	Super Admin, Game Owner, Live Ops
remote_config	PUBLISH	Super Admin, Game Owner, Live Ops

Điều kiện hiển thị: Có game đang chọn và quyền REMOTE_CONFIG/READ; sửa/publish cần WRITE/PUBLISH.

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

Xem và phát hành cấu hình từ xa cho game.

Gợi ý trong Portal (frontend/src/app/(portal)/games/[gameId]/remote-config/page.tsx): Cấu hình từ xa cho game (feature toggle, tham số cân bằng…) theo từng config_key, có versioning và publish/rollback. Mỗi lần ‘Thêm remote config’ sinh ra 1 version mới — không sửa đè version cũ. Chỉ 1 version được publish tại 1 thời điểm cho mỗi config_key. Bấm ‘Lịch sử’ trên 1 dòng để so sánh payload giữa các version. App chỉ đọc được key bắt đầu bằng ‘client.’ (qua /client/bootstrap, bỏ tiền tố). Key khác chỉ dùng nội bộ, không bao giờ lộ ra app. Key ‘portal.client_policy’ điều khiển bắt buộc cập nhật và bảo trì: {“android”: {“min_version”: “1.2.0”, “recommended_version”: “1.3.0”}, “ios”: {…}, “maintenance”: {“active”: true, “message”: {“vi”: ”…”}}}. App nhận thay đổi trong vòng 30 giây. 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 version mới hoặc sửa payload theo config key; so sánh diff trước khi tiếp tục.
2. Publish version đã duyệt; kiểm tra lịch sử/rollback và đảm bảo chỉ lộ key client được phép.

Lưu ý an toàn

So sánh giá trị hiện tại và giá trị mới, kiểm tra môi trường/phạm vi rồi publish; thao tác nhạy cảm có thể yêu cầu MFA step-up.

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

“Thao tác remote config thất bại” → đọc lỗi API, xác minh version hiện tại, quyền publish và diff trước khi retry.

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.