Clean Architecture em NodeJS [1] A apresentação discute os princípios da Clean Architecture e como aplicá-la em projetos NodeJS, incluindo a separação das camadas de domínio, casos de uso, interfaces e infraestrutura. [2] É explicado como mapear o contexto do domínio usando Context Mapping e como desenvolver uma linguagem ubíquita para melhor comunicação entre times. [3] Referências bibliográficas e artigos sobre arquitetura limpa, domain-driven design e padrões relacionados são fornecidos.

1. Clean Architecture em NodeJS

2. Rodrigo Souza
Software Engineer @ Sami
rasouza
rasouza
rasouza.com.br

3. 43
Agenda
Arquitetura
A Regra de
Dependência
2
Domínio App
1

4. Hexagonal Architecture
Alistair Cockburn (2005)
ANTES DO
CLEAN ARCHITECTURE
Onion Architecture
Jeffrey Palermo (2008)
DCI (Data, Context, Interaction)
James O. Coplien (2010)
Screaming Architecture
Robert C. Martin (2011)

5. "Uma boa arquitetura torna o sistema fácil de entender, desenvolver, manter e
implantar. O objetivo final é minimizar o custo da vida útil do sistema e maximizar
a produtividade do programador."
Robert C. Martin (Clean Architecture)

6. Clean Architecture
● Independente de Framework, UI, DB e agentes externos
● Testável
● SOLID

7. 21 43
Agenda
Arquitetura
A Regra de
Dependência
Domínio App

8. Source: https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html

9. Frameworks and Drivers
● Camada mais externa
● Pouco código (glue code)
● Detalhes (código de baixo risco)
● Express.js bootstrap, MongoDB connection,
IoC containers, etc.

10. infrastructure/config/bootstrap.js

11. infrastructure/config/bootstrap.js

12. infrastructure/database/schemas/User.js

13. Interface and Adapters
● Camada de tradução entre a infraestrutura e
as entidades e use cases
● Formato mais conveniente possível para os
clientes externos e internos
● Presenters, models, views, controllers, etc.

14. ports/http/routers.js

15. ports/http/UsersController.js

16. ports/http/errors.js

17. Use Cases
● Regra de negócio específica da aplicação
● Maior tempo de desenvolvimento desprendido
● Mudanças das camadas externas não afetam essa camada
(e vice-versa)
● Mudanças nos detalhes da operação modificam a camada

18. application/use_cases/ListUsers.js

19. application/use_cases/GetUser.js

20. application/use_cases/CreateUser.js

21. Entities
● Objetos relacionados ao negócio
● Menos propensos a mudar
● Core: geralmente é o diferencial da aplicação

22. domain/User.js

23. 21 43
Agenda
Arquitetura
A Regra de
Dependência
Domínio App

24. "Organizações que desenvolvem sistemas de software tendem a produzir
sistemas que são cópias das estruturas de comunicação dessas organizações."
Melvin E. Conway (Abril de 1968)

25. Source: https://medium.com/ingeniouslysimple/context-mapping-in-domain-driven-design-9063465d2eb8

26. Context Map
● Definição: uma ferramenta visual para identificar as
relações entre Bounded Contexts
● Compartilhar conhecimento (documentação)
● Features, clientes, eventos, dependências externas,
oportunidades de melhoria, etc.

27. Como modelar o meu Context Map?

28. Source: https://10consulting.com/2019/05/02/domain-driven-design-and-event-storming-workshop/

29. Source: https://thephp.cc/dates/2020/06/dutch-php-conference-online-edition/efficient-domain-driven-design-with-event-storming

30. Source: https://en.wikipedia.org/wiki/Event_storming

31. Source: https://tekaris.com/blog/introduction-ubiquitous-language/

32. Source: https://blog.carbonfive.com/ubiquitous-language-the-joy-of-naming/

33. Ubiquitous Language
● Definição: uma linguagem única universal compartilhada
pelo time, desenvolvedores, domain experts e stakeholders
● Expressada em termos do modelo de domínio
● Elimina contradições e ambiguidades
● Evolui com o tempo

34. 3 421
Agenda
Arquitetura
A Regra de
Dependência
Domínio App

35. Folder Structure

37. Bibliografia

38. https://github.com/rasouza/node-clean-architecture

39. Clean Architecture: A Craftsman's Guide
to Software Structure and Design
Robert C. Martin

40. Domain-Driven Design: Tackling
Complexity in the Heart of Software
Eric Evans

41. Domain-Driven Design Distilled
Vaughn Vernon

42. Design It!: From Programmer to Software
Architect
Michael Keeling

43. Artigos

44. Arquitetura
● Descomplicando a Clean Architecture - Luiza Labs
● DDD, Hexagonal, Onion, Clean, CQRS, … How I put it all
together - Herberto Graça
● The Clean Architecture - Robert C. Martin

45. Domain Driven Design
● Domain-driven design and event storming workshop - Binary
Consulting
● Developing the ubiquitous language - Felipe de Freitas Batista
● Context mapping in Domain Driven Design - Redgate

46. Muito
Obrigado!
We're hiring!