Na arquitetura hexagonal (ports & adapters), o núcleo da aplicação define ports (interfaces) e os adapters as implementam. Assim, o domínio fica isolado e a infraestrutura é desacoplada do core: o núcleo não conhece HTTP, SQL nem filas.
Como funciona
- Ports de entrada: os casos de uso que o mundo externo chama.
- Ports de saída: o que o núcleo precisa de fora, como um repositório ou o envio de e-mail.
- Adapters: um controller REST, uma implementação com Postgres, um dublê em memória para testes.
Exemplo
O caso de uso "criar pedido" depende de uma interface PedidoRepository. Em produção ela é implementada com banco de dados; nos testes, com uma versão em memória.
Limitações
Vale a pena quando há regra de negócio relevante. Em aplicações simples, as interfaces extras são custo sem muito retorno.
Relacionados: arquitetura hexagonal (visão resumida), Clean Architecture, anti-corruption layer.
DICA Explore o hub de conteúdo.