# ===============================================================================
# MAPA-DOCUMENTACION.yml - Betting Analytics
# ===============================================================================
#
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
# Estandar: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
# Nivel: CONSUMER (L2)
# Fecha: 2026-01-24
#
# ===============================================================================

metadata:
  proyecto: "betting-analytics"
  codigo: "BET"
  version: "1.0.0"
  ultima_actualizacion: "2026-01-24"

# -----------------------------------------------------------------------------
# ESTRUCTURA DE DOCUMENTACION
# -----------------------------------------------------------------------------

estructura:
  # Carpeta root del proyecto
  root: "projects/betting-analytics/"

  carpetas:
    # Documentacion de usuario
    - path: "docs/"
      proposito: "Documentacion de usuario y vision"
      estado: "pendiente"
      archivos_esperados:
        - README.md
        - VISION.md
        - REQUERIMIENTOS.md

    # Orquestacion (carpeta actual)
    - path: "orchestration/"
      proposito: "Documentacion operacional SIMCO"
      estado: "estandarizado"
      archivos:
        # Archivos root obligatorios (10)
        - path: "_MAP.md"
          proposito: "Mapa de navegacion"
          estado: "creado"
        - path: "_inheritance.yml"
          proposito: "Definicion de herencia"
          estado: "creado"
        - path: "BOOTLOADER.md"
          proposito: "Protocolo de arranque NEXUS"
          estado: "existente"
        - path: "CONTEXT-MAP.yml"
          proposito: "Mapa de contexto"
          estado: "existente"
        - path: "PROJECT-PROFILE.yml"
          proposito: "Perfil del proyecto"
          estado: "existente"
        - path: "PROJECT-STATUS.md"
          proposito: "Estado actual"
          estado: "existente"
        - path: "PROXIMA-ACCION.md"
          proposito: "Checkpoint de sesion"
          estado: "existente"
        - path: "DEPENDENCY-GRAPH.yml"
          proposito: "Grafo de dependencias"
          estado: "creado"
        - path: "TRACEABILITY.yml"
          proposito: "Trazabilidad"
          estado: "creado"
        - path: "MAPA-DOCUMENTACION.yml"
          proposito: "Este archivo"
          estado: "creado"

      subcarpetas:
        - path: "00-guidelines/"
          proposito: "Guidelines del proyecto"
          archivos:
            - CONTEXTO-PROYECTO.md
            - HERENCIA-DIRECTIVAS.md
            - HERENCIA-SIMCO.md
            - PROJECT-STATUS.md

        - path: "inventarios/"
          proposito: "Inventarios por capa"
          archivos:
            - MASTER_INVENTORY.yml
            - DATABASE_INVENTORY.yml
            - BACKEND_INVENTORY.yml
            - FRONTEND_INVENTORY.yml

        - path: "trazas/"
          proposito: "Trazas de tareas"
          archivos:
            - TRAZA-TAREAS-DATABASE.md
            - TRAZA-TAREAS-BACKEND.md
            - TRAZA-TAREAS-FRONTEND.md

        - path: "_archive/"
          proposito: "Archivos legacy movidos"
          archivos:
            - environment/  # Movido de root
            - estados/      # Movido de root

# -----------------------------------------------------------------------------
# ALIASES
# -----------------------------------------------------------------------------

aliases:
  # Acceso rapido a documentos clave
  "@BET-BOOT": "orchestration/BOOTLOADER.md"
  "@BET-PROFILE": "orchestration/PROJECT-PROFILE.yml"
  "@BET-STATUS": "orchestration/PROJECT-STATUS.md"
  "@BET-CONTEXT": "orchestration/CONTEXT-MAP.yml"
  "@BET-DEPS": "orchestration/DEPENDENCY-GRAPH.yml"
  "@BET-TRACE": "orchestration/TRACEABILITY.yml"
  "@BET-INV": "orchestration/inventarios/MASTER_INVENTORY.yml"

# -----------------------------------------------------------------------------
# DOCUMENTACION PENDIENTE
# -----------------------------------------------------------------------------

pendiente:
  alta_prioridad: []

  media_prioridad:
    - archivo: "docs/README.md"
      descripcion: "README principal del proyecto"

    - archivo: "docs/VISION.md"
      descripcion: "Vision y objetivos del proyecto"

  baja_prioridad:
    - archivo: "docs/REQUERIMIENTOS.md"
      descripcion: "Requerimientos funcionales y no funcionales"

# -----------------------------------------------------------------------------
# ESTADISTICAS
# -----------------------------------------------------------------------------

estadisticas:
  total_archivos_documentacion: 17
  archivos_root_orchestration: 10
  subcarpetas_orchestration: 4
  cobertura_estandar: "100%"

# -----------------------------------------------------------------------------
# NOTAS
# -----------------------------------------------------------------------------

notas:
  - "Estructura orchestration/ estandarizada a SIMCO-ESTANDAR-ORCHESTRATION v1.0.0"
  - "Carpetas legacy movidas a _archive/"
  - "docs/ pendiente de crear cuando inicie desarrollo"