Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/arivan-amin/clean-architecture-microservices
This project is designed to exercise and showcase how a Microservices Back-End can be built using Clean Architecture and several other best practices.
https://github.com/arivan-amin/clean-architecture-microservices
api api-gateway eureka flyway grafana healthcare java junit kafka loki lombok microservices mockito mongodb mysql prometheus spring-cloud swagger-ui tempo
Last synced: about 4 hours ago
JSON representation
This project is designed to exercise and showcase how a Microservices Back-End can be built using Clean Architecture and several other best practices.
- Host: GitHub
- URL: https://github.com/arivan-amin/clean-architecture-microservices
- Owner: arivan-amin
- License: mit
- Created: 2024-08-07T18:41:18.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2025-01-27T20:04:52.000Z (7 days ago)
- Last Synced: 2025-01-27T21:22:16.626Z (7 days ago)
- Topics: api, api-gateway, eureka, flyway, grafana, healthcare, java, junit, kafka, loki, lombok, microservices, mockito, mongodb, mysql, prometheus, spring-cloud, swagger-ui, tempo
- Language: Java
- Homepage:
- Size: 4.14 MB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Audit: Audit-Service/pom.xml
- Security: SECURITY.md
Awesome Lists containing this project
README
# Clean Architecture Microservices
## Overview
This project is a **Sample Healthcare System** developed as a **Microservices**
using **Java** and **Clean Architecture**.
It serves as a practice project to demonstrate the implementation of microservices using
modern **Java** and **Spring Boot** and follow some of the best practices in development.
---
## Quick Info
## Notable Features
- **Automatic Audit Logs Recording**: Uses Spring **AOP** to create Audit Events automatically
whenever any API in any of the services are called and uses **Kafka** to send them to the **Audit
Service** to be recorded, allowing the controllers to be clutter-free and simple.
- **Clean and concise Restful API in all services**: the API follows the modern best practices in
Restful services recommendations like using **ResponseEntity** and returning **ProblemDetails**.
- **CQRS**: Command and Query Separation Principle to implement Business logic.
- **ArchUnit**: to validate architectural boundaries and verify adherence to best coding standards
- **@RestControllerAdvice**: to handle specific exceptions and return a unified and standard error
response instead of an exception stack trace using Spring **ProblemDetail**.
- **OpenAPI and Swagger Docs**: to provide detailed documentation for all endpoints.
- **Entity and DTO separation**: decouples core business logic from presentation using request and
response pojo.
- **Core Entity and Jpa separation**: core entities have no association with JPA and are never
annotated with @Entity.
- Rate limiting in the API Gateway using redis rate limiter
## Sample audit log from Audit-Service captured from API calls in Patient-Service
```
// Create Patient Endpoint
{
"id": "6797e0215829937787277607",
"serviceName": "patient-service",
"location": "/patients/protected/v1/accounts",
"action": "Create",
"data": "CreatePatientRequest(firstName=Hayden, lastName=Ondricka, [email protected], dateOfBirth=977659882000, gender=MALE, address=Bernhard Cape)",
"creationDate": "2025-01-27T14:36:01.528",
"duration": "50ms",
"response": "CreatePatientResponse(id=9622e5ef-5ab7-4faf-89db-7dd970ea8ef0)"
}
// Delete Patient Endpoint
{
"id": "6797e0115829937787277605",
"serviceName": "patient-service",
"location": "/patients/protected/v1/accounts/{id}",
"action": "Delete",
"data": "e8cd23d1-4bad-44bb-9b58-a3ca89dbf793",
"creationDate": "2025-01-27T14:35:45.631",
"duration": "25ms",
"response": "Void"
},
// Read Patient by ID Endpoint
{
"id": "6797e0145829937787277606",
"serviceName": "patient-service",
"location": "/patients/protected/v1/accounts/{id}",
"action": "Read",
"data": "e8cd23d1-4bad-44bb-9b58-a3ca89dbf793",
"creationDate": "2025-01-27T14:35:48.66",
"duration": "14ms",
"response": "Error: Patient by the requested id not found"
}
```
## 🛠️ Architecture concepts demonstrated and implemented
- **Microservices**
- **Clean Architecture**
- **Clean Code**
- **Command-Query Responsibility Separation**
- **Solid Principles**
- **Loose Coupling of Components**
- **Spring Dependency Injection**
- **Aspect-Oriented Programming (AOP)**
- **Rate Limiting API**
---
## 🛠️ Technical Features Implemented
- **Microservices Architecture**.
- **Automatic Audit Logs recording**: Uses Spring AOP to automatically store audit logs.
- **Robust Monitoring**: Real-time monitoring with Grafana, Loki, and Tempo.
- **Event-Driven Communication**: Using Kafka.
- **Centralized Logging & Tracing**: Using Logback and Tempo.
- **Database Migrations**: Using Liquibase.
- **Dockerized Deployment**: Using Docker and Docker Compose.
---
### Currently, the following services are implemented, other services will be added:
- Discovery Server
- API Gateway
- Patient Service
- Audit Service
---
## Technologies used and their responsibility
- **Java 21**
- **Spring Boot**
- **Spring Cloud**
- **Eureka**: Dynamic service registry.
- **MySQL**: Services data storage.
- **MongoDB**: Storage for Audit logs.
- **Kafka**: Event streaming for microservices.
- **Docker**
- **Grafana, Loki, Tempo**: Observability stack for metrics, logging, and tracing.
- **JUnit & Mockito**: Unit testing and Mocking.
- **Swagger/OpenAPI**: API documentation.
- **Liquibase**: Database Migrations.
- **Lombok**: Cleaner code with reduced boilerplate.
---
## Grafana Monitoring Sample
## 🚀 Installation Guide
### Prerequisites
- **Java 21**
- **Maven**
- **Docker** & **Docker Compose**
---
### Steps to Get Started
1. **Clone the Repository:**
```bash
git clone https://github.com/arivan-amin/Healthcare-Clean-Microservices.git
cd Healthcare-Clean-Microservices
```
2. **Build Core Module:**
```bash
cd Core
mvn clean install
cd ..
```
3. **Build and Package the Project:**
```bash
mvn clean package
```
4. **Set Environment Variables (Linux/MacOS):**
```bash
export EUREKA_USER=admin
export EUREKA_PASSWORD=admin
```
```
*(For Windows, use `set` command)*
```
5. **Run Services with Docker Compose:**
```bash
docker compose up -d
```
6. **Access the Services:**
- **API Gateway:** [http://localhost:8080](http://localhost:8080)
- **Eureka Dashboard:** [http://localhost:8080/eureka/web](http://localhost:8080/eureka/web)
- **Swagger UI:** [http://localhost:8080/swagger-ui.html](http://localhost:8080/swagger-ui.html)
- **Grafana Dashboard:** [http://localhost:3000/dashboards](http://localhost:3000/dashboards)
7. **Grafana Dashboard Setup:**
- Import pre-built dashboard JSON configuration from `docker/grafana/` folder.
---
## 🧪 Testing
- **Run Unit and Integration Tests:**
```bash
mvn test
```
---
## ⚙️ Microservices Overview
- **Discovery Server**: Dynamic service discovery and registry.
- **API Gateway**: Centralized entry point for routing and security.
- **Core Module**: Shared utilities and functionality.
- **Patient Service**: Manages patient data.
- **Audit Service**: Logs events and ensures compliance.
---
## 🤝 Contributing
We welcome contributions! Fork the repository, create a new branch, and submit a pull request.
---
## 📜 License
This project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for more
details.
---
## 📧 Contact
For questions or inquiries:
- **Name:** Arivan Amin
- **Email:** [[email protected]](mailto:[email protected])