CHALLENGE.md

Packlink Engineering coding test

Instructions

1. Fork and Clone this repo
2. Work on the requirements
3. Create a file instructions.md for the instructions needed to run the project
4. Do a PR with your code and any other needed information
5. Send an email notifying us

What we will look for

We want to see your proficency modeling a problem with code. How you structre it, how you test. While a working application is a big plus, if not working please submit it anyway.

IMPORTANT

The business logig has been kept small on porpuse, however, structure your code as this were a big application. Apply SOLID principles.

Technology Requirements

• Choose the language you feel most confortable with
• Use of a framework
• Unit tests & Integration tests
• The application has to be self-contained. That is, should not depend on extenernal conections not provided with it.

Storage

Use in memory storage. Do not depend on an instaled database.

The task at hand

Create an application listening to port 8085, and:

1

The application should be able to receive a POST http://localhost:8055/api/register with payload (store it as a shipment):

{
  "reference":"ABCD123456",
  "parcels" : [
  {
    "weight":1,
    "width": 10,
    "height": 10,
    "lenght": 10
  },
  {
    "weight":2,
    "width": 20,
    "height": 20,
    "lenght": 20
  }
  ]
}

2

The application should be able to receive a PUT http://localhost:8055/api/push with the following payloads (tracking):

A

{
  "status":"WAITING_IN_HUB",
  "parcels":2,
  "weight":null,
  "reference":"ABCD123456"
}

B

{
  "status":"WAITING_IN_HUB",
  "parcels":2,
  "weight":2,
  "reference":"ABCD123456"
}

C

{
  "status":"WAITING_IN_HUB",
  "parcels":1,
  "weight":15,
  "reference":"ABCD123456"
}

D

{
  "status":"WAITING_IN_HUB",
  "parcels":2,
  "weight":30,
  "reference":"ABCD123456"
}

E

{
  "status":"DELIVERED",
  "parcels":2,
  "weight":2,
  "reference":"ABCD123456"
}

F

{
  "status":"DELIVERED",
  "parcels":2,
  "weight":30,
  "reference":"ABCD123456"
}

G

{
  "status":"DELIVERED",
  "parcels":2,
  "weight":30,
  "reference":"EFGH123456"
}

H

{
  "status":"DELIVERED",
  "parcels":null,
  "weight":30,
  "reference":"ABCD123456"
}

Business logic

Using the above examples:

---

Given the provided shipment When

• shipment reference should be equal to tracking reference
• shipment parcel number should be equal to tracking parcel number.
• shipment total weight should be less than tracking weight.
• tracking status should be DELIVERED

Then dispatch an application event

{
  "reference":"ABCD123456",
  "status": "CONCILLIATION_REQUEST"
}

AND print it into the console

---

Given the provided shipment When

• shipment reference should be equal to tracking reference.
• shipment parcel number should be equal to tracking parcel number.
• shipment total weight should be greater or equal than tracking weight.
• tracking status should be DELIVERED.

Then dispatch an application event

{
  "reference":"ABCD123456",
  "status": "NOT_NEEDED"
}

AND print it into the console

---

Given the provided shipment When

• shipment reference should be equal to tracking reference
• tracking status is not DELIVERED

Then dispatch an application event

{
  "reference":"ABCD123456",
  "status": "INCOMPLETE"
}

AND print it into the console

---

Given the provided shipment When

• shipment reference should be equal to tracking reference
• any other tracking field is null

Then dispatch an application event

{
  "reference":"ABCD123456",
  "status": "INCOMPLETE"
}

AND print it into the console

---

Given the provided shipment When

• tracking reference is not equal toshipment reference

Then dispatch an application event

{
  "reference":"EFGH123456",
  "status": "NOT_FOUND"
}

AND print it into the console

---