060-git-workflow

🔀 GIT WORKFLOW — TRADING TERMINAL

GIT ES TU RED DE SEGURIDAD

En vibecoding, la IA puede equivocarse y romper cosas. Git es la única forma de volver a un estado funcional. Hacer commit frecuente = poder deshacer errores de la IA.

---

📋 CONVENCIÓN DE COMMITS (Conventional Commits)

# Formato: tipo(módulo): descripción corta en español

# Tipos:
feat:     Nueva funcionalidad
fix:      Corrección de bug
refactor: Reorganización sin cambiar comportamiento
test:     Agregar/modificar tests
docs:     Documentación
style:    Formato, espacios (sin cambios de lógica)
chore:    Tareas de mantenimiento
security: Cambios de seguridad

# Ejemplos:
git commit -m "feat(orders): implementar creación de órdenes MARKET"
git commit -m "fix(auth): corregir expiración de JWT en zona horaria UTC"
git commit -m "security(api): agregar rate limiting en endpoints de órdenes"
git commit -m "test(risk): agregar tests para validación de tamaño de posición"

---

🌿 ESTRATEGIA DE BRANCHES

main
├── Es el código en producción
├── NUNCA commitear directamente
└── Solo recibe merges de develop

develop
├── Código integrado y testeado
├── Base para nuevas features
└── Merge a main cuando el módulo está completo

feature/[nombre-del-módulo]
├── Desarrollo de cada módulo
├── Ejemplos:
│   ├── feature/auth-jwt
│   ├── feature/order-management
│   ├── feature/realtime-feed
│   └── feature/portfolio-tracker
└── Merge a develop cuando está testeado

Comandos de gestión de branches:

# Crear branch para nuevo módulo
git checkout develop
git pull
git checkout -b feature/nombre-del-modulo

# Cuando el módulo está listo
git checkout develop
git merge feature/nombre-del-modulo
git push

# Ver estado actual
git status
git log --oneline -10

---

⏱️ CUÁNDO HACER COMMIT

✅ Hacer commit:
- Al terminar cada archivo nuevo
- Al hacer pasar un test
- Antes de un refactor grande
- Al final de cada sesión de trabajo
- Cuando algo funciona (¡aunque sea parcial!)

❌ NO hacer commit:
- Código que no compila/tiene errores de sintaxis
- Con secrets o API keys (verificar .gitignore)
- Con console.log de debug masivos
- Cuando los tests están fallando