🌟 CÁC PHÂN HỆ VÀ CHỨC NĂNG NỔI BẬT
1. Phân hệ Quản trị viên (Admin Portal)
-
Dashboard KPI trực quan: Theo dõi doanh số, số lượng booking, biểu đồ tăng trưởng doanh thu 12 tháng, trạng thái các lịch khởi hành.
-
Quản lý Tour nâng cao: Tạo tour mới, nhân bản tour nhanh, tự động sinh mã QR Code động cho từng tour.
-
Điều hành Lịch Khởi Hành:
-
Phân bổ Hướng dẫn viên (HDV) thông minh (tự động kiểm tra trùng lịch, cảnh báo xung đột lịch làm việc, đề xuất HDV phù hợp).
-
Phân bổ Dịch vụ của đối tác cung cấp (Khách sạn, nhà hàng, vé máy bay, phương tiện di chuyển...).
-
Quản lý danh sách khách hàng tham gia, điểm danh/check-in hành khách bằng QR Code.
-
Phân chia phòng khách sạn tự động/thủ công cho khách trong đoàn.
-
Quản lý Tài chính - Kế toán:
-
Lập dự toán chi phí tour chi tiết.
-
Phê duyệt/từ chối các khoản chi phí thực tế phát sinh do HDV gửi về.
-
Báo cáo so sánh dự toán vs thực tế, tính toán lãi/lỗ chi tiết của từng đoàn khởi hành.
-
Quản lý công nợ khách hàng, công nợ nhà cung cấp dịch vụ.
-
Quản lý Nhân sự & Tính Lương: Thiết lập lương cơ bản, hoa hồng/thưởng linh hoạt theo từng tour dẫn đầu cho HDV. Duyệt và thanh toán lương trực quan.
2. Phân hệ Hướng dẫn viên (Tour Guide Portal)
-
Giao diện mobile-friendly: HDV dễ dàng theo dõi lịch trình tour được phân công trên điện thoại.
-
Nhật ký hành trình điện tử: Ghi nhận thời tiết, hành trình hàng ngày và gửi báo cáo sự cố (kèm hình ảnh chứng từ thực tế) trực tiếp về cho Admin phê duyệt chi phí.
-
Điểm danh & Check-in: Quét QR Code để check-in khách tại các điểm tập trung/điểm tham quan.
-
Tiếp nhận Yêu cầu Đặc biệt: Theo dõi và cập nhật trạng thái xử lý các yêu cầu đặc biệt của khách (như dị ứng thức ăn, hỗ trợ y tế...).
3. Phân hệ Khách hàng (Customer Portal)
-
Xem danh sách tour, lịch trình chi tiết, đặt tour online cho gia đình/đoàn đông người.
-
Thanh toán trực tuyến tích hợp Cổng thanh toán VNPay (tự động kích hoạt qua IPN) hoặc chuyển khoản qua QR Code ngân hàng.
-
Quản lý lịch sử đặt tour, hóa đơn thanh toán, gửi yêu cầu thay đổi booking.
-
Đánh giá chất lượng tour, chất lượng HDV (chuyên môn, thái độ) và nhà cung cấp dịch vụ sau khi kết thúc hành trình.
4. Hệ thống Tự động hóa ngầm (Python Automation Engine)
Hệ thống sử dụng Python chạy background scheduler để thực thi:
-
Realtime Websocket Notification: Gửi thông báo thời gian thực đến Admin, HDV và Khách hàng khi có sự thay đổi trạng thái booking, thanh toán, đánh giá mới.
-
Async Email Queue: Gửi email hóa đơn PDF tự động cho khách hàng bằng hàng đợi chạy ngầm (tránh làm chậm trang web).
-
Auto-Backup Database: Tự động nén gzip và sao lưu database hàng ngày lúc 2:00 AM, tự động dọn dẹp các bản sao lưu cũ quá 14 ngày.
-
Admin Automation Jobs: Tự động kiểm tra SLA yêu cầu hỗ trợ, kiểm định tính sẵn sàng khởi hành của tour, phát hiện webhook thanh toán bất thường, nhắc nhở công nợ tự động.
5. Cổng thanh toán & Webhook tự động hóa
-
Tích hợp cổng thanh toán trực tuyến VNPay hỗ trợ cả môi trường Sandbox và Production.
-
Hỗ trợ tự động xác nhận thanh toán khi tiền về tài khoản ngân hàng thông qua Webhook (Casso/SePay).
XEM THÊM ==> Hướng dẫn cài đặt chi tiết
Nguồn: Sharecode.vn
BƯỚC 1: Cấu hình Web Server (Laragon/XAMPP)
-
Giải nén mã nguồn vào thư mục www của Laragon hoặc htdocs của XAMPP.
-
Khởi động Apache và MySQL từ bảng điều khiển Laragon/XAMPP.
BƯỚC 2: Import Cơ Sở Dữ Liệu
-
Truy cập http://localhost/phpmyadmin hoặc sử dụng HeidiSQL.
-
Tạo một database mới tên là: .
-
Import file cơ sở dữ liệu mẫu nằm ở thư mục gốc vào database vừa tạo.
sql.sql
BƯỚC 3: Cấu hình File Môi Trường (.env)
-
Đổi tên file .env.example ở thư mục gốc thành .env (nếu chưa có).
-
Mở file .env bằng Text Editor và cấu hình kết nối database của bạn:
env
BASE_URL=http://localhost/quanlydulich/
DB_HOST=localhost
DB_PORT=3306
DB_USERNAME=root
DB_PASSWORD= # Nhập mật khẩu MySQL của bạn
DB_NAME=quan_ly_tour_du_lich
-
Chạy lệnh Migration để đồng bộ database mới nhất: Mở terminal tại thư mục dự án và chạy:
bash
phpscripts/migrate.phpstatus
phpscripts/migrate.phpup
BƯỚC 4: Cài Đặt và Khởi Chạy Python Services (Websocket & Jobs ngầm)
-
Đảm bảo máy tính đã cài đặt Python 3.9 trở lên.
-
Mở terminal tại thư mục dự án và khởi tạo môi trường ảo Python:
powershell
# Tạo môi trường ảo
python-m venv venv
# Kích hoạt môi trường ảo
venv\\Scripts\\activate
# Cài đặt thư viện cần thiết
pip install-r requirements.txt
-
Khởi chạy WebSocket Server để bật thông báo thời gian thực:
powershell
python scripts/websocket_server.py
-
Khởi chạy Scheduler để tự động gửi mail, backup db và chạy jobs ngầm:
powershell
python scripts/scheduler.py
BƯỚC 5: Đăng Nhập Hệ Thống
Truy cập: http://localhost/quanlydulich/index.php?act=auth/login
-
Tài khoản Admin: admin / Mật khẩu: 123123123
-
Tài khoản Hướng dẫn viên (HDV): hdv01 / Mật khẩu: password
-
Tài khoản Khách hàng: khach01 / Mật khẩu: password
-
Tài khoản Nhà cung cấp dịch vụ: ncc01 / Mật khẩu: 1