Integración Git Desconectada de la Gestión de Proyectos

Cuando los repositorios Git y la gestión de proyectos viven en mundos separados, los equipos pierden visibilidad sobre qué código soporta qué tareas. GitScrum se integra con GitHub, GitLab y Bitbucket para conectar commits, branches y pull requests.

El Problema de la Desconexión

Git separado de la gestión de proyectos crea fricción:

• Actualizaciones manuales — Marcar tareas completas después de merges
• Contexto perdido — Sin visibilidad de qué commits soportan qué tareas
• Esfuerzo duplicado — Escribir descripciones de PR y actualizaciones de tareas
• Brechas de auditoría — Rastrear features a requisitos originales
• Sobrecarga de reportes — Correlacionar manualmente código y progreso

Integraciones Git de GitScrum

Conecta tus repositorios a GitScrum:

Plataformas Soportadas

Qué Se Conecta

• Commits vinculados a tareas vía ID de tarea en mensaje de commit
• Branches rastreados por tarea
• Pull/Merge Requests visibles en timeline de tarea
• Cambios de estado reflejados automáticamente

Configurando Integración Git

Setup de GitHub

1. Ir a Configuración del Proyecto → Integraciones
2. Seleccionar GitHub
3. Autenticar con OAuth
4. Seleccionar repositorios a conectar
5. Configurar opciones de sync

Setup de GitLab

1. Ir a Configuración del Proyecto → Integraciones
2. Seleccionar GitLab
3. Ingresar token de acceso personal
4. Seleccionar proyectos a conectar
5. Configurar notificaciones webhook

Setup de Bitbucket

1. Ir a Configuración del Proyecto → Integraciones
2. Seleccionar Bitbucket
3. Autenticar con OAuth
4. Seleccionar repositorios a conectar
5. Configurar opciones de sync

Vinculando Commits a Tareas

Usa IDs de tarea en mensajes de commit para vincular:

Formato de Mensaje de Commit

git commit -m "Add user authentication [GS-234]"

Formatos Alternativos

# Forma corta
git commit -m "Fix login bug #234"

# Con descripción
git commit -m "Implement OAuth flow

Adds Google OAuth support for user authentication.
Closes GS-234"

# Múltiples tareas
git commit -m "Refactor auth module [GS-234] [GS-235]"

Qué Aparece en GitScrum

Tarea #234: Implementar login OAuth
├── Estado: En Progreso
├── Actividad Git:
│   ├── Commit abc123: "Add user authentication [GS-234]"
│   ├── Branch: feature/oauth-login
│   └── PR #45: "OAuth Implementation" (Abierto)
└── Última actualización: hace 5 minutos

Tracking de Branches

GitScrum rastrea branches asociados a tareas:

Convención de Nombres de Branch

feature/GS-234-oauth-login
bugfix/GS-456-login-error
hotfix/GS-789-security-patch

Visibilidad de Branch

• Ver branches activos por tarea
• Rastrear estado del branch (abierto, merged, eliminado)
• Ver historial de branch en timeline de tarea

Integración de Pull Requests

Visibilidad de PRs en Tareas

Cuando los PRs referencian IDs de tarea:

Tarea #234: Implementar login OAuth
├── Pull Requests:
│   └── #45: "OAuth Implementation"
│       ├── Estado: Abierto
│       ├── Autor: @developer
│       ├── Revisores: @senior-dev
│       ├── Checks: ✓ Todos pasando
│       └── Comentarios: 3

Actualizaciones Automáticas de Estado

Configura auto-transiciones:

• PR abierto → Tarea se mueve a "En Review"
• PR merged → Tarea se mueve a "Done"
• PR cerrado → Tarea regresa a "En Progreso"

Timeline de Actividad

Cada tarea muestra actividad Git cronológicamente:

Tarea #234: Implementar login OAuth
Timeline:
├── Dic 18, 10:00 — PR #45 merged por @senior-dev
├── Dic 18, 09:30 — PR #45 aprobado por @senior-dev
├── Dic 17, 16:00 — PR #45 abierto por @developer
├── Dic 17, 15:45 — Commit def456: "Add OAuth callback handling"
├── Dic 17, 14:00 — Commit abc123: "Add OAuth initialization"
├── Dic 16, 10:00 — Branch feature/GS-234-oauth-login creado
└── Dic 15, 09:00 — Tarea creada por @pm

Vinculación Bidireccional

De GitScrum a Git

• Ver commits, branches, PRs en detalles de tarea
• Clic para ir a GitHub/GitLab/Bitbucket
• Ver estado de PR y comentarios de review

De Git a GitScrum

• Agregar links a tareas en descripciones de PR
• Ver contexto de tarea al revisar PRs
• Acceder a requisitos de tarea desde historial de commits

Mejores Prácticas

Estándares de Mensajes de Commit

1. Incluir ID de tarea — Cada commit referencia una tarea
2. Ser descriptivo — Explicar qué y por qué
3. Mantenerlo atómico — Un cambio lógico por commit
4. Usar formato convencional — type(scope): message [task-id]

Estrategia de Branches

1. Usar ID de tarea en nombre de branch — Vinculación automática
2. Mantener branches de vida corta — Merge frecuentemente
3. Eliminar después de merge — Repositorio limpio

Workflow de PRs

1. Referenciar tarea en título o descripción de PR
2. Usar template de PR que solicite link de tarea
3. Revisar requisitos de tarea antes de aprobar

Oportunidades de Automatización

Auto-Mover Tareas en Eventos Git

Notificaciones Webhook

Enviar eventos Git a GitScrum:

• Pushes de commits
• Cambios de estado de PR
• Creación/eliminación de branches
• Solicitudes de review

Soluciones Relacionadas

• Integración de gestión de proyectos con GitHub
• Automatización de workflow con GitLab
• Optimización de workflow de desarrollador