Nhật ký Cập nhật (Changelog)

Trang này ghi nhận toàn bộ các mốc phát hành, tính năng mới và các bản vá tối ưu hóa trong vòng đời phát triển của Booking Bot V2.

---

Phiên Bản 2.0.0 — Bản Phát Hành Chính Thức (Next-Gen Release)

Ngày phát hành: 14/08/2026

Phiên bản 2.0.0 đánh dấu bước chuyển đổi toàn diện nhất của Booking Bot tại Motional Hub với kiến trúc quản lý hóa đơn độc lập, hệ thống phòng voice tự động, tích hợp cổng thanh toán VietQR và hàng loạt công cụ tương tác khách hàng thông minh.

1. Thay Đổi Hệ Thống Lệnh Cài Đặt

• Tách lệnh cài đặt chuyên biệt: Tách các thiết lập lớn thành lệnh độc lập: /setuprole (quản trị vai trò), /config (cấu hình máy chủ & biểu phí), /logger setup (thiết lập kênh nhật ký).
• Setup Wizard 1-Click (/setup): Hỗ trợ khởi tạo tự động toàn bộ vai trò mẫu và danh mục kênh ghi nhận nhật ký chỉ với 1 thao tác.

2. Nghiệp Vụ Booking, Donate & Hóa Đơn Độc Lập

• Hóa đơn độc lập: Mỗi phiên book là một hóa đơn mang mã số bill-id duy nhất, loại bỏ cơ chế tích lũy giờ chơi gộp chung cũ.
• Tùy biến linh hoạt trên lệnh /book:
  • Tùy chỉnh giá trực tiếp trên từng hóa đơn (giá).
  • Phân loại hình thức phục vụ Cam hoặc Game (loại-bill) và phụ phí máy chủ (fee).
  • Hỗ trợ tính năng bill_đêm (thay thế cho book_đêm cũ).
  • Tùy chọn ẩn_danh: Hiển thị tên khách hàng thành Ai đó trên thông báo công khai (sổ cái bot vẫn lưu đúng tài khoản để trừ tiền/hoàn trả).
  • Bổ sung phương thức thanh toán BankQR bên cạnh Cash (Trừ cọc), Salary (Trừ lương) và Bank.
  • Cho phép cập nhật đơn khi BankQR đang chờ (thêm player, đổi giá, ghi chú).
• Hoàn tiền 1-Click theo ID: Lệnh /refundbill (alias: /hoanbill) và /refunddonate (alias: /hoandonate) hoàn tiền chính xác theo mã bill-id, hỗ trợ hoàn riêng từng player và tự động ẩn danh khi hoàn.
• Nút bấm thao tác trên Bill: Có sẵn nút Tạo lại phòng voice và nút Hoàn bill trực tiếp trên Embed hóa đơn.

3. Panel Khách Tự Phục Vụ (Self-Service)

• Bảng điều khiển cố định: Khách hàng tự tương tác qua 4 nút bấm: React (tìm player), Book (đặt lịch), Donate (ủng hộ) và Nạp cọc (quét QR ngân hàng).
• Cấu hình trực quan qua /config selfservice toggle: Mở Form Modal chọn nhanh các nút cần bật/tắt (mặc định tắt khi mới cài).
• Gắn nhãn phòng vé: Lệnh /config selfservice tickets cho phép gắn tối đa 20 nhãn ticket lên bảng điều khiển; có nút Ẩn toàn bộ ticket để dọn nhanh.
• Khung giờ thông minh: Tự động tính giá ngày hoặc đêm theo giờ Việt Nam tại thời điểm khách bấm xác nhận.
• Tích hợp tiện ích hỗ trợ: Panel gắn sẵn câu nhắc gọi Autoresponder sup khi cần hỗ trợ; nút Xem panel trong phòng ticket cho phép mở bảng điều khiển thu nhỏ ngay tại phòng vé.

4. Quản Lý Phòng Voice Theo Bill & Cảnh Báo Trễ

• Khởi tạo phòng voice tự động: Nút tạo phòng trên bill tự động mở kênh đàm thoại riêng tư, phân quyền đúng khách và player trong đơn.
• Giám sát thời gian tham gia (kênh Ping Bill):
  • Cảnh báo tự động khi khách đã vào phòng mà player chưa vào: Gửi cảnh báo ngay khi phát hiện, nhắc lại sau 3 phút, và sau 5 phút sẽ ping supporter hỗ trợ.
