Conceptos básicos de Git para equipos de Node

# Trabajo diario de características
git checkout main && git pull --ff-only
git checkout -b feat/API-412-add-refund-endpoint
# ... commits con mensajes convencionales ...
git push -u origin feat/API-412-add-refund-endpoint
# Abrir PR → squash merge a main después de que CI esté en verde

# Corte de lanzamiento (cuando la API + los workers se envían juntos)
git checkout main && git pull --ff-only
git checkout -b release/2.6.0
git push -u origin release/2.6.0
# Solo correcciones de errores hasta la etiqueta; migraciones coordinadas en las notas de la versión

# Etiquetar después de la aprobación en staging
git checkout release/2.6.0
git tag -a v2.6.0 -m "Lanzamiento 2.6.0 - orders-api + email-worker"
git push origin v2.6.0

Carriles de rama (backends de Node)
  main              ← integración; CI siempre en verde
  feat/*            ← días; squash merge
  release/X.Y       ← semanas; tren de despliegue coordinado
  hotfix/X.Y.Z      ← horas; de la etiqueta vX.Y.(Z-1)

# Nunca ignores los lockfiles
git check-ignore package-lock.json && echo "BAD" || echo "OK"
 
# .gitignore debe excluir
# node_modules/
# dist/
# .env
# coverage/

// package.json
{
  "engines": { "node": "24.18.0" }
}

git commit -m "feat(orders): add refund endpoint [API-412]"
git commit -m "fix(worker): retry webhook on 429 [API-415]"
git commit -m "chore(deps): bump fastify to 5.x [API-420]"

## Lista de verificación del lanzamiento 2.6.0
- [ ] orders-api migración 20260709_refunds.sql fusionada a release/2.6.0
- [ ] email-worker compatible con el nuevo esquema de eventos
- [ ] Orden de despliegue: migración → worker → API (documentar en el manual de operaciones)
- [ ] La etiqueta v2.6.0 activa el flujo de trabajo de lanzamiento de GitHub Actions

git checkout -b hotfix/2.5.1 v2.5.0
# solo corrige el error de producción
git tag -a v2.5.1 -m "Hotfix: fuga de pool en el manejador de webhook"
git push origin v2.5.1
# Cherry-pick del SHA de la corrección a main Y abrir release/2.6.0 si aún está activa