Just basic laravel component and in addition to the essential component for any clean project like:
- Service Class.
- Repository.
Just clone the project and use the docker to start. as I used (Sail) so its easy to install and run the project using these commands.
cp .env.example .env
docker run --rm --interactive --tty -v $(pwd):/app composer install
./vendor/bin/sail up -d
./vendor/bin/sail artisan k:g
and the open any REST API client and hit the api
http://localhost:7777/api/orders/place-order
you can change the port 7777 by add APP_PORT=7777 to you .env file or use the default one 80
To run the application test cases
./vendor/bin/sail test
- API request to create a new order.
- Validate the request payload.
- Check the product stock if available.
- Persist the order in the database with the items.
- Dispatch a background job to update the stock
- Fire an event to check the stock quantity.
- Send a notification from the event listener if the stock quantity reaches the limit (50%)
- 8 Test cases to test all the above.
