Chuyển tới nội dung chính

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​

  1. Truy cập: http://your-domain.com/login
  2. Nhập username và password
  3. 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ẩm
  • products.add - Thêm sản phẩm
  • products.edit - Sửa sản phẩm
  • products.delete - Xóa sản phẩm

Modules chính​

ModuleMô tả
dashboardTrang chủ
usersQuản lý người dùng
user-groupsNhóm người dùng
customersKhách hàng
productsSản phẩm
product-categoriesDanh mục SP
sale-packagesGói bán
restaurantsNhà hàng
restaurant-menusMenu NH
agenciesĐại lý
bookingsĐặt chỗ
paymentsThanh toán
reportsBá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ệ​

Báo lỗi​

Khi gặp lỗi, vui lòng cung cấp:

  1. 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)

  2. 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

  3. Liên hệ: