Integrazione con GitHub

Collega i repository, traccia commits e PR per attività e abilita l’analisi del codice con IA.

​

Panoramica

L’integrazione di Apollo con GitHub collega i tuoi repository di codice al tuo flusso di gestione dei progetti. Traccia commits, pull requests e attività dei repository — tutto collegato alle attività e ai progetti di Apollo.

​

Configurazione

1. Collegare l'Account GitHub

   Vai su Project > Settings > GitHub e clicca su Connect GitHub. Questo avvia un flusso OAuth per autorizzare Apollo.

2. Selezionare i Repository

   Dopo l’autorizzazione, seleziona quali repository collegare al tuo progetto Apollo.

3. Configurare i Webhooks

   Apollo configura automaticamente i webhooks sui repository collegati per ricevere eventi in tempo reale (commits, PRs, pushes).

​

Funzionalità

​

Tracciamento dei Commits

Tutti i commits nei repository collegati vengono tracciati e collegati alle attività di Apollo tramite quattro metodi:

Metodo	Come Funziona	Esempio
Pattern	Il messaggio del commit contiene l’ID dell’attività	fix: resolve login bug TASK-42
Branch	Il nome del branch contiene l’ID dell’attività	feature/TASK-42-login-fix
AI	Apollo Brain analizza il contenuto del commit	L’IA rileva la rilevanza per l’attività in base alle modifiche
Manual	Collegamento esplicito nel dettaglio dell’attività	Clicca “Link commit” nella scheda GitHub dell’attività

​

Dashboard dei Pull Request

Visualizza tutti i pull request aperti nei repository collegati:

• Stato — aperto, unito, chiuso
• Stato della revisione — approvato, modifiche richieste, in attesa
• Verifiche CI — stato di successo/fallimento
• Attività collegate — quali attività Apollo sono correlate a questo PR

​

Attività del Repository

Dashboard per repository che mostra:

• Commits recenti e i loro autori
• Pull request aperti
• Attività dei branch
• Statistiche dei contributori

​

Analisi del Codice con IA

Apollo Brain include strumenti GitHub per operazioni intelligenti sul codice:

• Analizzare le modifiche del PR — l’IA esamina il diff e riassume cosa è cambiato
• Suggerire revisori — raccomanda membri del team in base alla proprietà del codice
• Verificare la prontezza per il merge — controlla lo stato CI, le approvazioni delle revisioni e i conflitti
• Creare revisioni del PR — l’IA genera commenti di revisione

​

Sicurezza dei Webhooks

I webhooks utilizzano la verifica HMAC per garantire che gli eventi provengano realmente da GitHub. Ogni payload del webhook viene firmato con un segreto condiviso.

​

Schema del Database

L’integrazione con GitHub utilizza 6 tabelle nel database per archiviare:

• Repository collegati
• Cronologia dei commits
• Metadati dei pull request
• Collegamento tra attività e commits/PRs
• Log degli eventi webhook
• Token OAuth