Skip to content

About

Online bus ticket booking system (inspired by VeXeRe): search trips, seat selection, VNPay payment, multi-role (User / Partner / Admin). Built with PHP & MySQL.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

BusBooking – Hệ thống đặt vé xe khách

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.

Tổng quan tính năng

  • 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ại api/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, fallback mail()).
  • Bảo mật: phiên (config/session.php), CSRF (core/csrf.php), middleware/auth (core/middleware.php, core/auth.php).

Công nghệ & yêu cầu hệ thống

  • 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)

Cấu trúc thư mục chính

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:

Cài đặt nhanh (Windows/XAMPP)

  1. Cài và bật XAMPP (Apache + MySQL).
  2. Sao chép dự án vào C:\xampp\htdocs\Bus_Booking (đã đúng nếu bạn đang ở thư mục này).
  3. Tạo database MySQL tên bus_booking.
  4. Import schema:
  5. 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');
  1. 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');
  1. Tạo thư mục lưu trữ nếu chưa tồn tại (Windows):
storage/ 
  uploads/
  qrcodes/
  logs/
  1. 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
  1. 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');
  1. Khởi chạy: bật Apache + MySQL trong XAMPP, truy cập:

Hướng dẫn sử dụng nhanh

Người dùng

  • 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é.

Đối tác

Quản trị viên

API (tổng quan nhanh)

Các endpoint PHP theo nhóm trong thư mục api/:

Lưu ý: đa số endpoint nhận/đáp JSON; kiểm tra tham số yêu cầu trước khi gọi.

Thanh toán

VNPay (Sandbox)

  • Cấu hình tại config/vnpay.php. Service tạo URL: core/VNPayService.php.
  • VNPAY_RETURN_URL mặ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 00 là thành công; bản đồ mã xem trong VNPAY_RESPONSE_CODES.

MoMo

Email

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

Bảo mật & cấu hình

  • 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: đặt false khi 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 .env nếu có thể.

Khởi chạy & phát triển

  • 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/.

Gỡ lỗi thường gặp

  • 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_booking tồn tại.
  • Email không gửi: cài PHPMailer (composer require phpmailer/phpmailer), kiểm tra SMTP_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ạo storage/uploads, storage/qrcodes, storage/logs và cấp quyền ghi.
  • Lỗi đường dẫn asset: xác nhận APP_URL trong config/constants.php khớp URL đang truy cập.

Đóng góp & liên hệ

  • Mở issue/PR cho tính năng mới hoặc bug.
  • Hỗ trợ/trao đổi: 4fbusbooking.noreply@gmail.com

About

Online bus ticket booking system (inspired by VeXeRe): search trips, seat selection, VNPay payment, multi-role (User / Partner / Admin). Built with PHP & MySQL.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages