Cài Đặt — Cấu hình hệ thống
Xem và cập nhật cấu hình hệ thống nền tảng Reso — các tham số hoạt động, cờ tính năng, và các cài đặt toàn nền tảng.
Settings — Cấu hình hệ thống
Settings là nơi admin xem và cập nhật cấu hình toàn bộ platform Reso. Tại đây bạn quản lý các tham số vận hành, feature flags, và cài đặt ảnh hưởng đến toàn bộ user.
Trang Settings kéo dữ liệu từ endpoint GET settings — cấu hình hiện tại của hệ thống.
Bạn có thể làm gì trong Settings?
| Hành động | Mô tả |
|---|---|
| Xem cấu hình hiện tại | Tất cả tham số hệ thống đang active |
| Cập nhật cấu hình | Thay đổi tham số vận hành |
| Bật/tắt feature flags | Kích hoạt hoặc vô hiệu hóa tính năng |
| Quản lý revenue split | Tỉ lệ chia doanh thu DJ/platform |
| Cấu hình settlement | Chu kỳ settlement, withdrawal limits |
Settings ảnh hưởng toàn platform. Mọi thay đổi có tác dụng ngay và ảnh hưởng tất cả user. Chỉ admin cấp cao mới nên sửa Settings. Mọi thay đổi ghi audit log.
Xem cấu hình hiện tại
Khi vào /admin/settings, bạn thấy danh sách cấu hình hệ thống, nhóm theo category:
- Revenue split: tỉ lệ chia doanh thu (mặc định 70/30 — DJ 70%, platform 30%)
- Settlement cycle: chu kỳ settlement (mặc định T+14)
- Min withdrawal: số tiền rút tối thiểu
- Withdrawal fee: phí rút tiền (nếu có)
- Max stream duration: thời lượng stream tối đa
- Max concurrent streams: số session live đồng thời
- Bitrate limit: bitrate tối đa cho stream
- Auto-end on idle: tự end session nếu không có viewer
- Auto-approve threshold: điều kiện auto-approve (nếu có)
- KYC expiry: thời hạn KYC hợp lệ
- Required documents: loại giấy tờ bắt buộc
- Auto-flag keywords: keyword tự động flag chat
- Report threshold: số report để auto-suspend
- Ban appeal window: thời gian chờ appeal ban
- Song requests: bật/tắt tính năng song requests
- Booking: bật/tắt booking DJ
- Gift: bật/tắt gift system
- Agency portal: bật/tắt agency dashboard
Cập nhật cấu hình
Mở Settings
Vào /admin/settings, tìm category cần sửa.
Đọc giá trị hiện tại
Đảm bảo hiểu giá trị hiện tại và ý nghĩa trước khi sửa. Hover over field để xem tooltip (nếu có).
Sửa giá trị
Click vào field, nhập giá trị mới. Một số field là toggle (on/off), một số là số hoặc text.
Click "Save"
Nút "Save" sẽ lưu thay đổi. Hệ thống validate input — nếu giá trị không hợp lệ, sẽ báo lỗi.
Xác Nhận thay đổi
Một số thay đổi quan trọng (revenue split, settlement cycle) cần confirm dialog. Đọc kỹ trước khi confirm.
Cẩn thận với revenue split và settlement cycle. Thay đổi hai tham số này ảnh hưởng trực tiếp tiền của DJ. Thông báo cho DJ trước khi thay đổi, và chỉ áp dụng từ kỳ settlement mới — không thay đổi giữa kỳ.
Cờ Tính Năng
Feature flags cho phép bật/tắt tính năng mà không cần deploy code. Hữu ích để:
- Rollout dần tính năng mới (test với nhóm nhỏ trước)
- Tắt khẩn cấp tính năng có bug mà không cần revert code
- A/B test hai phiên bản tính năng
Mở tab Feature flags
Tìm tính năng cần bật/tắt.
Toggle on/off
Click toggle để bật hoặc tắt. Thay đổi có hiệu lực ngay.
Kiểm tra impact
Sau khi toggle, kiểm tra Dashboard/Analytics để đảm bảo không có anomaly. Nếu tính năng tắt gây lỗi, bật lại ngay.
Mẹo: Khi tắt feature flag khẩn cấp, thông báo team qua kênh nội bộ để mọi người biết. Đừng tắt âm thầm — user có thể report issue mà team không biết do flag đã tắt.
Tham số quan trọng cần biết
| Tham số | Mặc định | Lưu ý khi sửa |
|---|---|---|
| Revenue split | 70/30 | Ảnh hưởng tiền DJ — thông báo trước |
| Settlement cycle | T+14 | Ảnh hưởng kỳ payout — chỉ đổi đầu kỳ |
| Min withdrawal | 100,000 VND | Quá thấp → nhiều transaction nhỏ, quá cao → DJ khó rút |
| Max stream duration | 8 giờ | Quá dài → DJ quên end, quá ngắn → hạn chế DJ pro |
| Report threshold | 3 reports | Quá thấp → dễ abuse, quá cao → vi phạm không được xử lý |
Workflow quản lý Settings
Đọc cấu hình hiện tại
Đầu ca, lướt Settings để biết cấu hình hiện tại. Đặc biệt feature flags — đảm bảo không có flag bị tắt nhầm.
Thay đổi cẩn thận
Mỗi thay đổi đều có lý do rõ ràng. Không sửa "thử" — Settings là production config.
Thông báo trước khi thay đổi lớn
Revenue split, settlement cycle, feature flag chính → thông báo team và DJ trước khi áp dụng.
Kiểm tra sau khi thay đổi
Sau khi save, kiểm tra Dashboard/Analytics để đảm bảo không có anomaly.
Audit log
Mọi thay đổi Settings đều ghi audit log. Xem Audit Log để truy vết.
Câu Hỏi Thường Gặp
Ai có quyền sửa Settings? Mặc định admin đều xem được. Sửa chỉ admin cấp cao (super admin). Phân quyền chi tiết xem trong cấu hình role.
Thay đổi Settings có cần restart backend không? Không. Hầu hết thay đổi có hiệu lực ngay (hot reload). Một số tham số (DB connection, Agora config) có thể cần restart — hệ thống sẽ báo.
Tôi có thể rollback thay đổi Settings không? Có. Vào Settings, sửa lại giá trị cũ. Audit log ghi lại giá trị trước/sau để bạn tham khảo.
Sẵn sàng xem audit log? Xem Audit Log.