Repositórios

Como as responsabilidades da solução são distribuídas em múltiplos repositórios e por que essa separação pode ser útil.

Por que multi-repo?

Separar repositórios pode ajudar a:

  • isolar domínios
  • permitir deploys independentes
  • reduzir tamanho e ruído por repositório
  • dar ownership claro a cada equipe

Repositórios principais

globalsone-frontend

Contém a SPA e a experiência do usuário.

globalsone-api-gateway

Contém a configuração e o comportamento do gateway.

globalsone-bff

Contém a agregação, a transformação e os endpoints voltados ao frontend.

globalsone-ms-{domain}

Contêm a lógica de negócio de cada domínio.

globalsone-shared-kernel

Contém tipos ou contratos realmente compartilhados e estáveis.

Benefícios

  • Ownership mais claro
  • CI/CD independente
  • Menor impacto de mudanças locais
  • Melhor separação organizacional

Custos

  • Maior coordenação entre repos
  • Versionamento de pacotes compartilhados
  • Visibilidade distribuída
  • Maior disciplina de governança

Quando faz sentido

Faz mais sentido quando:

  • há vários domínios bem definidos
  • várias equipes trabalham em paralelo
  • os deploys precisam de independência real
  • a organização está preparada para governar contratos e padrões

Resumo

O multi-repo não é um objetivo em si mesmo. É uma estratégia de organização que pode trazer clareza e independência, desde que venha acompanhada de bons limites e boas regras de colaboração.