Skip to content

vtramo/na-tour

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

What is NaTour?

NaTour is a complex and distributed system aimed at offering a modern social network to hiking lovers. The system consists of a secure, high-performance and scalable back-end (built with Spring Boot and cloud-based technologies) and a mobile client (Android) through which users can take advantage of the system's features in an intuitive, fast and pleasant way.

What are the system's functionalities?

  • A user can register/authenticate (even with third-party authentication e.g. Google and Facebook). This functionality was realized using Keycloak (Open Source Identity and Access Management).


  • An authenticated user can view all trails uploaded to the system.


  • An authenticated user can enter new trails into the platform. A trail is characterized by a name, a duration, a level of difficulty, a starting point, a description (optional), and a geographic trail (optional) that represents it on a map. The geographic trail must be either manually entered (by interacting with an interactive map) or via file in standard GPX format.


  • It is possible to display a detail screen for each trail. This screen shows all known information about the trail and displays its route on an interactive map. In addition, the detail screen shows user reviews and uploaded photos. The user can also show their location (if the mobile device supports GPS location) on the map.


  • A user can download the trail in GPX format, or the summary information in PDF format.


  • A user can add or remove trails from their list of favorites.


  • A user can upload photos of a trail. If the photo has a geographic location saved in the metadata, a marker corresponding to the photo can be displayed on the map to show where it was taken on the trail. All photographs, before being uploaded, are examined to verify the presence or absence of illegal content (this feature was created using the AWS Rekognition cloud service).


  • A user can add a review to a trail.


  • A user can chat with another user to ask for more information on an itinerary he has entered.

Swagger doc

https://app.swaggerhub.com/apis/vtramo/NaTourAPI/v0