Tutorial apresenta API de transferências em Go com arquitetura hexagonal
Tutorial em Go acompanha uma transferência entre duas contas e explica a divisão da API em domínio, aplicação, adaptadores e HTTP.
Uma transferência acompanhada pelo código
Um mini tutorial guiado usa Go para mostrar como organizar uma API de transferência entre duas contas com arquitetura hexagonal. O fluxo começa com uma requisição POST /transfers: o handler HTTP lê o JSON e chama o serviço da aplicação com as contas de origem e destino e o valor a transferir.
O serviço busca as contas pela porta AccountRepository. No domínio, o método Withdraw valida o valor e verifica se há saldo suficiente; em seguida, Deposit atualiza a conta de destino. Ao final, o serviço solicita ao repositório que salve as duas contas, separando as regras do negócio dos detalhes de entrada e persistência.
Responsabilidades divididas em pacotes
O pacote domain contém Account, as regras de saldo e os erros de negócio. application coordena a transferência e depende da interface AccountRepository, enquanto adapters/persistence/memory implementa os métodos Get e Save usando um map como armazenamento.
O pacote entrypoints/httpapi recebe as requisições, chama o serviço e converte erros em respostas HTTP. Já bootstrap cria as implementações concretas e conecta as partes. A porta fica junto ao domínio porque descreve aquilo de que o caso de uso precisa para buscar e salvar contas.
Montagem e entrada HTTP
A implementação em memória satisfaz a interface por implementação implícita de Go. No bootstrap, cada handler registra as rotas do próprio módulo com RouteRegister, enquanto o router acrescenta o endpoint compartilhado /health. O exemplo oferece GET /health e POST /transfers.
O tutorial também apresenta platform/httpserver, responsável pela leitura e escrita de JSON, pela verificação de integridade e pela configuração HTTP. As contas a e b começam com valores de demonstração, e o map usa sync.RWMutex para permitir acesso concorrente.
Limites do exemplo
O método Save verifica a existência das duas contas antes de atualizar o map, mas a sequência completa da transferência não é uma transação. Portanto, a demonstração não garante que o saque e o depósito ocorram como uma única operação indivisível.
Os saldos ficam em memória e voltam ao estado inicial quando o processo reinicia. A implementação não inclui banco de dados, autenticação nem regras de moeda e se concentra na organização das responsabilidades da API.
Um roteiro de estudo
O mini tutorial divide o percurso em nove etapas, desde a apresentação da arquitetura e a leitura do mapa do projeto até a montagem e a inicialização da aplicação. Em cada etapa, explica as decisões de organização e os recursos de Go empregados.
O leitor acompanha como uma requisição passa da camada HTTP ao caso de uso, chega às regras do domínio e retorna ao adaptador de persistência. O tutorial completo detalha as decisões de arquitetura e os recursos de Go usados em cada passo.
Informações deste conteúdo
Tecnologias: API, Go, HTTP, JSON
Carreiras: Gerente de Arquitetura de Soluções
Idiomas: Português
Tags: api, arquiteturahexagonal, concorrencia, go, persistenciaemmemoria, transferenciaentreduascontas