TravelAgent

Travel Agent serves as your dedicated travel planning application. Users can effortlessly create accounts and engage with a virtual travel receptionist. By providing essential details such as the desired destination, departure and return dates, etc., users initiate requests to our backend travel API. The application fetches information on the top 3 hotels, local attractions, and the most budget-friendly flights from their nearest airport. Additionally, users can conveniently save their past searches in a planner for future reference.

Table of Contents

• Interface & Features
• Prerequisites
• Usage
• For Future Iterations
• The TravelAgent Team

Interface & Features

Sign-Up/Login page

• Users can create and log in to an account that holds their previous searches' data.

Series of chat options where users input their travel information

• Users can follow a series of chat options to create a customizable vacation itinerary.

Travel Itinerary

• A page that displays the three best sights in the areas, hotels, and cheapest flights from your nearest airport.

Option to save Itinerary for later use

• Users can save the itinerary for specific days and locations for future reference.

Prerequisites

To use TravelAgent, you will need to:

• Create a MongoDB cluster and copy the URI.
• Create a .env file within the root of the project.
• In the env file, create an ATLAS_URI with the copied URI code from MongoDB Atlas.
• Run npm install in the root directory to install all modules and packages.

Usage

To use TravelAgent effectively, follow these steps:

1. In the root terminal, type the command npm run dev, and a page should load.

2. Navigate to localhost:8080/signup and create an account.

3. Click option 3 or number 3 on your keyboard for the first option and type a city you would like to travel to in the United States.

4. Click option 3 or number 3 on your keyboard for the second option and type a date you would like to fly out in this format “xx/xx/xx”.

5. Click option 3 or number 3 on your keyboard for the third option and type a date you would like to return in this format “xx/xx/xx”.

6. Do not touch anything and wait 30 seconds, and the TravelAgent should lead you to a custom itinerary made for you.

7. If you would like to save an itinerary, click the “Add Trip” button at the top left.

8. If you would like to view your itinerary, click the “View All Trips” button on the top right, or you can just go to localhost:8080/userPage.

For Future Iterations

• Ensure the application retrieves flights based on the server's location aligned with the user's departure point.
• Exercise caution in location selection to prevent errors, favoring city specificity over states for robust performance.
• Be mindful when setting date ranges to prevent crashes, avoiding the selection of dates too far into the future.
• Exercise caution in choosing locations in less populated areas to prevent application crashes.
• The userPage does not refresh when items are deleted.
• Users can input anything in the input boxes, leading to potential errors, and the required format is not specified.
• If you reach the end of the dialogue, the app crashes.
• Attempting to animate text only works on the first call, and it appears somewhat unusual.
• The backend lacks proper error handling; the frontend should not crash when errors occur and should inform the user about the issue.
• We ensured that adding more dialogue is easy, so feel free to expand the lore.

The TravelAgent Team

Developed by:

• Preston Mounivong

  • LinkedIn: Preston Mounivong
  • GitHub: prrrrreston

• Josh Nelson

  • LinkedIn: Josh Nelson
  • GitHub: JoshNelson98

• Ayden Yip

  • LinkedIn: Ayden Yip
  • GitHub: aydenyipcs

• Quinn Craddock

  • LinkedIn: Quinn Craddock
  • GitHub: quinnCraddock4