Developer Evaluation Project

READ CAREFULLY

Guidelines for Running the Application

Below the instructions to run the application in Visual Studio Code or Visual Studio with Docker.

Visual Studio Code

1. Open a terminal in the directory "\template\backend", where the docker-compose.yml file is located, run the command below:
   • docker compose up --build
2. After running the containers:
3. Open a terminal in the directory "\template\backend\src\Ambev.DeveloperEvaluation.WebApi", run the Migration command below:
   • dotnet ef database update
4. Assuming the containers and migration are ok, open the API with Swagger at the URL below:
   • https://localhost:8081/swagger/index.html

Visual Studio

1. Open the solution with Docker Compose support and wait for the containers to be running.
2. After running the containers:
3. Open a terminal in the directory "\template\backend\src\Ambev.DeveloperEvaluation.WebApi", run the Migration command below:
   • dotnet ef database update
4. Assuming the containers and migration are ok, click on the VS start button to run the application in Debug mode, the browser will open the API with Swagger at the URL below:
   • https://localhost:8081/swagger/index.html

Instructions

The test below will have up to 7 calendar days to be delivered from the date of receipt of this manual.

• The code must be versioned in a public Github repository and a link must be sent for evaluation once completed
• Upload this template to your repository and start working from it
• Read the instructions carefully and make sure all requirements are being addressed
• The repository must provide instructions on how to configure, execute and test the project
• Documentation and overall organization will also be taken into consideration

Use Case

You are a developer on the DeveloperStore team. Now we need to implement the API prototypes.

As we work with DDD, to reference entities from other domains, we use the External Identities pattern with denormalization of entity descriptions.

Therefore, you will write an API (complete CRUD) that handles sales records. The API needs to be able to inform:

• Sale number
• Date when the sale was made
• Customer
• Total sale amount
• Branch where the sale was made
• Products
• Quantities
• Unit prices
• Discounts
• Total amount for each item
• Cancelled/Not Cancelled

It's not mandatory, but it would be a differential to build code for publishing events of:

• SaleCreated
• SaleModified
• SaleCancelled
• ItemCancelled

If you write the code, it's not required to actually publish to any Message Broker. You can log a message in the application log or however you find most convenient.

Business Rules

• Purchases above 4 identical items have a 10% discount
• Purchases between 10 and 20 identical items have a 20% discount
• It's not possible to sell above 20 identical items
• Purchases below 4 items cannot have a discount

These business rules define quantity-based discounting tiers and limitations:

1. Discount Tiers:

   • 4+ items: 10% discount
   • 10-20 items: 20% discount

2. Restrictions:

   • Maximum limit: 20 items per product
   • No discounts allowed for quantities below 4 items

Overview

This section provides a high-level overview of the project and the various skills and competencies it aims to assess for developer candidates.

See Overview

Tech Stack

This section lists the key technologies used in the project, including the backend, testing, frontend, and database components.

See Tech Stack

Frameworks

This section outlines the frameworks and libraries that are leveraged in the project to enhance development productivity and maintainability.

See Frameworks

Project Structure

This section describes the overall structure and organization of the project files and directories.

See Project Structure