https://github.com/charlybutar21/clean-architecture

This project follows the Clean Architecture principles, ensuring a clear separation of concerns and maintainability
https://github.com/charlybutar21/clean-architecture

clean-architecture flywaydb kafka modulith restful-api spring-boot spring-jpa spring-mvc spring-validation unittest

Last synced: 6 months ago
JSON representation

This project follows the Clean Architecture principles, ensuring a clear separation of concerns and maintainability

• Host: GitHub
• URL: https://github.com/charlybutar21/clean-architecture
• Owner: charlybutar21
• Created: 2025-03-13T17:38:22.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2025-03-27T07:53:56.000Z (6 months ago)
• Last Synced: 2025-03-27T08:37:46.470Z (6 months ago)
• Topics: clean-architecture, flywaydb, kafka, modulith, restful-api, spring-boot, spring-jpa, spring-mvc, spring-validation, unittest
• Language: Java
• Homepage:
• Size: 526 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Clean Architecture

## Overview

This project follows the Clean Architecture principles, ensuring a clear separation of concerns and maintainability. It is built using Java 17 and Spring Boot 3.4.3, and integrates Kafka, MySQL, FlywayDB, JPA, ModelMapper, Lombok, Spring MVC, and Docker.

![img.png](assets/images/ca-flow.png)

## Technologies Used

- Java 17 & Spring Boot 3.4.3

- Golang 1.20

## Clean Architecture Layers

Clean Architecture organizes the project into four main layers, ensuring separation of concerns and flexibility:

![img.png](assets/images/ca-layer.png)

### 1. Enterprise Business Rules (Entities)

- This layer contains core business logic and domain entities.

- It is independent of any frameworks, databases, or external dependencies.

### 2. Application Business Rules (Use Cases)

- Contains application-specific business logic (e.g., services and use cases).

- Implements use case logic without being dependent on external frameworks.

### 3. Interface Adapters (Gateways, Controllers, and Presenters)

- Translates data between the application and external sources (APIs, databases, etc.).

- Contains Controllers (handling HTTP requests) and Gateways (handling data persistence).

### 4. Frameworks & Drivers (Infrastructure Layer)

- Implements framework-specific details such as database connections, messaging queues, and web frameworks.

- Includes Spring Boot, JPA, Kafka, Flyway, and Docker.

## Getting Started

### Prerequisites

- Install Java 17, Docker, and Docker Compose

- Golang 1.20

- Install MySQL 8.0 (or use Docker)

## Conclusion

This project applies Clean Architecture principles to create a modular, scalable, and maintainable application. It ensures flexibility and separation of concerns, making it easy to test, extend, and integrate with new technologies.

For contributions or inquiries, feel free to create a pull request or open an issue.