====== 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 [[clase:daw:proyecto-1daw:tema01|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 [[clase:daw:ed:git|ED · 01 - Control de versiones con Git]] y [[clase:daw:ed:e2e|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**.
El recorrido es: rama corta basada en ''develop'' → revisión y comprobaciones → integración en ''develop'' → validación en pruebas → actualización de ''main''.