====== 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''.