Integración de Flujos de Trabajo Git | GitScrum
Integra flujos Git con gestión de proyectos. Conecta commits, branches y PRs a tareas para trazabilidad completa en GitScrum.
5 min de lectura
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% │
└─────────────────────────────────────────────────┘