TourGuide is a Spring Boot application that provides travel information and rewards to users based on their location.

Java 17 Spring Boot 3.X JUnit 5 Maven

This project relies on local libraries located in the libs folder. To build the project, you must install them into your local Maven repository first.

Run the following commands from the project root:

mvn install:install-file -Dfile=libs/gpsUtil.jar -DgroupId=gpsUtil -DartifactId=gpsUtil -Dversion=1.0.0 -Dpackaging=jar
mvn install:install-file -Dfile=libs/RewardCentral.jar -DgroupId=rewardCentral -DartifactId=rewardCentral -Dversion=1.0.0 -Dpackaging=jar
mvn install:install-file -Dfile=libs/TripPricer.jar -DgroupId=tripPricer -DartifactId=tripPricer -Dversion=1.0.0 -Dpackaging=jar

The application has been optimized to handle high volumes of users using Multithreading and Non-blocking concurrency.

• GPS Tracking: Time reduced from ~14 hours (sequential estimate) to < 5 minutes for 100,000 users.
• Rewards Calculation: Time reduced from > 20 minutes to < 5 minutes for 100,000 users.

Technical Strategy:

• Implementation of ExecutorService with a fixed thread pool (1000 threads).
• Use of CompletableFuture for asynchronous processing.
• Resolved ConcurrentModificationException by migrating ArrayList to thread-safe CopyOnWriteArrayList in the User domain.

A new endpoint /getNearbyAttractions has been added. It returns the 5 closest tourist attractions to the user, regardless of distance.

Response Format (JSON):

• Attraction Name
• Attraction Location (Lat/Long)
• User Location (Lat/Long)
• Distance (Miles)
• Reward Points

A GitHub Actions pipeline is set up to automatically build the project and run unit tests on every push to the repository.