DDD + Arquitetura Hexagonal: A Dupla que Desacopla

Evento: PHP Conference Brasil 2025
Nessa palestra vou te mostrar como o DDD e a Arquitetura Hexagonal são o casamento perfeito.
Vem comigo!!

Transcript

1. DDD + Arquitetura Hexagonal A Dupla que Desacopla
2. Senta que lá vem história…
3. • Engenheiro de Software • Fundador • Coordenador da Comunidade • Palestrante e Escritor • Gamer nas horas vagas Igor Duarte
4. processai.adv.br
5. Problemas complexos exigem soluções contextualizadas Alerta
6. Um pouco de Conceitos
7. ➔ Arquitetura de Software Um pouco de Conceitos
8. ➔ Arquitetura de Software Um pouco de Conceitos
9. Um pouco de Conceitos ➔ Arquitetura de Software ➔ Design de Software
10. Um pouco de Conceitos ➔ Arquitetura de Software ➔ Design de Software ➔ Arquitetura x Design
11. Um pouco de Conceitos ➔ Arquitetura de Software ➔ Design de Software ➔ Arquitetura x Design • Arquitetura define a forma do sistema. • Design define os detalhes do código.
12. Um pouco de Conceitos ➔ Arquitetura de Software ➔ Design de Software ➔ Arquitetura x Design • Arquitetura define a forma do sistema. Hexagonal • Design define os detalhes do código. DDD
14. DDD em uma frase?!
15. DDD em uma frase?! “DDD é uma abordagem de desenvolvimento de software que coloca o domínio do negócio no centro, usando Linguagem Ubíqua.”
16. DDD em uma palavra?!
17. DDD em uma palavra?! DOMÍNIO
18. Arquitetura Hexagonal
19. Arquitetura Hexagonal em uma frase?!
20. Arquitetura Hexagonal em uma frase?! “Arquitetura Hexagonal é um estilo de organização de software que mantém o núcleo da aplicação isolado de detalhes técnicos”
21. Arquitetura Hexagonal em uma palavra?!
22. Arquitetura Hexagonal em uma palavra?! ISOLAMENTO
23. Linguagem Ubíqua “É a prática de construir uma linguagem comum e rigorosa entre desenvolvedores e usuários.” — Martin Fowler
24. Linguagem Ubíqua Contexto Jurídico ➔ Processo = processo judicial poderia ser entendido como algum fluxo ➔ Cliente = parte representada no processo poderia ser confundido como usuário do sistema ➔ Prazo = prazo processual do processo poderia ser qualquer prazo genérico ➔ Petição = documento formal enviado ao tribunal poderia ser um “file” ou qualquer arquivo .pdf ➔ Registro = número da OAB (registro dos advogados) poderia ser qualquer tipo de dado ou documento
25. Linguagem Ubíqua Contexto Jurídico / Traduções ➔ Processo = legal case ➔ Cliente = client ➔ Prazo = final due date ➔ Petição = petition ➔ Registro = lawyer registration lawyer = advogado*
26. Domínio > É o core do negócio
27. Domínio > É o core do negócio > Problema central
28. Domínio > É o core do negócio > Problema central > Regras de negócio
29. Domínio > É o core do negócio > Problema central > Regras de negócio > Onde nasce a linguagem Ubíqua
30. Bounded Context
31. Bounded Context > Deve representar um modelo conceitual coeso.
32. Bounded Context > Deve representar um modelo conceitual coeso. > Deve ter sua linguagem ubíqua própria.
33. Bounded Context > Deve representar um modelo conceitual coeso. > Deve ter sua linguagem ubíqua própria. > Deve resolver um problema específico do domínio.
34. Bounded Context “Cliente” no financeiro = pessoa que paga boleto. “Cliente” no jurídico = parte do processo. Mesma palavra, significados diferentes → contextos diferentes.
35. Bounded Context “Cliente” no financeiro = customer “Cliente” no jurídico = client contextos diferentes!!
36. Como garantir que o negócio não se perca dentro do código?
37. Como garantir que o negócio não se perca dentro do código? > Linguagem Ubíqua clara
38. Como garantir que o negócio não se perca dentro do código? > Linguagem Ubíqua clara > Bounded Context bem definidos
39. Como garantir que o negócio não se perca dentro do código? > Linguagem Ubíqua clara > Bounded Context bem definidos > Isolando de domínio
40. #showmethecode
42. Entidades
43. ➔ Entidade de Domínio ◆ Linguagem Ubíqua ◆ Representa um conceito do domínio ◆ Nada haver com banco de dados ◆ Pode ter algumas regras de negócio Entidades
44. ➔ Entidade de Domínio Contexto Jurídico LegalCase = Processo caseNumber = número do processo protocolDate = data do protocolo client = cliente finalDueDate = Prazo final de vencimento lawyer = advogado district = comarca forum = forum court = vara Entidades
45. ➔ Entidade Relacional ◆ Vulgo Model ou Entity ◆ Representa de tabela no banco ◆ Estrutura pensada no armazenamento de dados ◆ Não possui regras de negócio Entidades
46. ➔ Entidade Relacional Contexto Jurídico legal_case = Processo case_number = número do processo protocol_date = data do protocolo client = cliente final_due_date = Prazo final de vencimento lawyer = advogado district = comarca forum = forum court = vara parent_case = processo filho last_activity = última atividade Entidades
47. Mappers
48. Mappers ➔ Entidade de Domínio x Entidade Relacional LegalCase = legal_case caseNumber = case_number protocolDate = protocol_date client = client finalDueDate = final_due_date lawyer = lawyer district = district forum = forum court = court ??? = parent_case ??? = last_activity
49. ➔ DDD casa com Hexagonal, por conta da divisão de módulos x domínio Casamento Perfeito
50. Um pouco mais de arquitetura!!
52. "Don't over-engineer. Start simple, refactor when needed."
53. Referência s
54. linkedin.com/in/igorduartedev github.com/IgorDuarteDev speakerdeck.com/igorduarte www.processai.adv.br Onde me achar?
55. #junteseamanada