5 min lectura • Guide 486 of 877
Integración de Flujos de Trabajo Git
Conectar la actividad de Git con la gestión de proyectos crea trazabilidad completa desde requisitos hasta código. La integración nativa de Git de GitScrum vincula automáticamente commits, branches y pull requests a tareas, proporcionando visibilidad en tiempo real del progreso de desarrollo sin actualizaciones manuales de estado.
Beneficios de Integración Git
| Sin Integración | Con Integración |
|---|---|
| Actualizaciones manuales de estado | Automático desde actividad Git |
| Sin trazabilidad | Commits vinculados a tareas |
| Cambio de contexto | Fuente única de verdad |
| Entrada de datos duplicada | Sincronizado automáticamente |
| Review sin contexto | PR muestra tarea relacionada |
Flujo de Trabajo Git con GitScrum
FLUJO DE DESARROLLO INTEGRADO
1. TOMAR TAREA
┌─────────────────────────────────────────────────┐
│ Desarrollador se asigna tarea GS-456 │
│ Tarea: "Agregar autenticación de usuario" │
│ Estado: Por Hacer → En Progreso │
└─────────────────────────────────────────────────┘
│
▼
2. CREAR BRANCH
┌─────────────────────────────────────────────────┐
│ git checkout -b feature/GS-456-user-auth │
│ │
│ GitScrum detecta: Branch vinculado a GS-456 │
│ Estado: Actualizado automáticamente │
└─────────────────────────────────────────────────┘
│
▼
3. COMMIT CON REFERENCIA
┌─────────────────────────────────────────────────┐
│ git commit -m "GS-456: Agregar endpoint login" │
│ git commit -m "GS-456: Agregar middleware" │
│ │
│ GitScrum: Commits aparecen en timeline tarea │
└─────────────────────────────────────────────────┘
│
▼
4. ABRIR PULL REQUEST
┌─────────────────────────────────────────────────┐
│ Título PR: "GS-456: Autenticación usuario" │
│ Descripción: Vincula a tarea automáticamente │
│ │
│ GitScrum: PR vinculado, estado → En Revisión │
└─────────────────────────────────────────────────┘
│
▼
5. MERGE Y COMPLETAR
┌─────────────────────────────────────────────────┐
│ PR mergeado a main │
│ │
│ GitScrum: Estado → Hecho │
│ Historial completo preservado │
└─────────────────────────────────────────────────┘
Convenciones de Nombres de Branch
PATRONES DE NOMBRES DE BRANCH
FORMATO: <tipo>/<id-tarea>-<descripcion-corta>
EJEMPLOS:
┌─────────────────────────────────────────────────┐
│ feature/GS-123-autenticacion-usuario │
│ bugfix/GS-456-corregir-error-login │
│ hotfix/GS-789-parche-seguridad │
│ refactor/GS-101-limpiar-api │
└─────────────────────────────────────────────────┘
PREFIJOS DE TIPO:
• feature/ - Nuevas funcionalidades
• bugfix/ - Corrección de bugs
• hotfix/ - Emergencia producción
• refactor/ - Mejora de código
• docs/ - Documentación
• test/ - Adición de tests
Formato de Mensajes de Commit
CONVENTIONAL COMMITS CON ID DE TAREA
FORMATO:
<id-tarea>: <tipo>: <descripción>
EJEMPLOS:
┌─────────────────────────────────────────────────┐
│ GS-123: feat: agregar endpoint registro │
│ GS-123: test: agregar tests de registro │
│ GS-456: fix: resolver null pointer en login │
│ GS-789: docs: actualizar documentación API │
└─────────────────────────────────────────────────┘
TIPOS:
• feat - Nueva funcionalidad
• fix - Corrección de bug
• docs - Documentación
• style - Formateo
• refactor - Reestructuración
• test - Tests
• chore - Mantenimiento
Configuración de Automatización
REGLAS DE AUTOMATIZACIÓN
BRANCH CREADO → EN PROGRESO
┌─────────────────────────────────────────────────┐
│ Trigger: Branch creado con patrón GS-XXX │
│ Acción: Mover tarea a "En Progreso" │
│ Acción: Asignar creador del branch │
└─────────────────────────────────────────────────┘
PR ABIERTO → EN REVISIÓN
┌─────────────────────────────────────────────────┐
│ Trigger: PR abierto mencionando GS-XXX │
│ Acción: Mover tarea a "En Revisión" │
│ Acción: Vincular PR a tarea │
│ Acción: Notificar revisores │
└─────────────────────────────────────────────────┘
PR MERGEADO → HECHO
┌─────────────────────────────────────────────────┐
│ Trigger: PR mergeado │
│ Acción: Mover tarea a "Hecho" │
│ Acción: Registrar tiempo de ciclo │
│ Acción: Actualizar métricas │
└─────────────────────────────────────────────────┘
Vista Unificada de Tarea
TAREA CON ACTIVIDAD GIT
┌─────────────────────────────────────────────────┐
│ GS-456: Autenticación de Usuario │
│ Estado: En Revisión │
│ Asignado: @desarrollador │
├─────────────────────────────────────────────────┤
│ │
│ ACTIVIDAD GIT: │
│ ───────────────────────────────────────────── │
│ │
│ Hoy │
│ ├── 10:30 PR #42 abierto │
│ │ "GS-456: Auth usuario" │
│ │ Revisores: @senior, @lead │
│ │ │
│ ├── 10:15 Commit pushed │
│ │ "GS-456: Agregar middleware" │
│ │ +85 líneas, -12 líneas │
│ │ │
│ └── 09:00 Commit pushed │
│ "GS-456: Agregar endpoint login" │
│ +145 líneas │
│ │
│ Ayer │
│ └── 14:00 Branch creado │
│ feature/GS-456-user-auth │
│ │
│ PR: #42 (En revisión) │
│ CI: ✓ Pasando │
│ Cobertura: 87% │
└─────────────────────────────────────────────────┘
Mejores Prácticas
- Siempre incluir ID de tarea en branches y commits
- Configurar automatización para reducir actualizaciones manuales
- Usar prefijos consistentes en nombres de branch
- Mensajes de commit descriptivos para contexto
- Revisar tarea antes del code review para contexto completo
- Mantener PRs pequeños para revisiones más rápidas