• Cơ chế tự hủy an toàn: Tự động xóa phòng voice sau 5 phút nếu không có người (không làm đóng hay hủy bill).

5. Cổng Thanh Toán VietQR & Quản Lý QR Lương Player

• Thanh toán VietQR tự động: Tích hợp với 3 cổng thanh toán Pay2S, SePay, ApiPay. Hóa đơn được đối soát tự động qua webhook trong 2 giây.
• Quản lý QR nhận lương của Player:
  • Lệnh /setupbankqr: Thiết lập kênh chuyên dụng để player gửi ảnh QR ngân hàng lưu vào hệ thống.
  • Lệnh /bankqr: Dành cho ban quản trị lọc danh sách QR theo mức lương tối thiểu và khởi tạo phiên thanh toán lương.
• Gọi QR nhanh: Supporter có thể gọi mã QR thanh toán nhanh trong kênh chat bằng trigger qr <số tiền>.
• Cơ chế BankQR Pending: Quản lý an toàn các giao dịch chuyển khoản chưa khớp tự động, hỗ trợ duyệt thủ công.

6. Cải Tiến Bảng Tổng Lương (totalsalary)

• Sắp xếp theo tổng giờ: Bảng tổng kết lương b.totalsalary sắp xếp khoa học theo tổng số giờ làm việc (ngày + đêm + Cam + Game), thay vì chỉ ưu tiên giờ ngày như trước.
• Tách bạch giờ đêm: Giờ đêm được hiển thị ở cột riêng biệt giúp đối soát minh bạch và chính xác 100%.

7. Đồng Bộ Quyền Ticket Theo Vai Trò Server

• Tự động quét quyền: Hệ thống phòng vé tự động đồng bộ quyền xem theo role Discord hiện tại của nhân viên. Khi supporter bị gỡ role, bot tự động thu hồi quyền xem trong toàn bộ ticket đang mở.
• Nguyên tắc an toàn: Thao tác tag/ping một thành viên bên trong ticket không tự động cấp quyền xem.

8. Hệ Thống Nhật Ký Vận Hành (Logger)

• Thiết lập nhanh /logger setup: Tạo danh mục và 9 kênh log chuyên biệt (hóa đơn, nạp rút, ticket, feedback, chào mừng...).
• Kênh Ping Bill: Kênh thông báo cảnh báo trễ phòng voice và điều phối supporter.

9. Cửa Hàng & Hộp Quà May Mắn (Lucky Box)

• Thay thế lệnh box cũ: Chuyển đổi sang hệ thống Lucky Box mới.
• Quản trị bằng Slash (/luckybox): Xem cấu hình, đổi giá, phát/thu hộp và thiết lập tỷ lệ rơi theo ngưỡng phần trăm (ngưỡng 1-100%).
• Người chơi mở hộp bằng lệnh Prefix: Mở hộp bằng lệnh unbox (hỗ trợ alias: ub, mohop, moqua).

10. Autoresponder Thông Minh

• Chỉnh sửa trigger nâng cao (ar edit <tên>): Hỗ trợ cú pháp chỉnh sửa một dòng nhanh chóng (giao diện tương tác Live Preview kèm Modal form đang được tiếp tục hoàn thiện).
• Các lệnh điều hành nâng cao:
  • ar line <tên> | true/false: Bật chế độ gửi nội dung theo từng dòng (mỗi dòng 1 tin nhắn).
  • ar set-all <prefix>: Tự động gán user theo username/displayName khớp tiền tố và số.
  • ar matchmode <tên> | exact|includes|startsWith|endsWith: Tùy biến phương thức khớp từ khóa trigger (thay thế lệnh cũ ar include).
  • ar showall <tên> / ar removeall <tên>: Quản lý album ảnh đính kèm của trigger.
• Thẻ Profile Canvas V2 (Đang hoàn thiện): Dự kiến tích hợp vẽ danh thiếp đồ họa cá nhân kèm các nút tương tác trực tiếp dưới ảnh thẻ trong các bản cập nhật tiếp theo.

11. Ngừng Hỗ Trợ Tính Năng Anti-Raid

• Tách bot an ninh chuyên biệt: Tính năng Anti-Raid chính thức ngừng phát triển trên Booking Bot V2 và được tách sang bot bảo mật độc lập để Booking Bot V2 tập trung chuyên sâu cho vận hành thương mại và dịch vụ booking.