Checkout basket

Checkout basket is an application to manage checkout basket.

Getting started

Requirements

To run this project you must have installed this following tools:

Running the project

To run this project you just need to follow the steps bellow:

1 - Clone project repository:

$ git clone https://github.com/henriqueholanda/backend-challenge.git

2 - Start the project

$ make start

Note: This command may spend some time to complete, mainly when you run for the first time, because it will download all Docker images that project needs from Docker Store and up two applications backend and frontend.

3 - Access the application on your favorite browser

http://localhost:3000

Stopping the project

If you want to stop you just need to run the following command:

$ make stop

Run tests

To run test using docker you just need to run the following command:

$ make test

Note: You must need to start project before it.

Author

Henrique Holanda

The Challenge

Besides providing exceptional transportation services, Cabify also runs a physical store which sells 3 products:

Code         | Name                |  Price
-------------------------------------------------
VOUCHER      | Cabify Voucher      |   5.00€
TSHIRT       | Cabify T-Shirt      |  20.00€
MUG          | Cabify Coffee Mug   |   7.50€

Various departments have insisted on the following discounts:

The marketing department thinks a buy 2 get 1 free promotion will work best (buy two of the same product, get one free), and would like this to only apply to VOUCHER items.
The CFO insists that the best way to increase sales is with discounts on bulk purchases (buying x or more of a product, the price of that product is reduced), and requests that if you buy 3 or more TSHIRT items, the price per unit should be 19.00€.

This set of rules to apply may change quite frequently in the future.

Your task is to implement a checkout system for this store.

The system should have differentiated client and server components that communicate over the network.

The server should expose the following independent operations:

Create a new checkout basket
Add a product to a basket
Get the total amount in a basket
Remove the basket

The server must support concurrent invocations of those operations: any of them may be invoked at any time, while other operations are still being performed, even for the same basket.

The client must connect user input with those operations via the protocol exposed by the server.

We don't have any DBAs at Cabify, so the service shouldn't use any external databases of any kind.

Implement a checkout service and its client that fulfils these requirements.

Examples:

Items: VOUCHER, TSHIRT, MUG
Total: 32.50€

Items: VOUCHER, TSHIRT, VOUCHER
Total: 25.00€

Items: TSHIRT, TSHIRT, TSHIRT, VOUCHER, TSHIRT
Total: 81.00€

Items: VOUCHER, TSHIRT, VOUCHER, VOUCHER, MUG, TSHIRT, TSHIRT
Total: 74.50€

The code should:

Build and execute in a Unix operating system.
Be written as production-ready code. You will write production code.
Be easy to grow and easy to add new functionality.
Have notes attached, explaining the solution and why certain things are included and others are left out.
It must not contain executable or object files. Just source files, documentation and data files are allowed.

henriqueholanda / backend-challenge