NC State PackTravel

Welcome to PackTravel, your ultimate solution for escaping the confines of campus life and exploring the world beyond! 🚗💨 Tired of relying on the same old campus shuttle or waiting for a ride that never comes? Well, we've got your back!

PackTravel is here to revolutionize your off-campus travel experience, offering students without personal vehicles a hassle-free way to get where they need to go—whether it's a weekend getaway or just a quick trip to the nearest coffee shop (because let’s face it, sometimes the campus brew just doesn’t cut it). ☕🚀

Join our vibrant community, where convenience meets collaboration, and safety is always the top priority. With PackTravel, it’s not just about the ride—it’s about sharing the journey with fellow students, creating connections, and making your travel experience smarter and more fun!

So, pack your bags (or just your backpack), hop on board, and let’s make those off-campus adventures easier, cheaper, and a lot more exciting. Let’s get you where you need to go with PackTravel—your ride to freedom! 🌍🛣️

NEW BADGES

Pre-requisites

To run these scripts, you will require Python installed on your PC. Please visit Python Installers to download the lastest python version. Apart from that, other requirements can be installed with the help of requirements.txt.

Installation

Initially, you can check whether your system has Python pre-installed or not, usually nowadays in most of systems, be it Windows or MacOS, python is pre-installed.

To check whether you have python installed or not, you can open CMD or a Terminal and run the command "python --version". If the CMD shows the version such as Python 3.10 then your system already has python installed and you just need to clone the repository and run the python scripts.

If this is not the case, then you need to download python installer package from Python Installers based on your system's operating system and install it and you can further clone this repository to execute the scripts.

You can refer INSTALL.md for the complete installation steps based on your OS.

Poster

Contribution Code of Conduct

The rules listed below are to be followed by the ones who will be contributing to the code in the repository:

• At least one review/approval is required from any other contributors of the project to merge a commit to the main branch.
• It is recommended to delete the branch as soon as it is merged to the main branch to avoid stale branches in the repository.
• It is encouraged to add name tags such as "feature-", "upd-" or "patch-" in the branches if it is used to add code patches or features in the project.

Test Run Screenshot

Code Coverage Screenshot

Discord Channel Screenshot

Video demonstrating the old functionalities

Video demonstrating the new functionalities

Issues in Previous Phase -

• Login and Logout Functionality: The login and logout features were not functioning as expected; clicking on them did not trigger any action.
• Unauthenticated Access: Users were able to access several features, such as creating or searching for rides, without being logged in.
• Homepage Background Image: The background image on the homepage was not displaying correctly.
• Database Updates: The Users and Routes databases were not being updated properly.
• Redirection After Login: After logging in, users were not redirected to the correct homepage. Instead, they were directed to an index page.
• Test Cases and Code Coverage: The application lacked sufficient test cases, and the code coverage was inadequate, which limits the ability to detect errors and ensure system reliability.
• Documentation Issues: Several Python files lacked proper documentation, making it difficult to understand the code and its functionality.

Quick look at the newly added features

• My Rides Section for Streamlined Ride Management: A dedicated space where users can easily track, view, and delete the rides they've created. This feature offers enhanced convenience for managing personal rides, ensuring users have full control over their travel plans at all times.

• Popular Rides Section for Quick Access: Users can now view the most frequently joined rides at a glance. This feature allows for quick discovery of popular travel options, helping users easily find and join well-frequented rides without hassle.

• Interactive Discussion Forum for Community Engagement: The new discussion forum provides an interactive platform for users to share tips, exchange experiences, and discuss specific routes or trips. This fosters a vibrant community where users can collaborate and gain insights from fellow travelers.

• Email Notifications to Keep Users Informed: Automated email alerts notify users when they successfully join a ride. This ensures users stay engaged and informed, with timely updates about their travel plans and any changes to the rides they are part of.

• Critical Bug Fixes for Improved User Experience: Several key bugs have been resolved, including issues with login alerts, password confirmation mismatches, and background image loading problems. These fixes enhance the overall stability of the app, ensuring a smoother, more reliable user experience.

Use Cases:

1. Viewing My Rides

   • Actor: PackTravel User (Student)

   • Goal: View the rides they’ve created or joined.

   • Steps:

     • The user logs into the PackTravel platform.
     • They navigate to the "My Rides" section.
     • The system displays a list of their rides, including details such as ride time, destination, and participants.
     • The user selects a ride to view more detailed information.

   • Outcome: The user successfully tracks and views their rides, ensuring they are up to date with their travel plans.

2. Viewing Top Ride Picks

   • Actor: NCSU Student
   • Goal: Discover top-rated or highly recommended rides.
   • Steps:
     • The user logs into the PackTravel platform.
     • They navigate to the "Top Picks" section.
     • The system displays a list of top-rated or popular rides based on user feedback or ride popularity.
     • The user clicks on a ride for more information.
   • Outcome: The user easily discovers the best rides available, saving time in selecting a ride that suits their preferences.

3. Posting in the Discussion Forum

   • Actor: NCSU Student
   • Goal: Share travel experiences or discuss specific routes and trips with other users.
   • Steps:
     • The user logs into the PackTravel platform.
     • They access the "Discussion Forum" section.
     • The system displays a list of ongoing topics.
     • The user creates a new discussion topic or comments on an existing one.
     • The system updates the thread and notifies relevant users.
   • Outcome: The user contributes to the community by sharing their experiences or gaining insights on travel routes.

4. Joining a Ride

   • Actor: PackTravel User (Student)
   • Goal: Join a ride that suits their destination and timing.
   • Steps:
     • The user logs into the PackTravel platform.
     • They browse or search for available rides to their desired destination.
     • The user selects a ride and clicks "Join."
     • The system confirms the user’s participation and updates the ride's participant list.
     • The user receives a confirmation notification about the ride. Outcome: The user successfully joins a ride, ensuring a smooth and collaborative travel experience with fellow students.

5. Editing a Ride

   • Actor: PackTravel User (Student)
   • Goal: Edit an existing ride they created, such as adjusting the time or destination.
   • Steps:
     • The user logs into the PackTravel platform.
     • They navigate to the "My Rides" section.
     • The user selects a ride they have previously created.
     • The system allows them to edit details like the ride's time, destination, or available seats.
     • The user saves the changes, and the updated ride details are reflected in the system. Outcome: The user successfully updates the ride information, allowing for better coordination with other participants.

Built Using:

Tools

• Preetier Code Formatter
• JS-HTML-CSS Formatter
• PyLint

Roadmap

• List of Roadmap and their corresponding open issues

Team Members - Project 3

• Anish Dhage
• Gaurav Sheth
• Soham Gundewar