8 min lectura • Guide 864 of 877
Vincular tareas a repositorios GitHub, GitLab y Bitbucket
Conectar tareas a repositorios de código elimina la brecha entre la gestión de proyectos y el trabajo real de desarrollo. Cuando commits, ramas y pull requests se vinculan directamente a tareas, los equipos obtienen visibilidad completa sobre qué cambios de código corresponden a qué requerimientos—sin más adivinanzas ni seguimiento manual.
Resumen de Integración Git
| Plataforma | Método de Conexión | Características |
|---|---|---|
| GitHub | OAuth + Webhook | Commits, PRs, ramas, issues |
| GitLab | OAuth + Webhook | Commits, MRs, ramas |
| Bitbucket | OAuth + Webhook | Commits, PRs, ramas |
Configurar Integración Git
CONECTAR TU REPOSITORIO
═══════════════════════
PASO 1: ACCEDER A CONFIGURACIÓN DE INTEGRACIONES
─────────────────────────────────────
GitScrum → Proyecto → Configuración → Integraciones
├── Seleccionar "GitHub" / "GitLab" / "Bitbucket"
├── Clic en "Conectar"
└── Autorizar acceso a GitScrum
PASO 2: SELECCIONAR REPOSITORIO
─────────────────────────────────────
Después de autorizar:
├── Aparece lista de repositorios
├── Seleccionar repositorio del proyecto
├── Configurar webhook automáticamente
└── Estado de conexión: "Conectado"
PASO 3: CONFIGURAR COMPORTAMIENTO
─────────────────────────────────────
Configuraciones opcionales:
├── Patrón de nombres de ramas
├── Formato de mensajes de commit
├── Plantilla de descripción de PR
└── Mover automático al fusionar
VERIFICACIÓN:
─────────────────────────────────────
┌─────────────────────────────────────┐
│ Integración GitHub │
│ ──────────────────────────────── │
│ Repositorio: acme/dashboard │
│ Estado: ✓ Conectado │
│ Última sincronización: hace 2 min │
│ │
│ [Desconectar] [Actualizar] [Config] │
└─────────────────────────────────────┘
Vincular Commits a Tareas
CONVENCIONES DE MENSAJES DE COMMIT
══════════════════════════════════
REFERENCIAR TAREA EN COMMIT:
─────────────────────────────────────
Incluir ID de tarea en mensaje de commit:
git commit -m "Agregar validación de pago #task-123"
git commit -m "Corregir error de login [GS-456]"
git commit -m "Implementar endpoint API (Task: 789)"
GitScrum automáticamente:
├── Detecta referencia de tarea
├── Vincula commit a tarea
├── Muestra commit en actividad de tarea
└── Actualiza línea de tiempo de tarea
COMMIT APARECE EN TAREA:
─────────────────────────────────────
┌─────────────────────────────────────────────────┐
│ Tarea: Implementar validación de pagos │
├─────────────────────────────────────────────────┤
│ ACTIVIDAD │
│ │
│ 🔀 Commit vinculado hace 2 min │
│ "Agregar validación de pago #task-123" │
│ por juan@acme.co │
│ → main (a4f2b1c) │
│ │
│ 💬 Comentario agregado hace 1 hora│
│ "Comenzando implementación ahora" │
│ │
└─────────────────────────────────────────────────┘
MEJORES PRÁCTICAS:
─────────────────────────────────────
✓ Siempre referenciar ID de tarea en commits
✓ Usar formato consistente en todo el equipo
✓ Incluir ID de tarea en primera línea
✓ Agregar contexto en cuerpo del commit
Nomenclatura de Ramas para Vinculación
CONVENCIONES DE NOMBRES DE RAMAS
════════════════════════════════
FORMATOS RECOMENDADOS:
─────────────────────────────────────
feature/task-123-validacion-pagos
bugfix/GS-456-error-login
hotfix/789-parche-seguridad-critico
Estructura:
├── tipo/ → feature, bugfix, hotfix
├── task-id → coincide con tarea GitScrum
└── descripcion → resumen legible
VINCULACIÓN AUTOMÁTICA DE RAMAS:
─────────────────────────────────────
Cuando la rama contiene ID de tarea:
├── GitScrum detecta creación de rama
├── Vincula rama a tarea
├── Muestra estado de rama en tarea
└── Rastrea ciclo de vida de rama
VISTA DE TAREA CON RAMA:
─────────────────────────────────────
┌─────────────────────────────────────────────────┐
│ Tarea: Validación de pagos │
├─────────────────────────────────────────────────┤
│ ESTADO │
│ ────── │
│ Columna: En Progreso │
│ Rama: feature/task-123-validacion-pagos │
│ ↳ 3 commits adelante de main │
│ PR: #42 (Abierto - Listo para revisión) │
│ │
└─────────────────────────────────────────────────┘
Integración de Pull Requests
VINCULAR PULL REQUESTS A TAREAS
═══════════════════════════════
PLANTILLA DE DESCRIPCIÓN DE PR:
─────────────────────────────────────
## Resumen
Implementa lógica de validación de pagos.
## Tarea Relacionada
Closes #task-123
## Cambios
- Agregado middleware de validación
- Actualizadas respuestas de API
- Agregadas pruebas unitarias
## Pruebas
- [x] Pruebas unitarias pasan
- [x] Pruebas manuales completas
DETECCIÓN DE GitScrum:
─────────────────────────────────────
Cuando se abre PR:
├── Detecta referencia de tarea
├── Vincula PR a tarea
├── Muestra estado de PR en tarea
└── Actualiza con cambios de PR
CICLO DE VIDA DE PR EN TAREA:
─────────────────────────────────────
┌─────────────────────────────────────┐
│ Pull Request #42 │
│ ────────────────── │
│ Estado: Abierto │
│ Revisiones: 1/2 aprobadas │
│ Checks: ✓ Todos pasando │
│ Fusionable: Sí │
│ │
│ [Ver en GitHub] │
└─────────────────────────────────────┘
Actualizaciones Automáticas de Tareas
AUTOMATIZAR FLUJO CON EVENTOS GIT
═════════════════════════════════
AUTOMATIZACIÓN DE COLUMNA: AL FUSIONAR PR
─────────────────────────────────────
Config. Proyecto → Tablero → Config. Columna → Done
Disparador de automatización:
├── Cuando: Pull Request fusionado
├── Acción: Mover tarea a esta columna
├── Adicional: Auto-archivar después de 7 días
Resultado:
├── Desarrollador fusiona PR
├── Tarea se mueve a Done automáticamente
├── No se necesita actualización manual
└── Estado del proyecto siempre preciso
FLUJO DE AUTOMATIZACIÓN:
─────────────────────────────────────
Desarrollador GitScrum
│ │
│ Crear rama │
│ feature/task-123-... │
├──────────────────────────►│ Rama vinculada
│ │
│ Push commits │
│ "Fix validación #123" │
├──────────────────────────►│ Commits vinculados
│ │
│ Abrir Pull Request │
│ │
├──────────────────────────►│ PR vinculado
│ │ Tarea → En Revisión
│ │
│ Fusionar PR │
│ │
├──────────────────────────►│ Tarea → Done
│ │ (automático)
│ │
Proyectos Multi-Repositorio
TRABAJAR CON MÚLTIPLES REPOS
════════════════════════════
ESCENARIO: FRONTEND + BACKEND
─────────────────────────────────────
Proyecto: Plataforma E-commerce
├── Repo 1: acme/frontend (React)
├── Repo 2: acme/backend (Node.js)
└── Repo 3: acme/mobile (React Native)
CONFIGURACIÓN:
─────────────────────────────────────
1. Conectar todos los repos al mismo proyecto
2. Usar referencias de tareas consistentes
3. Rastrear trabajo multi-repo en una sola tarea
TAREA CON MÚLTIPLES REPOS:
─────────────────────────────────────
┌─────────────────────────────────────────────────┐
│ Tarea: Implementar flujo de checkout │
├─────────────────────────────────────────────────┤
│ CÓDIGO VINCULADO │
│ │
│ acme/frontend │
│ ├── Rama: feature/task-123-checkout │
│ ├── Commits: 5 │
│ └── PR: #67 (Fusionado) │
│ │
│ acme/backend │
│ ├── Rama: feature/task-123-checkout-api │
│ ├── Commits: 8 │
│ └── PR: #45 (Abierto) │
│ │
└─────────────────────────────────────────────────┘
Visibilidad y Reportes
DATOS GIT EN REPORTES DE PROYECTO
═════════════════════════════════
MÉTRICAS A NIVEL DE TAREA:
─────────────────────────────────────
Para cada tarea:
├── Total de commits
├── Contribuidores
├── Líneas cambiadas (+/-)
├── Tiempo desde primer commit hasta fusión
└── Tiempo de respuesta de revisión
MÉTRICAS A NIVEL DE PROYECTO:
─────────────────────────────────────
En todo el proyecto:
├── Commits por sprint
├── PRs abiertos/fusionados/cerrados
├── Tiempo promedio para fusionar
├── Cambios de código por feature
└── Actividad de contribuidores
REPORTE DE SPRINT CON DATOS GIT:
─────────────────────────────────────
┌─────────────────────────────────────────────────┐
│ Sprint 24 - Actividad de Código │
├─────────────────────────────────────────────────┤
│ │
│ Commits: 127 │
│ Pull Requests: 18 (16 fusionados, 2 abiertos) │
│ Contribuidores: 5 │
│ Líneas Agregadas: 2,340 │
│ Líneas Eliminadas: 890 │
│ │
│ Revisión PR Prom: 4.2 horas │
│ Tiempo Fusión Prom: 6.8 horas │
│ │
└─────────────────────────────────────────────────┘
Pasos de Implementación en GitScrum
GUÍA COMPLETA DE CONFIGURACIÓN
══════════════════════════════
PASO 1: CONECTAR REPOSITORIO
─────────────────────────────────────
Config. Proyecto → Integraciones
├── Seleccionar proveedor (GitHub/GitLab/Bitbucket)
├── Autorizar OAuth
├── Seleccionar repositorio
└── Verificar conexión
PASO 2: CONFIGURAR CONVENCIONES DEL EQUIPO
─────────────────────────────────────
Acordar:
├── Nombres de ramas: tipo/task-id-descripcion
├── Formato de commit: "Mensaje #task-id"
├── Plantilla de PR con referencia a tarea
└── Documentar en wiki del proyecto
PASO 3: CONFIGURAR AUTOMATIZACIONES
─────────────────────────────────────
Config. Tablero → Automatizaciones de Columna
├── "En Revisión" → Cuando PR abierto
├── "Done" → Cuando PR fusionado
└── Habilitar notificaciones
PASO 4: CAPACITAR AL EQUIPO
─────────────────────────────────────
Compartir con desarrolladores:
├── Cómo referenciar tareas
├── Convenciones de nombres de ramas
├── Comportamiento esperado de automatización
└── Beneficios de vincular
PASO 5: MONITOREAR Y REFINAR
─────────────────────────────────────
Después de 1-2 sprints:
├── Verificar precisión de vinculación
├── Revisar disparadores de automatización
├── Recopilar feedback del equipo
└── Ajustar convenciones según sea necesario
Mejores Prácticas
- Nomenclatura consistente - Usar nombres estándar de ramas con IDs de tareas
- Referenciar en commits - Siempre incluir ID de tarea en mensajes de commit
- Plantillas de PR - Crear plantillas que soliciten referencia a tarea
- Automatizar transiciones - Configurar movimientos de columna en eventos de PR
- Conectar todos los repos - Vincular todos los repositorios del proyecto para visibilidad completa
- Capacitar al equipo - Asegurar que todos conozcan las convenciones
- Revisar regularmente - Verificar que la vinculación funcione como se espera
- Documentar convenciones - Almacenar estándares del equipo en NoteVault