<tipo>[scope opcional]: <descripción>

[cuerpo opcional]

[footer(s) opcional(es)]

feat: añadir sistema de autenticación

feat(auth): implementar login con OAuth2

Añade soporte para autenticación mediante Google y GitHub.
Incluye manejo de tokens y refresh automático.

Closes #123
BREAKING CHANGE: El endpoint /login ahora requiere redirect_uri

# Nuevas funcionalidades
git commit -m "feat: añadir búsqueda por filtros avanzados"

# Corrección de errores
git commit -m "fix: corregir cálculo de impuestos en checkout"

# Cambios en documentación
git commit -m "docs: actualizar guía de instalación"

# Cambios de formato (no afectan funcionalidad)
git commit -m "style: aplicar formato con Prettier"

# Refactorización de código
git commit -m "refactor: simplificar lógica de validación"

# Mejoras de rendimiento
git commit -m "perf: optimizar consulta de usuarios"

# Añadir o actualizar tests
git commit -m "test: añadir tests para módulo de pagos"

# Cambios en build o dependencias
git commit -m "build: actualizar a Node 20"

# Cambios en CI/CD
git commit -m "ci: añadir workflow de GitHub Actions"

# Tareas de mantenimiento
git commit -m "chore: actualizar dependencias"

# Por módulo/componente
git commit -m "feat(parser): añadir soporte para JSON5"
git commit -m "fix(navbar): corregir menu en móviles"

# Por capa de aplicación
git commit -m "refactor(api): extraer lógica de negocio"
git commit -m "test(service): añadir tests unitarios"

# Por funcionalidad
git commit -m "feat(i18n): añadir traducciones al francés"
git commit -m "fix(auth): resolver timeout en login"

# Múltiples scopes (separados por coma)
git commit -m "fix(auth,api): sincronizar validación de tokens"

# Sin scope (cuando afecta todo el proyecto)
git commit -m "chore: migrar a TypeScript 5"

# ✅ BIEN - Modo imperativo, claro
git commit -m "feat: añadir validación de email"
git commit -m "fix: prevenir race condition en cache"
git commit -m "refactor: extraer utilidades de fecha"

# ❌ MAL - Tiempo pasado o poco descriptivo
git commit -m "feat: añadido un feature"  # Vago
git commit -m "fix: arreglé el bug"       # Tiempo pasado
git commit -m "update"                    # Sin tipo ni contexto

git commit -m "feat(cache): implementar estrategia LRU

Reemplaza el cache simple por un LRU para optimizar memoria.
Esto previene que el cache crezca indefinidamente en
aplicaciones long-running.

La implementación usa un Map con orden de inserción para
track el último acceso a cada entrada.
"

# Opción 1: ! después del tipo/scope
git commit -m "feat(api)!: cambiar formato de respuesta JSON

BREAKING CHANGE: El campo 'user_id' ahora se llama 'userId'.
Actualizar código cliente para usar la nueva nomenclatura."

# Opción 2: BREAKING CHANGE en el footer
git commit -m "refactor: reorganizar estructura de exports

BREAKING CHANGE: Los módulos internos ya no son exportados.
Usar solo los exports del index principal."

# Con multiple footers
git commit -m "feat(auth)!: migrar a JWT

Reemplaza sesiones basadas en cookies por tokens JWT.

BREAKING CHANGE: Requiere actualizar auth middleware.
Closes #456
Reviewed-by: @tech-lead
"

# Referencias a issues
git commit -m "fix(parser): manejar strings vacíos

Closes #234
Fixes #567
See also: #890"

# Revisores y co-autores
git commit -m "feat: añadir modo dark

Co-authored-by: Juan Pérez <juan@example.com>
Reviewed-by: María García <maria@example.com>"

# Información de despliegue
git commit -m "chore: actualizar versión

Refs: #456
Deployed-to: production
Release-notes: https://example.com/v2.0"

# Breaking change con contexto
git commit -m "refactor(api)!: cambiar estructura de endpoints

BREAKING CHANGE: Los endpoints ahora usan /api/v2 como base.
Migration-guide: docs/migration-v2.md
Deprecated: /api/v1 (soporte hasta 2026-06-01)"

# Un solo ticket JIRA
git commit -m "feat(checkout): añadir opción de pago con PayPal

Implementa integración completa con PayPal SDK.
Incluye manejo de webhooks para confirmación.

JIRA: PROJ-1234"

# Múltiples tickets relacionados
git commit -m "fix(api): corregir validación de tokens expirados

Corrige bugs relacionados con refresh de tokens
y manejo de expiración en peticiones concurrentes.

JIRA: PROJ-456, PROJ-789
Fixes: PROJ-890"

# Ticket en el subject (formato alternativo)
git commit -m "[PROJ-1234] feat(checkout): añadir pago con PayPal"

# Combinado con otros footers
git commit -m "feat(reports)!: migrar a nueva API de reportes

BREAKING CHANGE: La API antigua quedará deprecada.
Closes #123
JIRA: PROJ-567
Reviewed-by: @team-lead"

git commit -m "feat(auth)!: migrar autenticación a headers

Cambiamos de cookies a Authorization header con Bearer tokens
para mejorar compatibilidad con aplicaciones móviles y SPAs.

Beneficios:
- Menor complejidad en CORS
- Mejor soporte para apps nativas
- Tokens con expiración explícita

BREAKING CHANGE: Los clientes deben enviar tokens en el header
Authorization en lugar de cookies. Ver guía de migración en
docs/auth-migration.md

Closes #789
"

git commit -m "fix(database): prevenir inserción duplicada en race condition

Añade lock optimista usando version field para prevenir que
requests concurrentes creen registros duplicados.

El bug ocurría cuando múltiples workers procesaban el mismo
evento simultáneamente. Ahora el segundo insert falla y se
reintenta leyendo el registro existente.

Fixes #456
Related: #234, #345
"

git commit -m "chore(deps): actualizar dependencias a últimas versiones"

git commit -m "docs(readme,examples): actualizar guía de inicio rápido

Añade sección de troubleshooting común y ejemplos actualizados
para la v2.0 de la API.
"