Setup Wizard

Hướng dẫn sử dụng trình cài đặt tự động 1-click thông qua lệnh /setup.

Lệnh /setup là tính năng đột phá của Booking Bot V2, cho phép Server Owner thiết lập toàn bộ hạ tầng vận hành bot (Vai trò, Danh mục kênh, Kênh ghi log, Phân quyền) chỉ trong vài cú click chuột thông qua giao diện nút bấm và form tương tác hiện đại.

Điều Kiện Thực Hiện Lệnh

Người thực hiện: Bắt buộc phải là Server Owner hoặc thành viên có quyền Administrator trên máy chủ Discord và đã được cấp quyền Owner của bot.
Vị trí thực hiện: Khuyến nghị thực hiện trong kênh ẩn (chỉ dành cho ban quản trị).

Cú pháp thực hiện:

/setup

Các Giai Đoạn Trong Wizard

Khi kích hoạt lệnh /setup, bot sẽ phản hồi một giao diện tương tác với các tùy chọn:

1. Khởi Tạo Vai Trò Hệ Thống (System Roles)

Bot sẽ quét danh sách vai trò hiện có trên máy chủ Discord của bạn:

Nếu chưa có vai trò tương ứng: Bot cung cấp nút bấm cho phép tự động tạo các vai trò tiêu chuẩn với màu sắc và tên định danh tối ưu:
- Booking Admin: Quản lý vận hành toàn diện.
- Booking Cashier: Quản lý ví tiền, nạp/rút cọc và thanh toán.
- Booking Supporter: Nhân viên điều phối, hỗ trợ và theo dõi đơn book.
- Booking Player: Thành viên nhận book phục vụ khách hàng.
Nếu máy chủ đã có sẵn vai trò: Bạn có thể chọn giữ nguyên và sử dụng menu chọn vai trò (Role Select Menu) để map trực tiếp vai trò hiện có sang quyền của bot.

2. Thiết Lập Danh Mục & Kênh Log Tự Động

Wizard sẽ tự động tạo một Category mang tên Booking Logs với quyền riêng tư (chỉ cho phép Staff và Bot xem), đồng thời khởi tạo đầy đủ các kênh log nhánh:

Tên kênh tự động	Chức năng ghi nhận
`log-bill`	Toàn bộ thông tin tạo bill, kết thúc phiên book, tính lương và hoa hồng
`log-cash`	Lịch sử nạp tiền, trừ tiền, nạp cọc và rút cọc của thành viên
`log-booking`	Trạng thái đặt lịch, nhận đơn, hủy đơn của player
`log-ticket`	Lịch sử mở, đóng và nội dung trao đổi trong phòng vé hỗ trợ
`log-feedback`	Đánh giá sao và lời nhận xét của khách hàng sau khi hoàn tất dịch vụ
`log-moderation`	Nhật ký xử lý vi phạm, cảnh cáo hoặc hạn chế quyền thành viên

3. Hướng Dẫn Kích Hoạt Các Bước Tiếp Theo

Sau khi hoàn tất khởi tạo hạ tầng, wizard sẽ hiển thị bản tóm tắt các thiết lập và cung cấp các nút tắt (Action Buttons) dẫn đến:

Nút Cấu hình biểu phí: Mở form chỉnh sửa giá book và lương.
Nút Gửi Panel khách: Hướng dẫn gửi bảng tương tác đặt lịch vào kênh công khai.

Tùy Biến Sau Khi Chạy Setup

Toàn bộ các vai trò và kênh log do wizard tạo ra đều có thể thay đổi linh hoạt bất kỳ lúc nào sau này:

Muốn đổi hoặc thêm vai trò phụ trách: Sử dụng lệnh /setuprole.
Muốn chuyển kênh log sang vị trí khác: Sử dụng lệnh /logger.
Muốn chỉnh sửa giá hoặc lương: Sử dụng lệnh /config.

Sau khi wizard tạo xong các vai trò mới, vui lòng vào Server Settings > Roles trên Discord để kiểm tra thứ tự hiển thị của các vai trò này trong danh sách thành viên máy chủ của bạn.