Delivery management

A system management for deliveries. System supports concurrent deliveries requestes according timeslots constraints.

Prerequisites

The following technologies should be installed globally

• Node (preferred version / project version - 14.15.3)
• ts-node
• TypeScript
• Nodemon

Installation

Before running this project install node modules in both server with this command:

npm install

Run Server with the command:

nodemon server.ts

Assumptions

• Since Holiday API free version supports only in last year data, I consider last year as this year. Upcoming week is current range of dates of last year.
• address.json is a static json contain 2 addresses for the simplicity of creating timeslots.
• In order to support concurrency while booking a delivery, processing delivery conatins "pending" status. pendingDeliveries.json works like a queue.
• Limitation of up to 10 deliveries in a day is reflcated by the number of timeslots range, for simplicity.
• Available timeslot is a timeslot with less than 2 deliveries.

Scenarios:

• Book a delivery when timeslot reached to its limit:

• Book a delivery when the address is unsupported:

• Book a delivery - placed successfully (timeslot available):

• Daily deliveries (placed only)

• Mark delivery as completed:

• Weekly deliveries (placed only)

• Structured address:

• Timeslots by address (available only, less than 2 deliveries):