BusBooking là một hệ thống đặt vé xe khách trực tuyến đơn giản, lấy cảm hứng từ VeXeRe. Dự án hỗ trợ các vai trò Người dùng, Đối tác (Nhà xe) và Quản trị viên, bao gồm tìm kiếm chuyến, đặt vé, quản lý ghế, thanh toán (VNPay, dự kiến MoMo), gửi email, báo cáo và quản lý vận hành.
- Người dùng: đăng ký/đăng nhập, tìm kiếm chuyến, xem sơ đồ ghế, đặt vé, thanh toán, quản lý hồ sơ, đánh giá, hủy vé.
- Đối tác (nhà xe): quản lý đội xe, tài xế, tuyến/chuyến, trạng thái chuyến, vé theo chuyến, thông báo.
- Quản trị viên: quản lý người dùng, đối tác, tuyến/chuyến, khuyến mãi, báo cáo, hoàn tiền, khóa/mở tài khoản.
- Thanh toán: tích hợp VNPay (sandbox) qua
core/VNPayService.php, webhook MoMo (placeholder) tạiapi/payments/webhook_momo.php. - Email: gửi xác nhận đặt vé, đặt lại mật khẩu qua
core/EmailService.php(ưu tiên PHPMailer, fallbackmail()). - Bảo mật: phiên (
config/session.php), CSRF (core/csrf.php), middleware/auth (core/middleware.php,core/auth.php).
- PHP 8.x (khuyến nghị) + Apache (XAMPP trên Windows)
- MySQL/MariaDB (tên DB mặc định:
bus_booking) - Composer (tùy chọn, để cài PHPMailer)
- Trình duyệt hiện đại (Chrome/Edge)
index.php
api/ # REST-like PHP endpoints theo chức năng
assets/ # CSS/JS/Images cho giao diện người dùng
config/ # Cấu hình ứng dụng, DB, email, thanh toán
core/ # Dịch vụ & tiện ích (Auth, CSRF, Email, VNPay)
admin/, partner/, user/ # Giao diện theo vai trò
database/ # File SQL khởi tạo DB
docs/ # SQL/ghi chú mẫu, fix, sample data
includes/ # Layouts/header/footer/navbar/sidebar
uploads/ # Upload người dùng (avatar, v.v.)
Một số file/đường dẫn tiêu biểu:
- Trang chủ: index.php
- Cấu hình DB: config/db.php
- Hằng số ứng dụng: config/constants.php
- Email (SMTP): config/email.php, dịch vụ: core/EmailService.php
- VNPay (sandbox): config/vnpay.php, dịch vụ: core/VNPayService.php
- Session: config/session.php
- Tìm kiếm chuyến (API): api/trips/search.php
- Đặt vé (API): api/bookings/create.php
- Thanh toán VNPay: api/payments/create_invoice.php, api/payments/confirm.php
- Sơ đồ ghế: api/user/seatmap.php, assets: assets/js/seatmap.js
- Cài và bật XAMPP (Apache + MySQL).
- Sao chép dự án vào
C:\xampp\htdocs\Bus_Booking(đã đúng nếu bạn đang ở thư mục này). - Tạo database MySQL tên
bus_booking. - Import schema:
- Mở phpMyAdmin → chọn DB
bus_booking→ Import file: database/bus_booking.sql - Tuỳ chọn: import thêm dữ liệu mẫu từ thư mục docs/ như:
- docs/SAMPLE_DATA.sql (dữ liệu mẫu)
- docs/TEST_DATA_USER.sql (người dùng thử nghiệm)
- Các file
FIX_*.sqldùng để điều chỉnh nhanh một số vấn đề.
- Mở phpMyAdmin → chọn DB
- Cấu hình kết nối database trong config/db.php:
define('DB_HOST', 'localhost');
define('DB_USER', 'root');
define('DB_PASS', '');
define('DB_NAME', 'bus_booking');- Cấu hình hằng số ứng dụng trong config/constants.php:
define('APP_DEBUG', true); // set false khi triển khai production
define('APP_NAME', 'BusBooking');
define('APP_VERSION', '1.0.0');
define('APP_URL', 'http://localhost/Bus_Booking');
// Đường dẫn lưu trữ (tạo nếu chưa có)
define('UPLOAD_PATH', BASE_PATH . '/storage/uploads');
define('QR_PATH', BASE_PATH . '/storage/qrcodes');
define('LOG_PATH', BASE_PATH . '/storage/logs');- Tạo thư mục lưu trữ nếu chưa tồn tại (Windows):
storage/
uploads/
qrcodes/
logs/
- Cấu hình Email SMTP trong config/email.php:
define('SMTP_HOST', 'smtp.gmail.com');
define('SMTP_PORT', 587); // TLS
define('SMTP_USERNAME', '<your-gmail>@gmail.com');
define('SMTP_PASSWORD', '<app-password>'); // Mật khẩu ứng dụng Gmail
define('SMTP_FROM_EMAIL', '<your-gmail>@gmail.com');
define('SMTP_FROM_NAME', 'BusBooking System');
define('SMTP_REPLY_TO', '<your-gmail>@gmail.com');
define('COMPANY_NAME', 'BusBooking');
define('COMPANY_WEBSITE', 'http://localhost/Bus_Booking');
define('SUPPORT_EMAIL', 'support@busbooking.com');
define('SUPPORT_PHONE', '1900-xxxx');Khuyến nghị cài PHPMailer (Composer) để gửi mail ổn định:
composer require phpmailer/phpmailer- Cấu hình VNPay (sandbox) trong config/vnpay.php:
define('VNPAY_TMN_CODE', '<sandbox_tmn_code>');
define('VNPAY_HASH_SECRET', '<sandbox_secret>');
define('VNPAY_URL', 'https://sandbox.vnpayment.vn/paymentv2/vpcpay.html');
define('VNPAY_RETURN_URL', APP_URL . '/user/payments/vnpay_return.php');- Khởi chạy: bật Apache + MySQL trong XAMPP, truy cập:
- Trang chủ: http://localhost/Bus_Booking
- Trang người dùng: user/dashboard.php
- Trang quản trị: admin/admin_dashboard.php
- Trang đối tác: partner/dashboard.php
- Tìm chuyến: từ index.php hoặc user/search → điền điểm đi/đến, ngày → xem kết quả.
- Chọn ghế: xem sơ đồ ghế, chọn ghế phù hợp.
- Đặt vé & thanh toán: thực hiện đặt vé, chọn phương thức (VNPay). Kết quả trả về tại
user/payments/vnpay_return.php. - Quản lý tài khoản: cập nhật hồ sơ, đổi mật khẩu, quản lý vé.
- Quản lý đội xe/tài xế: api/partner/fleet_crud.php, api/partner/drivers_crud.php
- Quản lý chuyến: api/partner/trips_crud.php, cập nhật trạng thái: api/partner/trip_status.php
- Vé theo chuyến: api/partner/tickets_by_trip.php
- Người dùng: api/admin/users_list.php, khóa/mở: api/admin/users_lock.php
- Đối tác: duyệt/treo: api/admin/partners_approve.php, api/admin/partners_suspend.php
- Tuyến/chuyến: api/admin/routes_crud.php, api/admin/trips_admin_crud.php
- Khuyến mãi: api/admin/promotions_crud.php
- Hoàn tiền: api/admin/refund_ticket.php
Các endpoint PHP theo nhóm trong thư mục api/:
- Xác thực: api/auth/login.php, api/auth/register.php, api/auth/forgot_password.php, api/auth/reset_password.php
- Chuyến/ghế: api/trips/search.php, api/seats/availability.php
- Đặt vé: api/user/book_ticket.php, api/bookings/create.php, hủy vé: api/user/cancel_ticket.php
- Thanh toán: tạo hóa đơn api/payments/create_invoice.php, xác nhận api/payments/confirm.php, webhook MoMo: api/payments/webhook_momo.php
- Hồ sơ người dùng: api/user/update_profile.php, avatar: api/user/upload_avatar.php
Lưu ý: đa số endpoint nhận/đáp JSON; kiểm tra tham số yêu cầu trước khi gọi.
- Cấu hình tại config/vnpay.php. Service tạo URL: core/VNPayService.php.
VNPAY_RETURN_URLmặc định trỏ tới user/payments/vnpay_return.php (xử lý kết quả).- Số tiền gửi tới VNPay cần nhân 100 (đã xử lý trong service).
- Mã phản hồi
00là thành công; bản đồ mã xem trongVNPAY_RESPONSE_CODES.
- Webhook placeholder: api/payments/webhook_momo.php (cần triển khai/hoàn thiện theo tài liệu MoMo).
- Dùng PHPMailer (nếu cài bằng Composer) hoặc fallback
mail(). - Mẫu email: xác nhận đặt vé, đặt lại mật khẩu; xem core/EmailService.php và cấu hình config/email.php.
- Khi dùng Gmail, hãy tạo “App Password” và bật bảo mật 2 lớp.
- Session: config/session.php – thiết lập timeout 30 phút.
- CSRF: core/csrf.php – xác thực token cho form/API.
APP_DEBUG: đặtfalsekhi triển khai thực tế; bật HTTPS; ẩn thông tin nhạy cảm.- Không commit mật khẩu thực vào VCS; thay bằng placeholder, refactor sang
.envnếu có thể.
- Khởi chạy local: bật Apache + MySQL (XAMPP) → duyệt http://localhost/Bus_Booking
- Frontend assets: xem assets/css và assets/js (không dùng bundler, có thể mở rộng sang Vite/Webpack nếu cần).
- Thêm API mới: tạo file PHP trong thư mục phù hợp dưới api/, tái dùng helpers trong core/.
- Lỗi kết nối DB: kiểm tra config/db.php và trạng thái MySQL/XAMPP; đảm bảo DB
bus_bookingtồn tại. - Email không gửi: cài PHPMailer (
composer require phpmailer/phpmailer), kiểm traSMTP_USERNAME/PASSWORD, “App Password” Gmail. - VNPay báo sai chữ ký: đảm bảo
VNPAY_HASH_SECRETđúng; không thay đổi tham số sau khi tạo URL. - Thiếu thư mục
storage/*: tạostorage/uploads,storage/qrcodes,storage/logsvà cấp quyền ghi. - Lỗi đường dẫn asset: xác nhận
APP_URLtrong config/constants.php khớp URL đang truy cập.
- Mở issue/PR cho tính năng mới hoặc bug.
- Hỗ trợ/trao đổi:
4fbusbooking.noreply@gmail.com