Estrategia Git - UESSalexmendoza/Lenguajes-de-Programacion GitHub Wiki

🚀 Estrategia de Despliegue y Control de Versiones con Git

Para gestionar el desarrollo y las versiones del sistema VozUrbana, se adoptó una estrategia basada en buenas prácticas de Git, con un enfoque simple pero estructurado, ideal para proyectos académicos y de prototipado funcional.

🌿 Estructura del repositorio

Se definieron las siguientes ramas principales:

  • main: contiene la versión estable y funcional del sistema. Todo lo que está en esta rama está probado y listo para presentación o entrega.
  • develop: rama de integración donde se unifican los avances de las ramas individuales antes de pasar a producción.
  • feature/*: ramas temporales para desarrollar funcionalidades específicas (ej. feature/login, feature/mapa, feature/reportes).
  • hotfix/* (opcional): ramas para solucionar errores críticos detectados en producción o entregas.

🔁 Flujo de trabajo sugerido

  1. Clonar el repositorio:

    git clone https://github.com/UESSalexmendoza/vozurbana.git
cd vozurbana

  2. Crear una nueva rama para una funcionalidad:

    git checkout develop
git checkout -b feature/nombre-funcionalidad

  3. Realizar cambios, guardar y subir:

    git add .
git commit -m "Descripción clara del cambio"

git push origin feature/nombre-funcionalidad


4. Una vez terminada la tarea, crear un **pull request** hacia `develop`.

5. El l铆der de proyecto o QA puede revisar, aprobar y hacer `merge`.

6. Al completar todas las funciones de una entrega, se hace merge de `develop` a `main`.

---

## 📦 Despliegue local

Para ejecutar el proyecto localmente:

```bash
git clone https://github.com/UESSalexmendoza/vozurbana.git
cd vozurbana
python -m venv env
source env/bin/activate  # o env\Scripts\activate en Windows
pip install -r requirements.txt
python manage.py runserver

📌 Buenas prácticas

  • Realizar commits frecuentes y descriptivos.
  • Usar nombres claros para ramas y funcionalidades.
  • Probar cada módulo antes de fusionarlo a develop.
  • Mantener main libre de errores y siempre funcional.
  • Documentar cambios relevantes en el README.md o en la Wiki.

Esta estrategia de trabajo colaborativo con Git permite mantener el proyecto organizado, facilitar la integraci贸n entre miembros del equipo y asegurar una entrega limpia y funcional.