Public Bus Transportation System - Admin Dashboard

This repository contains the Admin Dashboard for a public bus transportation system. The system provides functionalities for different types of users: customers, drivers, and administrators. Each user type has unique features and access levels, designed to streamline bus transportation management and operations.

🌟 Stars	🍴 Forks	🐛 Issues	🔔 Open PRs	🔕 Close PRs

Table of Contents

• Features
• Technologies Used
• Getting Started
• Installation
• Contributing
• License
• Contact

Features

Customer

• View Bus Schedules: See bus times and stoppages for convenient travel planning.
  
• Book Tickets: Reserve seats on buses for specific routes and times.

Driver

• Daily Allotment: View the allotted bus number and route for the day.
  
• Route Information: Access detailed information about the assigned route and bus stops.

Admin

• Bus Allotment: Assign buses to drivers for each day.
  
• Driver Management:
  
  • Reassign buses if a driver is absent.
    
  • Add new drivers and delete old drivers.
    
• Bus Location Tracking: Monitor the real-time location of buses on their routes.
• Dashboard Analytics:
  • View monthly transaction reports.
  • Track the number of passengers traveling each day.

Technologies Used

Frontend:

State Management:

Backend:

Database:

Real-time Data:
WebSockets or similar technology for real-time bus tracking

Charting Library:

UI Framework:

Design:

Getting Started

To set up the project locally, follow these steps:

Prerequisites

• Node.js: Ensure you have Node.js installed.
• MongoDB: A running instance of MongoDB.

Installation

1. Clone the repository:

git clone https://github.com/Ramsey99/Admin_Dashboard.git
cd Admin_Dashboard

2. Install dependencies:

npm install

3. Configure environment variables:

Create a .env file in the root directory.

4. Add your MongoDB connection string and other environment variables:

MONGODB_URI=your_mongodb_uri
PORT=your_preferred_port

5. Run the application:

npm start

6. Access the dashboard:

Open your web browser and go to http://localhost:your_preferred_port.

Contributing

• Contributions are welcome! If you have any suggestions or improvements, please open an issue or create a pull request.

Creating Pull Request

1. Fork the Project:

   • Click on the "Fork" button at the top right corner of the repository's page on GitHub to create your own copy of the project.

2. Clone Your Forked Repository:

   • Clone the forked repository to your local machine using the following command:

    git clone https://github.com/Ramsey99/Admin_Dashboard

3. Create a New Branch and Move to the Branch:

   • Create a new branch for your changes and move to that branch using the following commands:

   git checkout -b <branch-name>

4. Add Your Changes:

   • After you have made your changes, check the status of the changed files using the following command:

   git status -s

   • Add all the files to the staging area using the following command:

   git add .

   • or add specific files using:

   git add <file_name1> <file_name2>

5. Commit Your Changes:

   • Commit your changes with a descriptive message using the following command:

   git commit -m "<EXPLAIN-YOUR_CHANGES>"

6. Push Your Changes:

   • Push your changes to your forked repository on GitHub using the following command:

   git push origin <branch-name>

7. Open a Pull Request:

   • Go to the GitHub page of your forked repository, and you should see an option to create a pull request. Click on it, provide a descriptive title and description for your pull request, and then submit it.

---

👀 Our Contributors

• We extend our heartfelt gratitude for your invaluable contribution to our project! Your efforts play a pivotal role in elevating Ratna-Supermarket to greater heights.
• Make sure you show some love by giving ⭐ to our repository.

---

⭐️ Support the Project If you find this project helpful, please consider giving it a star on GitHub! Your support helps to grow the project and reach more contributors.

Show some ❤️ by starring this awesome repository!

License

Contact

For any questions or inquiries, you can reach me at: [email protected]