Tài liệu hướng dẫn sử dụng Hệ thống ThinkBox
Tổng quan
ThinkBox là hệ thống quản lý bán vé và đặt chỗ toàn diện, hỗ trợ quản lý nhà hàng, khu vui chơi, điểm tham quan.
Tính năng chính
✅ Quản lý Sản phẩm & Dịch vụ
- Quản lý danh mục sản phẩm phân cấp
- Hỗ trợ nhiều loại sản phẩm (PRODUCT, GOODS, MATERIALS, SERVICE)
- Tùy chọn sản phẩm linh hoạt (size, topping, độ cay...)
- Upload ảnh qua Cloudflare Images
✅ Quản lý Nhà hàng
- Quản lý nhiều nhà hàng
- Phân chia khu vực trong nhà hàng
- Tạo menu theo nhà hàng và khu vực
- Gán sản phẩm vào menu với giá riêng
- Copy menu nhanh chóng
✅ Quản lý Người dùng
- Hệ thống phân quyền chi tiết
- Nhóm người dùng với quyền kế thừa
- Quản lý tài khoản và mật khẩu
✅ Quản lý Khách hàng
- Quản lý thông tin khách hàng cá nhân
- Quản lý công ty và mã số thuế
- Tự động cập nhật thông tin khi đặt vé
✅ Quản lý Gói bán
- Tạo gói bán với nhiều sản phẩm/dịch vụ
- Thiết lập giá theo cấp đại lý
- Quản lý thời hạn sử dụng linh hoạt
- In vé QR hoặc mã code
✅ Đặt chỗ & Xuất vé
- Đặt chỗ cho khách lẻ
- Đặt chỗ cho đại lý
- Xuất vé tự động
- In vé với QR code
- Quản lý thanh toán
✅ Hệ thống Thanh toán
- Nhiều hình thức thanh toán
- Thanh toán một phần/toàn bộ
- Quản lý công nợ
- QR code thanh toán
✅ Báo cáo & Thống kê
- Báo cáo doanh thu
- Báo cáo vé đã sử dụng
- Báo cáo danh sách chờ
- Báo cáo check-in/check-out
✅ Hệ thống Action Log
- Ghi log tất cả thao tác
- Theo dõi lịch sử thay đổi
- Audit trail đầy đủ
Bắt đầu nhanh
Bước 1: Đăng nhập hệ thống
- Truy cập:
http://your-domain.com/login - Nhập username và password
- Click Đăng nhập
Bước 2: Cấu hình cơ bản
2.1. Tạo Đơn vị tính
Menu: Cấu hình > Đơn vị tính
→ Thêm đơn vị: Cái, Ly, Tô, Kg...
2.2. Tạo Danh mục sản phẩm
Menu: Cấu hình > Danh mục sản phẩm
→ Tạo danh mục cha: Đồ uống, Món ăn...
→ Tạo danh mục con: Cà phê, Trà, Phở, Bún...
2.3. Tạo Sản phẩm
Menu: Sản phẩm > Danh sách sản phẩm
→ Thêm sản phẩm với đầy đủ thông tin
→ Upload ảnh (nếu có)
Xem chi tiết: product-service-configuration.md
Bước 3: Cấu hình Nhà hàng (nếu có)
3.1. Tạo Nhà hàng
Menu: Cấu hình > Nhà hàng
→ Thêm nhà hàng
3.2. Tạo Khu vực
Menu: Cấu hình > Khu vực nhà hàng
→ Tạo khu vực cho từng nhà hàng
3.3. Tạo Menu
Menu: Nhà hàng > Menu nhà hàng
→ Tạo menu cho khu vực
→ Gán sản phẩm vào menu
Xem chi tiết: restaurant-menu-management.md
Bước 4: Tạo Gói bán
Menu: Sản phẩm > Gói bán
→ Tạo gói bán mới
→ Chọn sản phẩm/dịch vụ
→ Thiết lập giá theo cấp đại lý
→ Cấu hình thời hạn sử dụng
Xem chi tiết: sale-package-management.md
Bước 5: Đặt chỗ & Xuất vé
Menu: Đặt chỗ > Đặt chỗ mới
→ Chọn khách hàng (hoặc tạo mới)
→ Chọn gói bán và số lượng
→ Thanh toán
→ Xuất vé (tự động nếu đã thanh toán đủ)
Xem chi tiết: booking-reservation.md
Luồng nghiệp vụ chính
1. Luồng Đặt chỗ Khách lẻ
1. Khách hàng đến quầy
↓
2. Nhân viên tạo đặt chỗ mới
├── Nhập thông tin khách hàng (hoặc chọn có sẵn)
├── Chọn gói bán
└── Nhập số lượng
↓
3. Thanh toán
├── Chọn hình thức thanh toán
├── Nhập số tiền
└── Tính toán còn nợ
↓
4. Xuất vé (nếu đã thanh toán đủ)
├── Tạo vé với QR code
├── In vé
└── Gửi cho khách hàng
↓
5. Hoàn tất
2. Luồng Đặt chỗ Đại lý
1. Đại lý đặt chỗ (qua API hoặc Web)
↓
2. Chọn gói bán
├── Áp dụng giá theo cấp đại lý
├── Chọn số lượng
└── Chọn ngày sử dụng
↓
3. Thanh toán
├── Thanh toán trực tiếp
└── Hoặc ghi công nợ
↓
4. Xuất vé
├── Tạo vé với QR/mã code
├── Gửi vé cho đại lý (email/API)
└── Đại lý chuyển cho khách
↓
5. Hoàn tất
3. Luồng Check-in/Check-out
1. Khách hàng đến điểm check-in
↓
2. Nhân viên quét QR code/nhập mã vé
↓
3. Hệ thống kiểm tra
├── Vé còn hiệu lực?
├── Vé đã sử dụng chưa?
└── Vé hợp lệ trong ngày?
↓
4. Check-in thành công
├── Cập nhật trạng thái vé
├── Ghi log sử dụng
└── Cho phép vào cửa
↓
5. Khách sử dụng dịch vụ
↓
6. Check-out (nếu có)
├── Quét vé lần 2
├── Cập nhật thời gian ra
└── Hoàn tất
4. Luồng Bán Combo Nhà hàng
1. Khách order tại bàn
↓
2. Nhân viên chọn menu
├── Chọn nhà hàng
├── Chọn khu vực
└── Chọn menu
↓
3. Chọn món ăn
├── Thêm món từ menu
├── Chọn tùy chọn (size, topping...)
└── Nhập số lượng
↓
4. Tạo hóa đơn
├── Tính tổng tiền
├── Áp dụng thuế & phí dịch vụ
└── Tạo bill
↓
5. Thanh toán
├── Chọn hình thức thanh toán
├── In hóa đơn
└── Hoàn tất
Phân quyền
Cấu trúc phân quyền
Module.Permission
Ví dụ:
products.view- Xem sản phẩmproducts.add- Thêm sản phẩmproducts.edit- Sửa sản phẩmproducts.delete- Xóa sản phẩm
Modules chính
| Module | Mô tả |
|---|---|
dashboard | Trang chủ |
users | Quản lý người dùng |
user-groups | Nhóm người dùng |
customers | Khách hàng |
products | Sản phẩm |
product-categories | Danh mục SP |
sale-packages | Gói bán |
restaurants | Nhà hàng |
restaurant-menus | Menu NH |
agencies | Đại lý |
bookings | Đặt chỗ |
payments | Thanh toán |
reports | Báo cáo |
Xem chi tiết: user-management.md
Troubleshooting
Lỗi thường gặp
1. Không đăng nhập được
Nguyên nhân:
- Sai username/password
- Tài khoản bị vô hiệu hóa
- Session hết hạn
Giải pháp:
1. Kiểm tra username/password
2. Liên hệ admin kiểm tra trạng thái tài khoản
3. Xóa cache trình duyệt và thử lại
2. Upload ảnh thất bại
Nguyên nhân:
- Chưa cấu hình Cloudflare
- File quá lớn
- Format không hỗ trợ
Giải pháp:
1. Kiểm tra cấu hình Cloudflare trong .env
2. Nén ảnh xuống dưới 5MB
3. Chuyển sang format JPEG/PNG
3. Không in được vé
Nguyên nhân:
- Chưa thanh toán đủ
- Mẫu in không tồn tại
- Lỗi kết nối máy in
Giải pháp:
1. Kiểm tra trạng thái thanh toán
2. Kiểm tra mã mẫu in trong system_configs
3. Kiểm tra kết nối máy in
4. QR code không quét được
Nguyên nhân:
- QR bị mờ/nhòe
- Vé hết hạn
- Vé đã sử dụng
Giải pháp:
1. In lại vé với chất lượng cao hơn
2. Kiểm tra hạn sử dụng vé
3. Kiểm tra lịch sử sử dụng vé
Hỗ trợ
Thông tin liên hệ
- Email: contact@thinksoft.com.vn
- Hotline: 0899 023 368
- Website: https://thinksoft.com.vn
Báo lỗi
Khi gặp lỗi, vui lòng cung cấp:
-
Thông tin lỗi:
- Màn hình đang thao tác
- Hành động gây lỗi
- Thông báo lỗi (screenshot)
-
Thông tin hệ thống:
- Trình duyệt (Chrome, Firefox...)
- Phiên bản hệ thống
- Thời gian xảy ra lỗi
-
Liên hệ:
- Gửi email: contact@thinksoft.com.vn
- Hoặc tạo ticket tại: https://support.thinksoft.com.vn