Travel Planner ✈️

Travel Planner is a comprehensive web application designed to help users organize their next trip around the world. Whether you are looking for accommodation, guided tours, or just inspiration, Travel Planner simplifies the entire process.

🌍 Key Features

• Global City Search: Search from a vast database of cities worldwide.
• Explore Points of Interest: Discover local attractions, landmarks, and hidden gems in your chosen destination.
• Booking System: Directly book hotels or guided tours offered within the selected city.
• User Accounts & Personalization: Secure user authentication allows you to save custom itineraries.
• Route Optimization: View the most optimal routes for your itinerary based on your chosen mode of transport.
• AI Assistant: Interact with an integrated ChatBot to generate personalized itineraries tailored to your specific preferences.

📍 Tech Stack

Backend:

• Language: Java 23
• Framework: Spring Boot
• Database: PostgreSQL

Frontend:

• HTML5, CSS3, JavaScript (Data fetching & Display)

External Services & APIs:

• Google Maps API: For maps and routing.
• Amadeus API: For hotel and flight data/booking info.
• OpenAI API: Powering the AI ChatBot for itinerary generation.

⚙️ Continuous Integration & Quality Assurance

To ensure code reliability and maintainability, the project utilizes the following tools:

• GitHub Actions: Automated workflows are configured for:
  • Build Automation: Automatically builds the project to ensure stability.
  • Code Coverage: Generates coverage reports using JaCoCo.
• SonarQube: Used for continuous code inspection and static analysis to maintain high code quality and security.

👥 Roles and Responsibilities

Project Owner & Developer

• Gabriel Pesce

Scrum Master

• Mikołaj Diakowski

Developers

• Jocelyn Aubert
• Corentin Durant

💬 Communication Strategies

• 🎙️ Discord: The main communication channel is our dedicated Discord server, utilized for both text updates and voice calls/stand-ups.
• ✉️ Email: Secondary channel for formal communications and documentation exchange.

📥 Installation & Usage

Prerequisites

To run this application, ensure you have the following installed:

• Java 23
• A running instance of PostgreSQL (configured in the application properties)

Download

You can find the latest version of the program in the Releases section of this repository.

1. Download the file sds2-1.0-SNAPSHOT.jar.
2. Open your terminal or command prompt.
3. Navigate to the download folder and run the following command:

java -jar sds2-1.0-SNAPSHOT.jar

Or simply double-click the file.