Skip to content

Ramsey99/Admin_Dashboard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 

Repository files navigation

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
Stars Forks Issues Open Pull Requests Close Pull Requests

Table of Contents

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:
HTML5 CSS3 JavaScript React

State Management:
Redux

Backend:
NodeJS Express.js

Database:
MongoDB

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

Charting Library:
Chart.js

UI Framework:
TailwindCSS

Design:
Canva Figma

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
  1. Install dependencies:
npm install
  1. Configure environment variables:
Create a .env file in the root directory.
  1. Add your MongoDB connection string and other environment variables:
MONGODB_URI=your_mongodb_uri
PORT=your_preferred_port
  1. Run the application:
npm start
  1. 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.

⭐️ 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

License: MIT

Contact

For any questions or inquiries, you can reach me at: anujobadhikari@gmail.com

About

Admin dashboard project for a bus transport organization

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published