Descripción General
La integración de Apollo con GitHub conecta tus repositorios de código con tu flujo de gestión de proyectos. Rastrea commits, pull requests y actividad de repositorios — todo vinculado a tareas y proyectos de Apollo.Configuración
Conectar Cuenta de GitHub
Navega a Project > Settings > GitHub y haz clic en Connect GitHub. Esto inicia un flujo OAuth para autorizar Apollo.
Seleccionar Repositorios
Después de la autorización, selecciona qué repositorios conectar a tu proyecto de Apollo.
Funcionalidades
Seguimiento de Commits
Todos los commits en repositorios conectados se rastrean y vinculan a tareas de Apollo usando cuatro métodos:| Método | Cómo Funciona | Ejemplo |
|---|---|---|
| Pattern | El mensaje del commit contiene el ID de la tarea | fix: resolve login bug TASK-42 |
| Branch | El nombre de la rama contiene el ID de la tarea | feature/TASK-42-login-fix |
| AI | Apollo Brain analiza el contenido del commit | La IA detecta la relevancia para la tarea según los cambios |
| Manual | Vincular explícitamente en el detalle de la tarea | Haz clic en “Link commit” en la pestaña GitHub de la tarea |
Panel de Pull Requests
Visualiza todos los pull requests abiertos en los repositorios conectados:- Estado — abierto, fusionado, cerrado
- Estado de revisión — aprobado, cambios solicitados, pendiente
- Verificaciones de CI — estado de aprobación/fallo
- Tareas vinculadas — qué tareas de Apollo están relacionadas con este PR
Actividad del Repositorio
Panel por repositorio que muestra:- Commits recientes y sus autores
- Pull requests abiertos
- Actividad de ramas
- Estadísticas de contribuidores
Análisis de Código con IA
Apollo Brain incluye herramientas de GitHub para operaciones inteligentes de código:- Analizar cambios del PR — la IA revisa el diff y resume qué cambió
- Sugerir revisores — recomienda miembros del equipo según la propiedad del código
- Verificar preparación para merge — verifica el estado de CI, aprobaciones de revisión y conflictos
- Crear revisiones de PR — la IA genera comentarios de revisión
Seguridad de Webhooks
Los webhooks usan verificación HMAC para garantizar que los eventos provienen genuinamente de GitHub. Cada payload de webhook se firma con un secreto compartido.Esquema de Base de Datos
La integración con GitHub utiliza 6 tablas en la base de datos para almacenar:- Repositorios conectados
- Historial de commits
- Metadatos de pull requests
- Vínculos entre tareas y commits/PRs
- Registros de eventos de webhooks
- Tokens OAuth