📄 Guia para GIT COLABORADORES

Guia para GIT COLABORADORES



guia para aplicar GIT

sfwMED — Guía Git desde Visual Studio (Interfaz Gráfica)

Paso a paso detallado para colaboradores y administrador

PARTE 1 — COLABORADOR (Alejandra, Carlos, Felipe, etc.)

A. AL INICIO DEL DÍA — Actualizar código

Objetivo: traer todos los cambios que hicieron otros colaboradores y John.


REGLAS DE ORO

✅ SIEMPRE hacer Pull al inicio del día
✅ SIEMPRE trabajar en tu rama feature/xxx
✅ SIEMPRE hacer git merge develop antes de crear PR
✅ SIEMPRE escribir mensajes de commit descriptivos en español
✅ NUNCA hacer cambios directamente en main o develop
✅ NUNCA hacer push con --force
✅ NUNCA editar archivos desde el Explorador de Windows
   — siempre usar el Explorador de Soluciones de Visual Studio
✅ ZeroTier debe estar activo siempre



Paso 1 — Abrir Visual Studio y el proyecto sfwMedicamentos.sln

Paso 2 — Verificar en qué rama estás

  • Mirar la parte inferior izquierda de Visual Studio
  • Debe decir feature/tu-nombre-tarea
  • Si no está en tu rama ir al Paso 3

Paso 3 — Cambiar a rama develop

  • Clic en el nombre de la rama (parte inferior de Visual Studio)
  • En la lista que aparece seleccionar develop
  • Visual Studio cambia automáticamente

Paso 4 — Descargar cambios de develop

Menú Git → Pull

  • Esperar que termine — aparece mensaje "Todo actualizado" o lista de archivos descargados

Paso 5 — Volver a tu rama personal

  • Clic en el nombre de la rama (dice develop)
  • Seleccionar feature/tu-nombre-tarea

Paso 6 — Traer los cambios de develop a tu rama

Menú Git → Ver → Terminal

En la terminal que se abre escribir:

git merge develop

  • Si dice "Already up to date" → no hay cambios nuevos, todo bien
  • Si lista archivos → los cambios de John llegaron a tu rama ✓
  • Si dice "CONFLICT" → ver sección de resolución de conflictos más abajo

Ya estás listo para trabajar con el código más actualizado.

B. DURANTE EL DÍA — Guardar avances

Objetivo: guardar los cambios en el servidor para no perderlos.

Paso 1 — Abrir el panel de cambios

Menú Git → "Commit" o "stash"...

Se abre el panel Cambios de GIT en el lado derecho.

Paso 2 — Verificar los archivos modificados

  • En la sección Cambios aparece la lista de archivos que modificaste
  • Revisar que sean los archivos correctos
  • Si aparece algún archivo que NO debería estar modificado → clic derecho → Deshacer cambios

Paso 3 — Escribir el mensaje del commit

  • En el campo de texto que dice "Escriba un mensaje aquí"
  • Escribir una descripción clara del cambio, por ejemplo:
sfwMED: ajuste título búsqueda en entmedicamentos

Paso 4 — Confirmar el commit

  • Clic en el botón Confirmar todo (ícono ✓ con flecha)
  • Aparece confirmación "Commit creado"

Paso 5 — Enviar al servidor

Menú Git → Enviar cambios

O clic en la flecha hacia arriba ↑ en el panel de cambios.

  • Aparece mensaje: "Los cambios en feature/tu-rama se enviaron correctamente a origin" ✓

C. AL TERMINAR UNA TAREA — Crear Pull Request

Objetivo: enviar el trabajo terminado a John para revisión y aprobación.

Paso 1 — Asegurarse de haber hecho el commit y push (sección B)

Paso 2 — Actualizar desde develop antes del PR En la terminal de Visual Studio (Ver → Terminal):

git checkout develop
git pull origin develop
git checkout feature/tu-nombre-tarea
git merge develop

Si hay conflictos resolverlos antes de continuar (ver sección D).

Paso 3 — Push final con los cambios actualizados

Menú Git → Enviar cambios

Paso 4 — Ir a Gitea en el navegador

http://192.168.193.153:3000/sigfilasweb/sfwMedicamentos

Paso 5 — Crear el Pull Request

  • Aparece un aviso amarillo: "feature/tu-nombre-tarea fue actualizada"
  • Clic en Crear Pull Request
  • Configurar:
    • Base: develop
    • Compare: feature/tu-nombre-tarea
    • Título: descripción clara del cambio
    • Descripción: qué se hizo, qué archivos se tocaron
    • Revisor: seleccionar sigfilasweb (John)
  • Clic Crear Pull Request

