Visão geral

O Colibri SDK Go reúne componentes usados com frequência em APIs e microsserviços: servidor e cliente HTTP, PostgreSQL, Redis, mensageria, storage, validação, logging e OpenTelemetry.

Ele é opinativo sobre inicialização, configuração e contratos entre camadas, mas cada módulo é opcional. Você continua escrevendo Go e escolhe apenas os pacotes necessários para sua aplicação.

Quando usar

O SDK é adequado quando sua equipe precisa:

• manter configuração e observabilidade consistentes entre serviços;
• reduzir a repetição ao integrar HTTP, banco, cache e mensageria;
• executar o mesmo código em ambiente local e provedores de cloud;
• usar exemplos e convenções compartilhadas entre projetos.

Como uma aplicação é organizada

InitializeApp
    ├── configuração
    ├── logging e validação
    ├── observabilidade
    └── encerramento seguro
          ↓
    módulos opcionais
          ↓
    rotas e servidor

O SDK não gera regras de negócio e não exige uma arquitetura específica de pastas. O repositório de exemplos demonstra uma organização em domínio, casos de uso e infraestrutura.

Próximo passo

Se for sua primeira aplicação, confira os pré-requisitos e siga o guia Primeiros passos.

Para incorporar o SDK em um serviço existente, consulte Adicionar a um projeto existente.