Este documento establece las reglas para el nombrado de ramas en nuestro flujo de trabajo de Git, basado en GitFlow, con el fin de mantener un desarrollo organizado y estructurado.

Ramas Principales

master

• Contiene el código en producción.
• Solo se fusionan versiones estables y probadas.
• No se realizan desarrollos directos en esta rama.

qa

• Contiene código en pruebas de calidad.
• Se utiliza para validar cambios antes de fusionarlos en release o main.
• Permite realizar pruebas automatizadas y manuales.
• Ejemplo: qa/pruebas-autenticacion
• Contiene el código en desarrollo.
• Se fusionan las ramas de características (features), correcciones de errores (bugfix) y mejoras (enhancements).
• Es la base para la integración y pruebas antes de pasar a producción.

develop

Ramas Auxiliares

feature/{nombre-descriptivo}

• Se crean a partir de develop.
• Se utilizan para desarrollar nuevas características o funcionalidades.
• Se deben fusionar de vuelta en develop una vez completadas.
• Ejemplo: feature/agregar-autenticacion

bugfix/{nombre-descriptivo}

• Se crean a partir de develop.
• Se usan para corregir errores detectados en el entorno de desarrollo.
• Se fusionan en develop tras su corrección.
• Ejemplo: bugfix/corregir-error-login

release/{version}

• Se crean a partir de develop cuando se prepara una nueva versión para producción.
• Se usan para realizar pruebas finales, documentación y correcciones menores.
• Se fusionan en main y develop al finalizar.
• Ejemplo: release/1.2.0

hotfix/{nombre-descriptivo}

• Se crean a partir de main para corregir errores críticos en producción.
• Se fusionan en main y develop después de su corrección.
• Ejemplo: hotfix/solucionar-error-pago

enhancement/{nombre-descriptivo}

• Se crean a partir de develop.
• Se utilizan para mejoras en el código o optimización de funcionalidades existentes.
• Se fusionan en develop.
• Ejemplo: enhancement/mejorar-ui-dashboard

chore/{nombre-descriptivo}

• Se usan para tareas de mantenimiento del proyecto, como actualizaciones de dependencias o cambios en la configuración.
• Se crean a partir de develop y se fusionan de vuelta en develop.
• Ejemplo: chore/actualizar-librerias

Consideraciones Generales

• Usar nombres descriptivos y en minúsculas.
• Separar palabras con guiones -.
• Mantener las ramas actualizadas con develop antes de fusionarlas.
• Eliminar las ramas después de fusionarlas para evitar desorden.