https://github.com/albertllousas/supermarket-tdd-rest-kata
https://github.com/albertllousas/supermarket-tdd-rest-kata
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/albertllousas/supermarket-tdd-rest-kata
- Owner: albertllousas
- Created: 2020-03-03T15:09:31.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2022-03-18T15:30:45.000Z (about 3 years ago)
- Last Synced: 2025-01-30T22:48:27.221Z (3 months ago)
- Language: Kotlin
- Size: 130 KB
- Stars: 3
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Supermarket checkout micro-service tdd kata
Kata to practice outside-in TDD with [double loop](http://coding-is-like-cooking.info/2013/04/outside-in-development-with-double-loop-tdd/).
The idea is let tdd to guide us through **architecture and domain design** in a more realistic and day to day context, a
micro-services environment.
Inspired on [supermarket code kata](http://codekata.com/kata/kata01-supermarket-pricing/)
There is no implementation because this repository is the kata description itself, made for an internal exercise in N26,
feel free to create PRs for your solutions or to use it in your own katas.
## Kata description
[Slides](https://slides.com/albertllousasortiz-1/supermarket-checkout-kata)
We are going to implement a supermarket checkout, that basically calculates the total price given a list of **products** a
customer have on the **cart**.
In order to do that we will need and stock of the supermarket, it should have this information, at least:
```bash
SKU Price Description
---------------------------
A 2.00 Potato
B 4.00 Tomato
```
There is no any restriction on how implement the stock.
And these are the expected input/outputs for the app.
For the following API call:
```bash
curl --request POST http://localhost:8080/supermarket/checkout \
--header 'Content-Type: application/json' \
--data '{ skus: ["A","B","A","B","A","A","A"] }' \
--include
```
The output should be `201 CREATED` with body:
```json
{
"total": 18.00
}
```
**Notes**:
* Rule: Write prod code in terms of architecture and domain
* SKUs are [Stock keeping units](https://en.wikipedia.org/wiki/Stock_keeping_unit)
* Should respond with 204 for an empty cart request, `{ "skus": [] }`
Have fun!
## Where to start
We have provided the exercise with the [acceptance test](./src/test/kotlin/de/tech26/supermarket/acceptance/CalculateCartTotalAcceptanceTest.kt) already
set up, we don't want to waste time designing an API.
So jump [here](./src/test/kotlin/de/tech26/supermarket/changemeplease/ChangeMeControllerTest.kt) and start coding.
## Bonus
- How to handle non-existent stock?
- Introduce a discount system, choose one:
- 2x1 in some products
- Discount codes, % per total
## Tech stack
* Kotlin
* [Spring boot](https://spring.io/projects/spring-boot)
* Testing libraries/frameworks:
* [JUnit 5](https://junit.org/junit5/docs/current/user-guide/)
* [Assertj](https://joel-costigliola.github.io/assertj/)
* [Mockk](https://mockk.io/)
* [REST Assured](http://rest-assured.io/)
They are just the most common used, feel free to add/remove/change any dependency that fits to you
## Running the tests
Run all tests:
```bash
./gradlew test
```
Run unit tests:
```bash
./gradlew unitTest
```
Run integration tests:
```bash
./gradlew integrationTest
```
Run acceptance tests:
```bash
./gradlew acceptanceTest
```
## Useful links
- [Outside-in Double Loop TDD](http://coding-is-like-cooking.info/2013/04/outside-in-development-with-double-loop-tdd/)
- [London School](https://www.slideshare.net/pkofler/outsidein-test-driven-development-the-london-school-of-tdd)