03 - Git en el proyecto
En el proyecto trabajamos en parejas y compartimos cambios sin pisarnos el trabajo. Git guarda el historial y permite probar cada tarea por separado antes de incorporarla al proyecto común. Para el reparto del trabajo en pareja, consulta 01 - Introducción.
Ramas del proyecto
Usaremos dos ramas principales:
- develop es la rama de integración: reúne el trabajo que ya se ha revisado y sirve de base para empezar tareas nuevas.
- main contiene la versión estable o final. No se trabaja directamente sobre ella.
Para cada tarea, crea una rama corta a partir de develop (por ejemplo, feature/catalogo o fix/total-carrito). Trabaja en el clon normal del proyecto; no hace falta crear otro clon ni usar worktrees.
git switch develop git pull git switch -c feature/catalogo
Así comienzas con los cambios más recientes de la rama de integración. Si ya existe la rama de la tarea, cámbiate a ella en lugar de crearla otra vez.
Cambios y commits
Haz cambios pequeños que resuelvan una tarea concreta. Antes de guardar una versión, revisa qué archivos has cambiado y prepara solo los que pertenecen a esa tarea. Escribe un mensaje que explique el cambio, por ejemplo: Añade búsqueda de productos o Corrige el cálculo del total; evita mensajes como cambios o final.
No incluyas contraseñas, claves ni archivos generados que no formen parte del proyecto. Si una tarea crece mucho, podéis dividirla en partes y guardar cada parte en un commit.
Revisión e integración
Antes de integrar la rama de tarea en develop, trabajad juntos:
- La persona que hizo el cambio explica qué resolvió y qué archivos tocó.
- La otra persona revisa los cambios y pregunta lo que no entienda; revisad juntos cualquier parte importante.
- Comprobad que el cambio funciona y que no rompe lo que ya funcionaba.
- Si hay conflictos, resolvedlos entre los dos y volved a comprobar el proyecto.
Cuando ambos estéis de acuerdo, incorporad la rama de tarea a develop. Si el repositorio ofrece solicitudes de integración (*pull requests*), podéis usarlas para dejar la revisión y los comentarios por escrito. Integrar con frecuencia y en tareas pequeñas ayuda a evitar conflictos grandes.
Comprobaciones antes de integrar
Como mínimo, antes de integrar:
- ejecutad la compilación o el proceso de construcción indicado para el proyecto;
- ejecutad las pruebas disponibles;
- probad manualmente la parte que habéis cambiado y un recorrido cercano que pueda verse afectado;
- mirad el estado y los cambios preparados para aseguraros de que no se cuela nada ajeno a la tarea.
No hace falta empezar con pruebas complicadas: lo importante es repetir las comprobaciones básicas después de resolver conflictos. Para ampliar sobre Git y pruebas de extremo a extremo, consulta ED · 01 - Control de versiones con Git y ED · 07 - Pruebas E2E: Playwright.
Publicación
Si el proyecto tiene despliegue automático, develop se publica en el entorno de pruebas. Allí se valida la versión integrada antes de darla por terminada. Cuando esté validada, se actualiza main desde develop; main representa entonces la versión estable/final.
develop → revisión y comprobaciones → integración en develop → validación en pruebas → actualización de main.