This application is a simple parcel delivery application created to demonstrate Microservice Architecture Model using Spring Boot, Spring Cloud, Rabbitmq and Docker. The project is intended as a tutorial, but you can fork it and turn it into something else!
While designing the architecture, the CQRS pattern was applied. Data is divided into two as command and query. Rabbitmq is used for inter-service communication
- java 11
- Maven
- Spring Boot
- Spring Security with JWT Token
- Spring Cloud Gateway
- Rabbitmq
- Docker
- Swagger
- CQRS Pattern
We can think of this service as a frontend application. All interfaces are in this application. Some interfaces are defined more than once, as user stories are desired to be separated completely. For example, each user story has separate signin interfaces. Postman can also be used instead of application. Swagger was used to achieve this in the project.
Authorization responsibilities are extracted to a separate server, which grants JWT tokens for the backend resource services. Auth Server is used for user authorization as well as for secure service-to-service communication inside the perimeter.
Spring Cloud Gateway is a single entry point into the system, used to handle requests and routing them to the appropriate backend service
Parcel delivery order is created with this service. Likewise, if the parcel has not departed, updates can be made regarding the request. The service stores incoming requests in its own database. Apart from that, it throws events to Query and Shipment services.
It is the service that ensures the shipment of incoming requests. It stores the requests in its own database and notifies the Query service of the changes.
The Query service aggregates the data of the other two services. It corresponds to the query in the CQRS pattern and prepares the necessary queries for the application.
Users defined as ready in the application are specified in the table. Apart from these, users can define new user and admin can define new courier user.
| username | password | role |
|---|---|---|
| user@gmail.com | 12345678 | ROLE_USER |
| admin@gmail.com | 12345678 | ROLE_ADMIN |
| courier@gmail.com | 12345678 | ROLE_COURIER |
Parcel delivery application is accessed via http://localhost:8080/parcel-delivery
| Database | Host(in docker) | Host(in machine) | Port |
|---|---|---|---|
| orderdb | POSTGRES | localhost | 5432 |
| querydb | POSTGRES | localhost | 5432 |
| shipmentdb | POSTGRES | localhost | 5432 |
| authdb | POSTGRES | localhost | 5432 |
| Host(in docker) | Host(in machine) | Port |
|---|---|---|
| rabbitmq3 | localhost | 15672 |
The application can be run in 2 ways.
- The application is copied to the local machine. Postgres and rabbitmq are installed and run with the configurations defined above. Spring boot services are run.
- Run compose.yml with Docker (It may take up to 1 minute for the services to be ready).
docker compose up
After any of these steps, http://localhost:8080/parcel-delivery address is opened with the browser.
