# NIVELES-PROPAGACION.yml
# Define la jerarquia de propagacion en cascada
# Version: 1.0.0
# Sistema: NEXUS v3.4
# EPIC: EPIC-012
# Creado: 2026-01-04

metadata:
  version: "1.0.0"
  created: "2026-01-04"
  updated: "2026-01-04"
  descripcion: "Jerarquia de niveles para propagacion de mejoras"
  sistema: "NEXUS v3.4 + SIMCO + CAPVED"

niveles:
  nivel_0:
    nombre: "Core Catalog"
    id: "core-catalog"
    ubicacion: "/home/isem/workspace-v1/shared/catalog/"
    descripcion: "Modulos de referencia y patrones base"
    propaga_a: ["nivel_1"]
    dependencias_internas: false
    contenido:
      - "auth/"
      - "payments/"
      - "notifications/"
      - "websocket/"
      - "multi-tenancy/"
      - "rate-limiting/"
      - "session-management/"
      - "feature-flags/"
      - "audit-logs/"
      - "template-saas/"
      - "portales/"

  nivel_1:
    nombre: "Knowledge-Base Modules"
    id: "kb-modules"
    ubicacion: "/home/isem/workspace-v1/shared/knowledge-base/"
    descripcion: "Modulos compartidos extraidos y plataformas"
    propaga_a: ["nivel_2"]
    dependencias_internas: true
    contenido:
      - "modules/auth/"
      - "modules/payments/"
      - "modules/notifications/"
      - "platforms/gamification-platform/"
      - "platforms/saas-core/"

  nivel_2:
    nombre: "Proyectos Base"
    id: "proyectos-base"
    ubicacion: "/home/isem/workspace-v1/projects/"
    descripcion: "Proyectos principales que heredan de KB"
    propaga_a: ["nivel_3"]
    dependencias_internas: false
    contenido:
      - proyecto: "erp-core"
        tipo: "core-propagador"
        propaga_a_verticales: true
      - proyecto: "gamilit"
        tipo: "standalone"
        propaga_a_verticales: false
      - proyecto: "trading-platform"
        tipo: "standalone"
        propaga_a_verticales: false

  nivel_3:
    nombre: "Proyectos Hoja"
    id: "proyectos-hoja"
    ubicacion: "/home/isem/workspace-v1/projects/"
    descripcion: "Verticales ERP y proyectos finales"
    propaga_a: []
    dependencias_internas: false
    contenido:
      - proyecto: "erp-construccion"
        hereda_de: "erp-core"
      - proyecto: "erp-clinicas"
        hereda_de: "erp-core"
      - proyecto: "erp-retail"
        hereda_de: "erp-core"
      - proyecto: "erp-mecanicas-diesel"
        hereda_de: "erp-core"
      - proyecto: "erp-vidrio-templado"
        hereda_de: "erp-core"
      - proyecto: "betting-analytics"
        hereda_de: null
      - proyecto: "inmobiliaria-analytics"
        hereda_de: null
      - proyecto: "platform_marketing_content"
        hereda_de: null

reglas:
  - id: "R001"
    regla: "Siempre propagar de nivel N a nivel N+1 (nunca saltar niveles)"
    obligatoria: true

  - id: "R002"
    regla: "Validar en cada nivel antes de continuar al siguiente"
    obligatoria: true

  - id: "R003"
    regla: "Si nivel N falla, detener propagacion (no continuar a N+1)"
    obligatoria: true

  - id: "R004"
    regla: "Resolver dependencias internas en nivel 1 antes de propagar"
    obligatoria: true

  - id: "R005"
    regla: "erp-core propaga automaticamente a verticales ERP"
    obligatoria: false

flujo_cascada:
  descripcion: "Orden de ejecucion para propagacion completa"
  pasos:
    - paso: 1
      nivel: "nivel_0"
      accion: "Actualizar modulo en shared/catalog"
      validacion: "Documentacion actualizada"

    - paso: 2
      nivel: "nivel_1"
      accion: "Sincronizar con shared/knowledge-base"
      validacion: "CATALOGO-MODULOS.yml actualizado"

    - paso: 3
      nivel: "nivel_2"
      accion: "Propagar a proyectos base"
      validacion: "Build + Tests pasan"

    - paso: 4
      nivel: "nivel_3"
      accion: "Propagar a proyectos hoja (si aplica)"
      validacion: "Build + Tests pasan"

scripts:
  cascade-propagation: "devtools/scripts/propagation/cascade-propagation.sh"
  generate-scrum-tasks: "devtools/scripts/propagation/generate-scrum-tasks.sh"
  validate-chain: "devtools/scripts/propagation/validate-propagation-chain.sh"

referencias:
  - "@PROPAGACION: core/orchestration/directivas/simco/SIMCO-PROPAGACION-MEJORAS.md"
  - "@KB_MANAGER: core/orchestration/agents/perfiles/PERFIL-KB-MANAGER.md"
  - "@PROTOCOLO_PROP: shared/knowledge-base/propagacion/PROTOCOLO-COORDINACION.yml"