5 min lectura • Guide 488 of 877
Integración de GitHub para Gestión de Proyectos
GitHub es donde vive el código, pero las necesidades de gestión de proyectos se extienden más allá de las funciones del repositorio. La integración de GitHub de GitScrum conecta issues, pull requests y commits con tus tableros de proyecto, proporcionando visibilidad completa en actividades de desarrollo y gestión.
Beneficios de la Integración
| Herramientas Separadas | Flujo Integrado |
|---|---|
| Sincronización manual | Actualizaciones automáticas |
| Entrada de datos duplicada | Fuente única de verdad |
| Cambio de contexto | Vista unificada |
| Trazabilidad perdida | Pista de auditoría completa |
| Visibilidad retrasada | Estado en tiempo real |
Configurando la Integración de GitHub
PASOS DE CONFIGURACIÓN DE INTEGRACIÓN
1. CONECTAR CUENTA DE GITHUB
┌─────────────────────────────────────────────────┐
│ GitScrum → Configuración → Integraciones → │
│ GitHub │
│ │
│ • Autorizar app GitScrum │
│ • Seleccionar repositorios │
│ • Configurar permisos │
└─────────────────────────────────────────────────┘
2. MAPEAR REPOSITORIOS A PROYECTOS
┌─────────────────────────────────────────────────┐
│ Proyecto: App Móvil │
│ ├── frontend-mobile (repo GitHub) │
│ └── api-backend (repo GitHub) │
│ │
│ Toda actividad de estos repos → este proyecto │
└─────────────────────────────────────────────────┘
3. CONFIGURAR AUTOMATIZACIÓN
┌─────────────────────────────────────────────────┐
│ PR Abierto → Estado tarea: En Revisión │
│ PR Mergeado → Estado tarea: Hecho │
│ CI Fallido → Agregar etiqueta: necesita-fix │
└─────────────────────────────────────────────────┘
Integración del Flujo de Trabajo
FLUJO DE TRABAJO DEL DESARROLLADOR CON INTEGRACIÓN
┌─────────────────────────────────────────────────┐
│ GITSCRUM │
│ ┌──────────────────────────────────────────┐ │
│ │ Tarea: GS-123 │ │
│ │ "Agregar autenticación de usuario" │ │
│ │ │ │
│ │ Estado: En Revisión │ │
│ │ │ │
│ │ Timeline: │ │
│ │ ├── 9:00 AM Branch creado │ │
│ │ ├── 10:30 AM Commit: Agregar API login │ │
│ │ ├── 11:15 AM Commit: Agregar tests │ │
│ │ ├── 11:30 AM PR #42 abierto │ │
│ │ ├── 2:00 PM Review solicitado │ │
│ │ └── 3:30 PM Cambios solicitados │ │
│ │ │ │
│ │ PR Vinculado: #42 (esperando review) │ │
│ └──────────────────────────────────────────┘ │
│ ↕ │
│ SINCRONIZADO │
│ ↕ │
│ GITHUB │
│ ┌──────────────────────────────────────────┐ │
│ │ PR #42: GS-123 Autenticación usuario │ │
│ │ │ │
│ │ Descripción: │ │
│ │ Implementa flujo login según tarea GS-123│ │
│ │ [Enlace a tarea GitScrum] │ │
│ │ │ │
│ │ Estado: Review solicitado │ │
│ │ Checks: ✓ CI pasando │ │
│ └──────────────────────────────────────────┘ │
└─────────────────────────────────────────────────┘
Vinculación de Commits
VINCULACIÓN DE COMMIT A TAREA
FORMATO DE MENSAJE DE COMMIT:
┌─────────────────────────────────────────────────┐
│ GS-123: Agregar endpoint login de usuario │
│ │
│ - Implementar POST /api/auth/login │
│ - Agregar generación de token JWT │
│ - Incluir rate limiting │
│ │
│ Closes GS-123 │
└─────────────────────────────────────────────────┘
RESULTADO EN GITSCRUM:
┌─────────────────────────────────────────────────┐
│ Timeline Tarea GS-123: │
│ │
│ [Commit] abc1234 por @desarrollador │
│ "Agregar endpoint login de usuario" │
│ +145 líneas, -12 líneas │
│ 3 archivos cambiados │
└─────────────────────────────────────────────────┘
Flujo de Revisión de PR
FLUJO DE ESTADO DE PR
Estado PR GitHub → Estado Tarea GitScrum
───────────────────────────────────────────────
Draft → En Progreso
Ready for Review → En Revisión
Changes Requested → En Revisión (marcado)
Approved → Listo para Merge
Merged → Hecho
Closed (sin merge) → Por Hacer (devuelto)
VISIBILIDAD DE REVIEW:
┌─────────────────────────────────────────────────┐
│ Tarea: GS-123 │
│ │
│ Estado PR: Cambios Solicitados │
│ Revisor: @seniordev │
│ Comentario: "Falta manejo de errores edge case"│
│ │
│ Estado CI: ✓ Pasando │
│ Cobertura: 87% │
└─────────────────────────────────────────────────┘
Mejores Prácticas
- Usar IDs de tarea consistentemente en branches y PRs
- Configurar automatización de estado para reducir actualizaciones manuales
- Vincular repositorios a proyectos para contexto apropiado
- Habilitar templates de PR que incluyan enlaces a tareas
- Revisar contexto de tarea antes del code review
- Sincronizar solo eventos necesarios para evitar ruido
- Usar GitHub Actions con webhooks de GitScrum
- Archivar trabajo completado con historial Git completo
Anti-Patrones
✗ Usar GitHub Issues y GitScrum por separado
✗ Actualizaciones manuales cuando existe automatización
✗ PRs sin referencias a tareas
✗ Sin mapeo repositorio-a-proyecto
✗ Ignorar estado CI en vista de tarea
✗ Demasiadas sincronizaciones de notificaciones (ruido)