Panalpina Build-a-Backend Challenge

Welcome to the Panalpina Shipment Tracking App Build-a-Backend Challenge!
This challenge is focused on creating the back-end of a real-time shipment tracking application.

Final Submission Guidelines

The Panalpina Group is one of the world's leading providers of supply chain solutions. The company combines its core products – Air Freight, Ocean Freight, and Logistics and Manufacturing – to deliver globally integrated, tailor-made end-to-end solutions for twelve core industries. Drawing on in-depth industry know-how and customized IT systems, Panalpina manages the needs of its customers' supply chains, no matter how demanding they might be. The Panalpina Group operates a global shipping network with some 500 facilities in around 70 countries, and it works with partner companies in another 100 countries.

The current systems only display tabular information including the ETA and event history for the shipment. Panalpina wishes to have an interface with realtime airline and ship tracking to display the current location of packages, and at the same time modernize the look and feel of the interface, making it more engaging for their customers.
As a user, customers want to enter a tracking number they have been provided so that they can see detailed shipping information with visual mapping and charts.

The point of this project is to add real-time tracking, however the trackers may display historic data as well.

Requirements

For this challenge, we have provided Swagger and Postman files, as well as database extracts to use.
The APIs we need our competitors to use are Marinetraffic.com and FlightAware.com. Marinetraffic.com does use ‘credit’ for API calls, but you receive 100 credits free when you create an account. There will be a forum post for the FlightAware API key.

The user workflow should look like:

• The user puts in a tracking number
• The tracking number is associated with a flight/vessel number in Panalpina’s database
• Requests from the freight API should go to maratimetraffic.com
• The one that correlated with the flight/vessel number sends back coordinates, historic position from port of loading and probable path to port of discharge.
• Make sure the ship is passing the correct ports
• Feel free to play around with the API and add features as you see fit but be mindful of performance and budget
• Our API then sends the coordinates to the maps API, so that we can display routes on the map.

For visual references of what the site will look like and possible endpoints, see:
Desktop: https://marvelapp.com/42a550d/screen/47126613
Mobile: https://marvelapp.com/9cac69e/screen/47126708

Technology Stack

• Java8, using Spring for REST APIs
• JPA for Database Access
• Front end will be built in Angular 6

What To Submit

In a zip file, please submit:

• A README.md that covers:
  • instructions for setting up the environment and testing calls
  • Include any configuration options
  • instructions on installing any necessary dependencies
• Any updated Swagger or Postman Files