DEV Community

Bendev Junior
Bendev Junior

Posted on AI-assisted

Uma transferência em Go com arquitetura hexagonal

Publiquei um mini tutorial guiado de arquitetura hexagonal em Go. Para mostrar como as fronteiras aparecem no código, montei uma pequena API de transferência e organizei a explicação em nove etapas.

Uma chamada a POST /transfers chega ao handler HTTP como JSON. O handler converte a entrada em uma chamada para o serviço da aplicação. O serviço busca as contas usando a porta AccountRepository. No domínio, Withdraw recusa valores menores ou iguais a zero e saldos insuficientes. Em seguida, Deposit soma o valor à conta de destino. O serviço pede ao repositório que grave as duas contas.

HTTP → handler → serviço de aplicação → domínio
                         ↓
                 porta AccountRepository
                         ↓
                 adaptador em memória
Enter fullscreen mode Exit fullscreen mode

O papel da porta e do adaptador

A aplicação conhece o contrato AccountRepository, que define Get e Save. O repositório em memória implementa esses métodos. Em Go, essa implementação é implícita: o tipo que possui os métodos com as assinaturas exigidas satisfaz a interface, sem declarar explicitamente que a implementa.

Essa direção ajuda a manter as regras do domínio independentes do protocolo HTTP e do armazenamento concreto. O handler traduz entrada e erros HTTP; o serviço coordena o caso de uso; o bootstrap escolhe as implementações e monta a aplicação. O router recebe handlers que registram as próprias rotas, enquanto /health é compartilhado pelo servidor.

O que o exemplo cobre

O projeto expõe GET /health e POST /transfers, com duas contas de demonstração. O adaptador protege o map com sync.RWMutex; Save valida as duas contas antes de atualizar o armazenamento. Essa proteção cobre o acesso ao map, mas a sequência completa de leitura, alteração e gravação não é uma transação. Os dados ficam em memória e desaparecem quando o processo termina. O exemplo também não tem banco de dados, autenticação ou regras de moeda.

A página do mini tutorial percorre as nove etapas, da introdução à arquitetura e ao mapa do projeto até a composição e inicialização da aplicação. Se quiser seguir cada parte, acesse:

https://bendevoficial.com/learning/aprendendo-hexagonal-em-go

O código está disponível em https://github.com/bendevjunior/hexagonal-architecture-go.

Se você acompanhar o exemplo, me conta se a separação entre aplicação, domínio e adaptadores ficou clara. Pode deixar dúvidas ou sugestões nos comentários. Quero conversar sobre arquitetura hexagonal e outros temas técnicos para os próximos conteúdos.

Top comments (0)