Integração com GitHub

Conecte repositórios, rastreie commits e PRs por tarefa e habilite análise de código com IA.

​

Visão Geral

A integração do Apollo com o GitHub conecta seus repositórios de código ao seu fluxo de gerenciamento de projetos. Rastreie commits, pull requests e atividade de repositórios — tudo vinculado a tarefas e projetos do Apollo.

​

Configuração

1. Conectar Conta do GitHub

   Navegue até Project > Settings > GitHub e clique em Connect GitHub. Isso inicia um fluxo OAuth para autorizar o Apollo.

2. Selecionar Repositórios

   Após a autorização, selecione quais repositórios conectar ao seu projeto no Apollo.

3. Configurar Webhooks

   O Apollo configura automaticamente webhooks nos repositórios conectados para receber eventos em tempo real (commits, PRs, pushes).

​

Funcionalidades

​

Rastreamento de Commits

Todos os commits em repositórios conectados são rastreados e vinculados a tarefas do Apollo usando quatro métodos:

Método	Como Funciona	Exemplo
Pattern	Mensagem de commit contém o ID da tarefa	fix: resolve login bug TASK-42
Branch	Nome da branch contém o ID da tarefa	feature/TASK-42-login-fix
AI	Apollo Brain analisa o conteúdo do commit	IA detecta relevância para a tarefa com base nas alterações
Manual	Vincular explicitamente no detalhe da tarefa	Clique em “Link commit” na aba GitHub da tarefa

​

Painel de Pull Requests

Visualize todos os pull requests abertos nos repositórios conectados:

• Status — aberto, mesclado, fechado
• Status da revisão — aprovado, alterações solicitadas, pendente
• Verificações de CI — status de aprovação/falha
• Tarefas vinculadas — quais tarefas do Apollo este PR está relacionado

​

Atividade do Repositório

Painel por repositório mostrando:

• Commits recentes e seus autores
• Pull requests abertos
• Atividade de branches
• Estatísticas de contribuidores

​

Análise de Código com IA

O Apollo Brain inclui ferramentas do GitHub para operações inteligentes de código:

• Analisar alterações do PR — IA revisa o diff e resume o que mudou
• Sugerir revisores — recomenda membros da equipe com base na propriedade do código
• Verificar prontidão para merge — verifica status de CI, aprovações de revisão e conflitos
• Criar revisões de PR — IA gera comentários de revisão

​

Segurança de Webhooks

Webhooks usam verificação HMAC para garantir que os eventos são genuinamente do GitHub. Cada payload de webhook é assinado com um segredo compartilhado.

​

Esquema do Banco de Dados

A integração com GitHub utiliza 6 tabelas no banco de dados para armazenar:

• Repositórios conectados
• Histórico de commits
• Metadados de pull requests
• Vínculos entre tarefas e commits/PRs
• Logs de eventos de webhooks
• Tokens OAuth