Phân quyền & Vai trò

Quy định hệ thống vai trò (roles) Discord và các quyền tối thiểu để bot hoạt động ổn định

Để hệ thống Booking Bot vận hành chính xác và không gặp lỗi phân quyền, bạn cần cấu hình các vai trò (roles) trên Discord và phân cấp vị trí của Bot hợp lý.

Quyền tối thiểu của Bot trên Discord

Đảm bảo Booking Bot được cấp các quyền sau trong Discord:

Quyền hạn	Mục đích
`Manage Roles`	Quản lý, gán và gỡ role cho player, part-time và quarantine
`Manage Channels`	Tạo, xóa và sửa đổi các kênh hỗ trợ, kênh log
`Send Messages`	Gửi tin nhắn thông tin, kết quả, log và hóa đơn
`Embed Links`	Hiển thị các bảng thống kê và hóa đơn dưới dạng Embed
`Create Private Threads`	Tạo kênh hỗ trợ riêng tư cho hệ thống Ticket
`Read Message History`	Tra cứu lịch sử tin nhắn phục vụ autoresponder và ticket
`Manage Permissions`	Cấu hình quyền truy cập kênh cho từng đối tượng

Vị trí của vai trò của Bot (Bot Role) trong danh sách Roles của Server Discord bắt buộc phải nằm cao hơn các vai trò của staff (Player, Supporter, Admin, Cash). Nếu không, bot sẽ không thể quản lý và điều chỉnh các vai trò này (gặp lỗi DiscordAPIError: Missing Permissions).

Cấu trúc vai trò (Role Hierarchy)

Hệ thống Booking Bot phân bổ quyền hạn và danh sách câu lệnh dựa trên cấu trúc phân cấp vai trò dưới đây:

Phân cấp	Vai trò	Quyền hạn Discord gợi ý	Quyền hạn trong Bot
1	Owner	Administrator	Toàn quyền setup và cấu hình hệ thống
2	Administrator	Manage Server, Kick, Mute	Quản lý tài chính, chỉnh sửa lương, star và moderation
3	Supporter	Manage Messages, Kick	Tạo hóa đơn booking, donate, điều hành ticket
4	Cash Manager	Không yêu cầu quyền đặc biệt	Chỉ nạp/trừ tiền cash cho khách hàng
5	Player	Không yêu cầu quyền đặc biệt	Xem lương, star và profile cá nhân
6	`everyone` (Khách)	Quyền cơ bản	Xem profile, sử dụng shop, gửi tiền

Chi tiết quyền hạn từng vai trò

Owner (Chủ sở hữu)

Mô tả: Người chịu trách nhiệm kỹ thuật và sở hữu server.
Quyền hạn: Thực hiện thiết lập kênh log (/settings log-all…), cấu hình giá và lương (/settings server), tạo panel ticket (/ticket create). Embed Builder tối thiểu là Supporter (Owner dùng được vì kế thừa).

Administrator (Quản trị viên)

Mô tả: Ban quản trị trực tiếp điều hành hoạt động của server.
Quyền hạn: Can thiệp lương (addluong/subluong), giờ star (addstar/substar), giờ cọc khách (addtime/subtime), prefix/color/emoji, moderation (ban/mute). Không gồm nạp/trừ cash trừ khi kiêm role Cash.

Supporter (Nhân viên hỗ trợ)

Mô tả: Nhân viên trực tiếp giao dịch và hỗ trợ khách hàng trong các ticket.
Quyền hạn: Tạo hóa đơn booking (/book), hóa đơn donate (/donate), hoàn bill (/hoanbill), giveaway (ga start), React Bill (/react profile hoặc react), đóng ticket (close), autoresponder (ar add).

Cash Manager (Quản lý tài chính)

Mô tả: Nhân viên ngân quỹ xử lý các giao dịch nạp tiền.
Quyền hạn: Chỉ được cấp quyền cộng tiền và trừ tiền cash của khách hàng thông qua lệnh addcash (ac) và subcash (sc).

Player (Người chơi / Staff)

Mô tả: Thành viên cung cấp dịch vụ booking trong server.
Quyền hạn: Xem tổng số giờ làm việc (star), tự tra cứu bảng lương (luong/tinhluong), và xem profile hôn nhân (marry profile).

On this page