Guia de Projeto Go API

Use este guia para APIs Go onde baixa latência e uso previsível de recursos são prioridades.

Escopo de Arquitetura

• Middleware e handlers HTTP.
• Pacotes de serviço/domínio.
• Fronteiras de DB e clientes outbound.

Setup Recomendado

1. Inicialize SDK uma vez no startup do processo.
2. Instrumente middleware para tempo/status de requisição.
3. Adicione spans em DB/chamadas externas.
4. Flush gracioso em SIGTERM.

Contrato Mínimo de Dados

• service, env, version em eventos-chave.
• Correlation IDs propagados em handlers.
• Erros com contexto de operação.

Lista de Verificação

• Carga sintética emite telemetria estável.
• Handlers lentos aparecem claramente em spans.
• Shutdown faz flush da fila final.

Fortalecimento de Produção

1. Filas limitadas para evitar pressão de memória.
2. Monitoramento de erro de ingestão/retry.
3. Revalidação após mudança de router/middleware.

Solução de Problemas

• Dados ausentes sob carga: ajuste buffer/retry/backpressure.
• Spans ausentes: instrumente todas as fronteiras de I/O.
• Tags inconsistentes: aplique decorators/middleware compartilhados.