# =============================================================================
# REGISTRO-PROPAGACIONES.yml
# Registro maestro de propagaciones de mejoras entre proyectos
# =============================================================================
#
# Sistema: NEXUS v3.4
# Version: 1.0.0
# Fecha: 2026-01-04
# Directiva: @PROPAGACION
#
# =============================================================================
# SCHEMA DE PROPAGACION
# =============================================================================
#
# Cada entrada en 'propagaciones' debe tener:
#
#   id: "PROP-YYYY-NNN"              # ID unico (año + secuencial)
#   fecha: "YYYY-MM-DD"              # Fecha de inicio de la propagacion
#   modulo: "nombre-modulo"          # Modulo afectado
#   version_origen: "X.Y.Z"          # Version antes de la mejora
#   version_destino: "X.Y.Z"         # Version despues de la mejora
#   tipo: "security-fix|bug-fix|feature|refactor|performance"
#   urgencia: "CRITICAL|HIGH|MEDIUM|LOW"
#
#   origen:                          # Proyecto donde se origino la mejora
#     proyecto: "nombre"             # Nombre del proyecto
#     commit: "sha1"                 # SHA del commit (opcional)
#     branch: "nombre"               # Branch de la mejora (opcional)
#     descripcion: "..."             # Descripcion breve de la mejora
#     autor: "nombre"                # Autor de la mejora (opcional)
#
#   destinos: []                     # Array de proyectos destino
#     - proyecto: "nombre"           # Nombre del proyecto destino
#       estado: "pendiente|en_progreso|completado|descartado"
#       fecha_inicio: "YYYY-MM-DD"   # Cuando se inicio la propagacion
#       fecha_fin: "YYYY-MM-DD"      # Cuando se completo (si aplica)
#       commit: "sha1"               # Commit de la propagacion (si aplica)
#       notas: "..."                 # Notas adicionales
#       razon_descarte: "..."        # Si estado=descartado, por que?
#
#   breaking_change: true|false      # Es un breaking change?
#   migration_required: true|false   # Requiere migracion?
#   migration_guide: "ruta/..."      # Ruta a la guia de migracion (si aplica)
#   changelog_entry: "..."           # Entrada para CHANGELOG (opcional)
#
# =============================================================================

version: "1.0.0"
ultima_actualizacion: "2026-01-04"
total_propagaciones: 2
propagaciones_activas: 1

# =============================================================================
# REGISTRO DE PROPAGACIONES
# =============================================================================

propagaciones:

  # ---------------------------------------------------------------------------
  # Ejemplo 1: Security Fix (propagacion completada)
  # ---------------------------------------------------------------------------
  - id: "PROP-2026-001"
    fecha: "2026-01-10"
    modulo: "auth-jwt-nestjs"
    version_origen: "2.0.0"
    version_destino: "2.1.0"
    tipo: "security-fix"
    urgencia: "CRITICAL"

    origen:
      proyecto: "gamilit"
      commit: "a1b2c3d4"
      branch: "fix/jwt-token-refresh"
      descripcion: "Correccion de vulnerabilidad en refresh de tokens JWT"
      autor: "equipo-gamilit"

    destinos:
      - proyecto: "erp-core"
        estado: "completado"
        fecha_inicio: "2026-01-10"
        fecha_fin: "2026-01-10"
        commit: "e5f6g7h8"
        notas: "Propagacion urgente - vulnerabilidad critica"

      - proyecto: "trading-platform"
        estado: "completado"
        fecha_inicio: "2026-01-10"
        fecha_fin: "2026-01-11"
        commit: "i9j0k1l2"
        notas: "Requirio ajustes menores en middleware"

    breaking_change: false
    migration_required: false
    changelog_entry: "Fixed: Token refresh vulnerability (CVE-2026-XXXX)"

  # ---------------------------------------------------------------------------
  # Ejemplo 2: Feature (propagacion en progreso)
  # ---------------------------------------------------------------------------
  - id: "PROP-2026-002"
    fecha: "2026-01-15"
    modulo: "stripe-subscriptions"
    version_origen: "2.5.0"
    version_destino: "3.0.0"
    tipo: "feature"
    urgencia: "LOW"

    origen:
      proyecto: "trading-platform"
      commit: "m3n4o5p6"
      branch: "feat/multi-currency-support"
      descripcion: "Soporte para multiples monedas en suscripciones Stripe"
      autor: "equipo-trading"

    destinos:
      - proyecto: "gamilit"
        estado: "pendiente"
        fecha_inicio: null
        notas: "Evaluar si el proyecto necesita soporte multi-currency"
        razon_descarte: null

    breaking_change: true
    migration_required: true
    migration_guide: "modules/payments/stripe-subscriptions/MIGRATION-2.5-to-3.0.md"
    changelog_entry: "Added: Multi-currency support for Stripe subscriptions (BREAKING)"

# =============================================================================
# ESTADISTICAS
# =============================================================================

estadisticas:
  total_historico: 2
  por_tipo:
    security-fix: 1
    bug-fix: 0
    feature: 1
    refactor: 0
    performance: 0
  por_estado:
    pendiente: 1
    en_progreso: 0
    completado: 2
    descartado: 0
  modulos_mas_propagados:
    - modulo: "auth-jwt-nestjs"
      propagaciones: 1
    - modulo: "stripe-subscriptions"
      propagaciones: 1
  proyectos_mas_actualizados:
    - proyecto: "erp-core"
      actualizaciones: 1
    - proyecto: "trading-platform"
      actualizaciones: 1

# =============================================================================
# NOTAS
# =============================================================================
#
# - Los IDs siguen el formato PROP-YYYY-NNN donde YYYY es el año y NNN es secuencial
# - Actualizar 'ultima_actualizacion' cada vez que se modifique este archivo
# - Mantener 'estadisticas' sincronizadas con los datos reales
# - Las propagaciones descartadas deben incluir 'razon_descarte'
#
# Ver: @PROPAGACION para proceso completo
# =============================================================================