Skip to content

amisha-w/PackTravel

Repository files navigation

PackTravel

DOI codecov Python Style Checker Lint Python

License: MIT contributors Total Lines Issues Closed Issues Pull Requests Commit Acitivity Repo Size

πŸ† Goal

Travelling alone? Try PackTravel

Project Description:

Most of the university students do not have a car to travel off-campus and rely mostly on the Wolfline. But what if someone wants to travel outside Wolfline's limit? Well... why not collaborate on PackTravel to travel off-campus by a cab, rental car, etc.

So, let's PackTravel 😎

Features

  • Create a PackTravel Ride
  • Create mmultiple routes to reach a ride's destination: Bus, Cab or Personal
  • Search and view other's rides
  • Join a PackTravel Ride's route

πŸš€ A bit abut PackTravel

YN7JIC44O9604G33.mp4

Built Using:

πŸ“– Getting started:

πŸ‘€ Who can use our app

  1. If you are a user who is visiting our app, you can sign up as a user with view access to rides. You can edit or create your own ride.
  2. If you are an admin user, you can create, view, update and delete rides and schedule rides.
  3. To request for admin privileges, please email on [email protected] with the purpose of use.

Run Locally

Create a virtual environment:

  python3.x -m venv test_env

Activate the virtual environment: Linux/MacOS:

  source test_env/bin/activate

Windows:

  ./test_env/Scripts/activate

Clone the project

  git clone https://github.com/amisha-w/PackTravel.git

Go to the project directory

  cd PackTravel

Install dependencies

  pip install -r requirements.txt

Start the server

  python manage.py migrate
  python manage.py runserver
 - Site will be hosted at:
   `http://127.0.0.1:5000/`

πŸ› οΈ Tools

πŸ§‘β€πŸ’» Functionalities in Action

  • Login Page

  • Creating a Ride

  • Search for a Ride

  • Joining an existing Ride

  • Adding New Route

  • Sign Up Page

πŸ’¬ Chat Channel

🎯 Phase 1:

  • Create database ER diagram
  • Create Mongo Database
  • Create HomePage
  • Create Login and Signup Page
  • Create Search Page
  • Added create Rides Page
  • Added create routes Page
  • Setup Django
  • Add Unit testing
  • Add Error Handling mechanisms
  • Setup Workflows

🎯 Future Enhancements:

  • Add machine learning algorithms for predicting lowest priced rides, best pickup and drop-off locations.
  • Add functionality to merge routes
  • Show later departures in search if currently searched rides is not available
  • Increase the geographical area coverage for the application
  • Extend the userbase to students other than that of the North Carolina State University
  • Integrate in-app cab booking services
  • Introduce a two way ride confirmation feature

Contributions to the Project

πŸ‘¨β€πŸ­ Contributors


Amisha Waghela

Aoishi Das


Ameya Chavan


Kunal Shah


Swarnamalya M

❗ TroubleShooting and Help Guide

  1. For any issues faced while using the application, please email the detailed description and steps to reproduce the error at [email protected] .
  2. If you are a developer, please raise an issue on github with steps to reproduce and possible source of error.
  3. Our email is monitored 24x7 and we usually respond within 1 hour. Happy Emailing :).