A platform to help tourists plan their travels by booking flights, accommodations, transportation, and activities. Additionally, it allows sellers and advertisers to post their offers and products for tourists to book.
Travel planning can be overwhelming, with tourists needing to coordinate flights, accommodations, transportation, and activities while managing multiple platforms. Similarly, sellers and advertisers in the tourism industry often struggle to reach potential customers in a crowded market. This project aims to simplify the travel planning process by offering a one-stop platform for tourists to book all aspects of their trip, while also providing an easy way for sellers to connect with travelers and promote their offers. By bringing everything into a single platform, we can enhance user experience and create new opportunities for both tourists and vendors.
-
Build Status is of this project is IN PROGRESS
-
Known Issues: Response time is a little bit slow possibly due to amount of requests sent to the server also UI/UX could still be improved. Some minor changes to the overall logic of some functions may need fine tuning
-
Last Updated: 9/12/2024
- Camel Case for Variables and Functions
loginTourist,createTourist,generateOTP
- Consistent Capitalization in Model Imports
const touristModel = require('../Models/Tourist.js')
- Descriptive and Meaningful Variable Names
- Clear naming that indicates purpose:
Username,Email,DOB
- Clear naming that indicates purpose:
-
Always handle errors with meaningful messages. Use try-catch blocks for asynchronous code.
-
Functions should be defined as const to ensure they are not reassigned, maintaining consistency and avoiding accidental errors.
-
MongoDB
MongoDB is a NoSQL database that stores data in a flexible, JSON-like format. It is highly scalable, making it ideal for applications that require handling large volumes of data with varying structures. -
Express.js
Express.js is a fast Node.js web application framework designed to build network applications quickly and efficiently, offering a minimal set of features for routing and middleware. -
React.js
React.js is a JavaScript library for building user interfaces, particularly single-page applications, with a component-based architecture for reusable UI elements and efficient rendering. -
Node.js
Node.js is a runtime environment that enables JavaScript execution on the server side, known for its event-driven, non-blocking I/O, making it perfect for building scalable, high-performance applications.
- Flight Booking
- Hotel Booking
- Activity and Itinerary booking
- Product Buying and Selling
- Transportation Booking
- Advertising activities
- Posting historical sites
This example shows how to create a new tourist.
const createTourist = async (req, res) => {
const { Username, Email, Password, Nationality, DOB, Occupation, showIntro } = req.body;
try {
const userExistsInTourist = await touristModel.findOne({ Username });
const userExistsInTourGuide = await tourGuideModel.findOne({ Username });
const userExistsInAdvertiser = await advertiserModel.findOne({ Username });
const userExistsInSeller = await sellerModel.findOne({ Username });
const userExistsInAdmin = await adminModel.findOne({ Username });
const userExistsInTourismGov = await tourismGovModel.findOne({ Username });
if (userExistsInTourist || userExistsInTourGuide || userExistsInAdvertiser || userExistsInSeller || userExistsInAdmin || userExistsInTourismGov) {
return res.status(400).json({ error: 'Username already exists.' });
}
const hashedPassword = await bcrypt.hash(Password, 10);
const tourist = await touristModel.create({
Username,
Email,
Password: hashedPassword,
Nationality,
DOB,
Occupation,
showIntro
});
res.status(200).json({
message: 'Tourist registered successfully',
tourist,
});
} catch (error) {
res.status(400).json({ error: error.message });
}
};This example shows how to add a new product to the website.
const createProductseller = async (req, res) => {
const { productName,description,price,rating,seller,review,stock } = req.body;
const image = req.file ? req.file.path : null;
try {
const product = await productModel.create({ productName,description,price,rating,seller,review,stock,image });
res.status(201).json(product);
} catch (error) {
res.status(400).json({ error: error.message });
}
};This example shows how itineraries get fetched in the frontend.
const fetchASCItineraries = async () => {
try {
const response = await fetch(`http://localhost:8000/sortItinPASC`, {
method: 'GET',
headers: {
'Content-Type': 'application/json',
},
});
if (response.ok) {
const data = await response.json();
const filteredItineraries = data.filter(itinerary => !itinerary.FlagInappropriate && itinerary.active);
setItineraries(filteredItineraries);
setErrorMessage('');
} else {
throw new Error('Failed to fetch itineraries');
}
} catch (error) {
setErrorMessage('An error occurred while fetching itineraries');
console.error(error);
} finally {
setLoading(false);
}
};Follow these steps to set up the project locally:
- Clone the Repository
First, clone the repository to your local machine using the following command:git clone https://github.com/Advanced-computer-lab-2024/Triptastic
- Navigate to the Project Directory After cloning, navigate into the project directory:
cd Triptastic- Install the necessary dependencies using npm
npm iNow you will have installed the project along with its necessary dependancies
- Set Up Environment Variables Create a .env and add the uri to your mongo cluster and any API keys you will need
- Run the Application
To run this application after you have installed all necessary dependancies you need to open 2 terminals in the first one you will run the server by runningcd backendThen in the 2nd terminal to run the application itself runnodemon server.js
cd frontendnpm start
GET:https://test.api.amadeus.com/v2/shopping/flight-offers GET:https://test.api.amadeus.com/v3/shopping/hotel-offers
https://maps.googleapis.com/maps/api/geocode/json
https://api.exchangerate-api.com/v4/latest
To test our website functionality we used Postman to test all routes below you will find some example routes that were tested please make sure to examine the route itself to see if there is need for a body or query
POST:http://localhost:8000/createProductseller
GET:http://localhost:8000/filterItineraries?minBudget=50&maxBudget=3500
PATCH:http://localhost:8000/addProductToWishlist
PATCH:http://localhost:8000/updateProductQuantityInCart
GET:http://localhost:8000/getPreferences?username=${username}
GET:http://localhost:8000/searchActivities?name=brgr
POST:http://localhost:8000/createHistoricalLocation
PATCH:http://localhost:8000/updateTourist
GET:http://localhost:8000/filterProductsByPriceRange?minPrice=30&maxPrice=40
POST:http://localhost:8000/signup
POST:http://localhost:8000/loginTourist
PATCH:http://localhost:8000/updateSeller
GET:http://localhost:8000/getHistoricalLocationByName?Name=The%20Great%20Pyramid%20of%20Giza
GET:http://localhost:8000/getActivityByname?name=ruby%20concert
POST:http://localhost:8000/addItinerary
After signing up or logging in as a tourist you will be met with your main profile page where you have access to a number of different functionalities you can navigate seemlessly through pages to view different activities or itineraries,book flights or hotels,edit your profile information all with backtracking to your home page to not get stuck in one of the pages.
After signing up or logging in as a seller your main dashboard will appear where you can view the products you posted,post another product and view your sales reports
After signing up or logging in as an advertiser you will be met with your main dashboard where you will be able to view yoour profits as well as navigate to view the activities and transportations you posted or to post a new activity or transportation
After signing up or logging in as an admin you will be met with your main dashboard where you can view all sales statistics from there you can navigate to a multitude of pages iincluding viewing issued complaints,products,altering or deleting user profiles
After signing up or logging in as a tour guide you will be met with your main profile page where you can view your sales reports from there you can navigate to view your posted itineraries or add a new one.
As a tourism governer your home page includes are your posted historical locations from there you can navigate to posting a new one.
We welcome contributions from the community! Whether you want to fix a bug, add a new feature, or improve the documentation, your help is appreciated.
- Create a New Branch: Always create a new branch for each feature or bug fix you work on.
- Submit a Pull Request: Once you've made your changes, submit a pull request to the main repository. Make sure to include a clear description of your changes.
https://www.youtube.com/channel/UC29ju8bIPH5as8OGnQzwJyA
https://www.youtube.com/channel/UCW5YeuERMmlnqo4oq8vwUpg
Apache License 2.0
Copyright [2024] [Triptastic]
Licensed under the Apache License, Version 2.0 you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.