Alert Channels

Đường dẫn: Menu → Quản trị hệ thống → Alert Channels (/admin/alert-channels)

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
admin_users	ADMIN	Super Admin

API alert channel toàn hệ thống và yêu cầu ADMIN_USERS/ADMIN; không gắn game scope cho CRUD/test.

Điều kiện hiển thị: Route toàn cục /admin/alert-channels, không gắn game scope; API chỉ cho ADMIN_USERS/ADMIN.

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

Quản lý đích nhận cảnh báo vận hành.

Gợi ý trong Portal (frontend/src/app/(portal)/admin/alert-channels/page.tsx): Cấu hình kênh nhận cảnh báo (Telegram/Slack/email) khi hệ thống phát hiện sự cố — vd ingestion lỗi, dữ liệu trễ. Áp dụng cho toàn hệ thống hoặc theo từng game. Không chọn game cụ thể (mặc định) nghĩa là kênh nhận cảnh báo của mọi game. Xóa 1 kênh không ảnh hưởng cảnh báo đã gửi trước đó, chỉ dừng gửi tiếp. Bấm nút Gửi thử để kiểm tra kênh nhận được tin; lỗi sẽ hiện kèm cách sửa. Đâ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

Tạo kênh với đúng target và phạm vi toàn cục/game theo API.
Gửi tin thử; chỉ xóa khi đã xác minh phụ thuộc cảnh báo và có người nhận thay thế.

Lưu ý an toàn

Kiểm tra người nhận và kênh trước khi lưu; không đưa token hoặc secret vào tài liệu hay log.

Lỗi thường gặp

“Gửi tin thử thất bại”/“Tạo kênh cảnh báo thất bại”/“Xóa kênh cảnh báo thất bại” → dùng delivery hint/detail từ API, xác minh target và kênh 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.

Áp dụng cho Portal v1.2.2