https://github.com/felipexw/clean-arch-ddd-intro
Just a simple implementation of DDD + clean architecture pattern. It also contains the exaplanation about the concepts that supports this implementation.
https://github.com/felipexw/clean-arch-ddd-intro
clean-architecture clean-code ddd ddd-architecture ddd-example ddd-patterns ddd-sample domain-driven-design hexagonal-architecture java micronaut micronaut-java-application
Last synced: 7 months ago
JSON representation
Just a simple implementation of DDD + clean architecture pattern. It also contains the exaplanation about the concepts that supports this implementation.
- Host: GitHub
- URL: https://github.com/felipexw/clean-arch-ddd-intro
- Owner: felipexw
- Created: 2021-04-21T00:14:35.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2021-04-26T23:06:49.000Z (about 5 years ago)
- Last Synced: 2024-05-07T02:33:00.192Z (about 2 years ago)
- Topics: clean-architecture, clean-code, ddd, ddd-architecture, ddd-example, ddd-patterns, ddd-sample, domain-driven-design, hexagonal-architecture, java, micronaut, micronaut-java-application
- Language: Java
- Homepage:
- Size: 555 KB
- Stars: 16
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-ddd - https://github.com/felipexw/clean-arch-ddd-intro - Simple DDD + Clean Architecture using Micronaut. (Sample Projects / JVM languages)
README
# Clean Architecture with Domain Driven Design (DDD)
O objetivo desse projeto é apresentar, de forma didática, alguns dos principais conceitos de Clean Architecture, juntamente com Domain-Driven Design (DDD) com Micronaut.
## Problema
Esse problema veio de origem do curso [Java e Domain Driven Design: Apresentando os conceitos](https://www.alura.com.br/curso-online-java-domain-driven-design-conceitos), com algumas modificações.
### Enunciado
Imagine um software em um contexto acadêmico, onde será necessário **matricular alunos** e **indicar alunos**.
- **indicar alunos**: quando um aluno indica uma pessoa como possível aluno (que não está matriculada, evidentemente), o aluno que indicou acaba recebendo alguma pontuação para isso. Com uma determinada pontuação acumulada, ele pode trocar os pontos por algum curso, ou algo do semelhante. A pessoa indicada recebe um e-mail contendo as informações para se matricular na próxima turma, bem como um determinado desconto na taxa da matrícula.
- **matricular alunos**: ao matricular um novo aluno em um curso, deve ser considerado se o que mesmo não foi indicado. Em caso positivo, o mesmo deverá receber um desconto na matricula. Do contrário, é o valor integral.
## Entendendo e aplicando os conceitos DDD
Alguns conceitos são necessários para melhor entendimento do desenho da solução. São eles:
- **Use cases/commands/queries/actions**: Representam as features identificadas na modelagem.
- **Entities**: Tudo aquilo que pode ser identificado por alguma propriedade única (ex: pessoa é uma entidade, pois todas possuem um CPF - cadastro de pessoa física).
- **Value objects**: São classes que não possuem identidade, porém possuem alguma lógica de funcionamento (ex: uma classe `Address`)
- **Domain events**: São eventos que são disparados ao executar um caso de uso (ex: `StudentRegistered`).
- **Bounded contexts**: São contextos que delimitam o espaço de um problema.
- **Event storming**: Eventos em que atores, casos de etc, agregados, contextos, etc. são identificados. Evento importante para que os os devs e o pessoal de negócio definam um linguagem única (ubíqua) para utilização durante o desenvolvimento.
- **Business invariantes**: são regras de negócio.
- **Actors**: são aqueles que interagem diretamente com os casos de uso (ex: `Student`).
## Clean architecture
## Estrutura do projeto
A estrutura do projeto ficou da seguinte maneira:
```
/academic
/application
/domain
/infrastructure
/email
/application
/domain
/infrastructure
/gamefification
/application
/domain
/infrastructure
/shared
/application
/domain
/infrastructure
```
O primeiro nível representa o domínio, ou seja, foram identificados 4 domínios: academic (acadêmico), email, gamification (pontuação), shared (compartilhado). Em cada domínio, há basicamente 3 pacotes:
- *application*: lógica de aplicação (ex: `StudentController` do Micronaut). E a camada de **entrada/saída com o mundo externo**.
- *domain*: **toda a lógica de negócio** e casos de usos (também conhecidos como `commands`e `queries` dentro do DDD, ou `actions`).
- *infrastructure*: camada de infraestrutura que **dá suporte para a camada de domínio** (ex: implementação concreta de algum repositório ou alguma classe que tenha dependência com algum framework ou algo do gênero).
### References
- [Clean Architecture by Uncle Bob](https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html)
- [Domain-Driven Design: Tackling Complexity in the Heart of Software](https://www.amazon.com.br/Domain-Driven-Design-Tackling-Complexity-Software/dp/0321125215)
- [Java e Clean Architecture: Descomplicando arquitetura de software](https://www.alura.com.br/curso-online-java-clean-architecture)
- [Java e Domain Driven Design: Apresentando os conceitos](https://www.alura.com.br/curso-online-java-domain-driven-design-conceitos)