🚅RouteRover - Train Booking System

🗣️Introduction

RouteRover is a comprehensive train booking system designed to streamline the process of finding trains, booking tickets, and tracking live train positions. The project is built using React, Vite, Tailwind CSS for the frontend, Flask (Python) for the backend, and MySQL as the database. The system includes various features such as train search by station, number, or name, ticket booking with a unique ID generation, live train tracking, station information, user dashboard, contact forum, and an admin panel.

✨Features

📍Train Search

• By Station, Number, or Name: Users can find trains using different criteria, enhancing search flexibility.

📍Ticket Booking

• Multiple Passengers: Users can book tickets for multiple passengers in a single transaction.
• Unique Booking ID: Each booking is assigned a unique ID for reference.

📍Live Train Tracking

• Real-time Position: Track the live position of a train on its route.
• Schedule and Stops: View the train schedule and stops, including wait times.
• Hotels Near Stops: Get information about hotels near each train stop.

📍Station Information

• Detailed Station Info: Access information about every station, including name, location, and additional details.

📍User Dashboard

• User Information: View user details and previous bookings.

📍Contact Forum

• Helpline List: A forum providing a list of helplines for different queries.

📍Authentication

• Login/Signup: Secure authentication with validation checks.

📍Admin Panel

• Train Management: Add new trains and set live train locations.
• Admin Details: Access detailed information for administrators.

📊Tech Stack

• Frontend:

  • React+Vite
  • Tailwind CSS

• Backend:

  • Flask (Python)

• Database:

  • MySQL

👨🏻‍💻Installation

1. Clone the repository: git clone https://github.com/shrudex/routerover.git
2. Install dependencies:
   • Frontend: npm install
   • Backend: cd python && pip install -r requirements.txt
3. Configure the MySQL database by importing the provided SQL file.
4. Set up environmental variables for the backend, including database credentials.

🎯Usage

1. Start the backend server: cd python && python app.py
2. Start the frontend application: npm run dev
3. Access the application at http://localhost:3000 in your browser.

📸Screenshots

🫱🏻‍🫲🏻Contributing

Contributions are welcome! Clone the repository and send me a PR to merge, with valid contributions.

🤙🏻Contact

For inquiries, contact us at realshubhsinha@gmail.com.

---