Portas descrevem a conversa; adaptadores traduzem
No exemplo de matrícula, uma porta de entrada pode ser MatricularAluno, chamada por uma API HTTP ou por um comando de linha. Uma porta de saída, como RepositorioDeMatriculas, expressa o que o caso de uso precisa para persistir. Um adaptador PostgreSQL implementa esse contrato; um endpoint traduz HTTP para os tipos da aplicação.
Abrir diagrama em tamanho original
A forma hexagonal não significa que o sistema terá seis partes. O hexágono apenas ajuda a mostrar a aplicação ao centro e as conversas que ela aceita. Cada porta precisa ter um motivo concreto: proteger regras do framework, suportar outro canal ou permitir trocar um serviço externo.
Clean Architecture enfatiza camadas e a regra de dependência. Ports and Adapters enfatiza a aplicação isolada por contratos e adaptadores. São ideias compatíveis, com vocabulários diferentes; não precisam virar dois conjuntos de camadas.
Vídeo previsto para 22/10/2026. O material escrito fica disponível enquanto a gravação é preparada para publicação.
Recupere: qual adaptador traduz a entrada HTTP e qual porta o caso de uso usa para persistir?
Pratique com /aprender
/aprender Modele uma aplicação de matrículas com uma entrada HTTP e uma porta de saída para persistência. Peça que eu identifique contratos, adaptadores e direção de dependência. Depois troque o PostgreSQL por armazenamento em memória e discuta o que muda.