Paso 6 — Esperar la aprobación de John

  • Gitea envía notificación a John
  • John revisa y aprueba o solicita correcciones
  • Si John pide correcciones → hacer los cambios → nuevo commit → push → el PR se actualiza automáticamente

D. RESOLUCIÓN DE CONFLICTOS

Cuándo ocurre: cuando tú y otro colaborador editaron la misma línea del mismo archivo.

Paso 1 — Visual Studio marca los archivos con conflicto en rojo en el panel de cambios

Paso 2 — Clic derecho en el archivo con conflicto → Resolver conflictos

Paso 3 — Visual Studio muestra dos versiones:

  • Izquierda: tu versión
  • Derecha: versión de develop (la aprobada por John)

Paso 4 — Elegir qué conservar:

  • Clic en Tomar entrante → conserva la versión de develop
  • Clic en Tomar actual → conserva tu versión
  • O editar manualmente combinando ambas versiones

Paso 5 — Una vez resuelto hacer commit:

Menú Git → "Commit" o "stash" → Confirmar todo

Mensaje sugerido:

sfwMED: resolver conflicto en entmedicamentos con develop

Paso 6 — Push y continuar con el PR normal

PARTE 2 — ADMINISTRADOR (John)

E. REVISAR Y APROBAR UN PULL REQUEST

Paso 1 — Recibir notificación de PR en Gitea

http://192.168.193.153:3000/sigfilasweb/sfwMedicamentos/pulls

Paso 2 — Abrir el Pull Request

  • Clic en el título del PR

Paso 3 — Revisar los cambios

  • Pestaña Archivos modificados → ver exactamente qué líneas cambiaron
  • Verde = líneas agregadas
  • Rojo = líneas eliminadas
  • Verificar que solo tocó los archivos que le corresponden según CODEOWNERS

Paso 4a — Si está bien:

  • Clic en Revisar → Aprobar
  • Clic en Fusionar Pull Request
  • Clic en Confirmar fusión
  • El cambio queda en develop ✓

Paso 4b — Si necesita correcciones:

  • Clic en Revisar → Solicitar cambios
  • Escribir en el comentario qué debe corregir
  • El colaborador recibe notificación y hace las correcciones

F. PUBLICAR TUS CAMBIOS PARA TODOS LOS COLABORADORES

Objetivo: cuando John hace cambios en su máquina, todos los colaboradores los reciben.

Paso 1 — Hacer los cambios en tu máquina normalmente

Paso 2 — Probar con F5 que funciona

Paso 3 — Cambiar a rama develop

  • Clic en nombre de rama (parte inferior Visual Studio)
  • Seleccionar develop

Paso 4 — Abrir panel de cambios

Menú Git → "Commit" o "stash"...

Paso 5 — Confirmar los cambios

  • Escribir mensaje descriptivo:
sfwMED: descripción del cambio

  • Clic Confirmar todo

Paso 6 — Enviar a todos

Menú Git → Enviar cambios

  • Los cambios quedan en origin/develop ✓
  • Todos los colaboradores los recibirán en su próximo Pull del día

Paso 7 — Actualizar main (cuando el cambio es estable)

  • En la terminal de Visual Studio (Ver → Terminal):
git checkout main
git merge develop
git push origin main
git checkout develop

G. DESCARGAR CAMBIOS DE COLABORADORES A TU MÁQUINA

Cuando un PR fue aprobado y fusionado:

Paso 1 — Cambiar a rama main o develop

  • Clic en nombre de rama → seleccionar main

Paso 2 — Descargar cambios

Menú Git → Pull

Paso 3 — Verificar en el log

Menú Git → Ver historial de ramas

Debe aparecer el commit del colaborador en el historial.

RESUMEN VISUAL DEL FLUJO COMPLETO

JOHN                    GITEA                   COLABORADOR
────────────────────────────────────────────────────────────
                                                Inicio día:
                                                Git → Pull (develop)
                                                git merge develop
                                                Edita código
                                                F5 → prueba local
                                                Git → Commit
                                                Git → Push
                    PR creado ←────────────────
Revisa PR ─────────────────────────────────────
Aprueba y fusiona ──→ develop actualizado
Git → Pull ←────────
Tiene cambios ✓
                    develop actualizado ────────→ Colaborador hace
                                                  git pull develop
                                                  git merge develop
                                                  Tiene cambios ✓