Pular para o conteúdo principal

Integração com GitHub

Conecte seus repositórios do GitHub para análise automática.

Recursos​

  • Indexação automática ao fazer push para o branch principal
  • Análise de pull requests com feedback de arquitetura
  • Notificações webhook para resultados de análise

Configuração​

Passo 1: Conectar GitHub​

  1. Acesse ArchiCore
  2. Clique em Adicionar Projeto → aba GitHub
  3. Clique em Conectar com GitHub
  4. Autorize o ArchiCore a acessar seus repositórios

Passo 2: Selecionar Repositório​

  1. Pesquise seu repositório
  2. Selecione um branch (geralmente main ou master)
  3. Ative as opções:
    • Auto-análise no push - Indexar a cada push
    • Analisar pull requests - Comentar em PRs

Passo 3: Configurar (Opcional)​

Crie .archicore/config.json no seu repositório:

{
  "github": {
    "autoIndex": true,
    "analyzePRs": true,
    "branches": ["main", "develop"]
  }
}

Análise de Pull Requests​

Quando ativado, o ArchiCore comenta em PRs com:

  • Impacto na arquitetura - Arquivos afetados por mudanças
  • Mudanças de complexidade - Se a complexidade aumentou
  • Alertas de segurança - Novas vulnerabilidades introduzidas
  • Melhores práticas - Sugestões de melhoria

Permissões Necessárias​

PermissãoMotivo
Ler códigoPara analisar seu código
Ler PRsPara analisar pull requests
Escrever comentários em PRPara postar resultados
WebhooksPara receber notificações de push

Desconectar​

Para desconectar o GitHub:

  1. Vá para Configurações → Contas Conectadas
  2. Clique em Desconectar ao lado do GitHub

Solução de Problemas​

"Repositório não encontrado"​

  • Certifique-se de que o repositório não é privado, ou
  • Reautorize o ArchiCore com acesso a repos privados

"Webhook não dispara"​

  1. Vá para GitHub → Repositório → Configurações → Webhooks
  2. Verifique o status do webhook do ArchiCore
  3. Procure por entregas falhas