# ===============================================================================
# MAPA-DOCUMENTACION.yml - Local LLM Agent
# ===============================================================================
#
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
# Proposito: Mapa de documentacion del proyecto
# Fecha: 2026-01-24
#
# ===============================================================================

version: "1.0.0"
proyecto: "local-llm-agent"
fecha_actualizacion: "2026-01-24"

# -----------------------------------------------------------------------------
# DOCUMENTACION PRINCIPAL
# -----------------------------------------------------------------------------

documentacion_principal:
  - archivo: "README.md"
    ubicacion: "/"
    proposito: "Quick start y overview"
    estado: "actualizado"

  - archivo: "INVENTARIO.yml"
    ubicacion: "/"
    proposito: "Inventario completo del proyecto"
    estado: "actualizado"

# -----------------------------------------------------------------------------
# ORCHESTRATION
# -----------------------------------------------------------------------------

orchestration:
  navegacion:
    - archivo: "_MAP.md"
      proposito: "Mapa de navegacion"
    - archivo: "BOOTLOADER.md"
      proposito: "Protocolo de arranque"

  contexto:
    - archivo: "_inheritance.yml"
      proposito: "Declaracion de herencia"
    - archivo: "CONTEXT-MAP.yml"
      proposito: "Variables y rutas"
    - archivo: "PROJECT-PROFILE.yml"
      proposito: "Perfil y metadata"

  estado:
    - archivo: "PROJECT-STATUS.md"
      proposito: "Estado actual"
    - archivo: "PROXIMA-ACCION.md"
      proposito: "Checkpoint de sesion"

  trazabilidad:
    - archivo: "DEPENDENCY-GRAPH.yml"
      proposito: "Grafo de dependencias"
    - archivo: "TRACEABILITY.yml"
      proposito: "Historial de cambios"
    - archivo: "MAPA-DOCUMENTACION.yml"
      proposito: "Este archivo"

# -----------------------------------------------------------------------------
# DOCUMENTACION TECNICA (docs/)
# -----------------------------------------------------------------------------

docs:
  vision:
    - archivo: "docs/README.md"
      proposito: "Indice de documentacion"

    - archivo: "docs/00-vision-general/ARQUITECTURA-LOCAL-LLM.md"
      proposito: "Arquitectura del sistema"

  arquitectura:
    - archivo: "docs/10-arquitectura/MODELO-DATOS-OBJETOS.md"
      proposito: "Modelo de datos y objetos"

  requerimientos:
    - archivo: "docs/50-requerimientos/RF-REQUERIMIENTOS-FUNCIONALES.md"
      proposito: "Requerimientos funcionales"

    - archivo: "docs/50-requerimientos/RNF-REQUERIMIENTOS-NO-FUNCIONALES.md"
      proposito: "Requerimientos no funcionales"

  desarrollo:
    - archivo: "docs/60-plan-desarrollo/PLAN-DESARROLLO.md"
      proposito: "Plan de desarrollo por fases"

    - archivo: "docs/60-plan-desarrollo/INFERENCE-ENGINE-GAP-ANALYSIS.md"
      proposito: "Analisis de gaps"

    - archivo: "docs/60-plan-desarrollo/FASE-2-MCP-TOOLS-DESIGN.md"
      proposito: "Diseno Fase 2"

    - archivo: "docs/60-plan-desarrollo/INTEGRATION-TEST-RESULTS.md"
      proposito: "Resultados de tests"

  onboarding:
    - archivo: "docs/70-onboarding/WSL-GPU-SETUP.md"
      proposito: "Guia de setup GPU en WSL"

  referencias:
    - archivo: "docs/80-referencias/API-REFERENCE.md"
      proposito: "Referencia de API"

  adr:
    - archivo: "docs/90-adr/ADR-001-runtime-selection.md"
      proposito: "Seleccion de runtime"

    - archivo: "docs/90-adr/ADR-002-model-selection.md"
      proposito: "Seleccion de modelo"

# -----------------------------------------------------------------------------
# CONFIGURACION
# -----------------------------------------------------------------------------

configuracion:
  - archivo: ".env.example"
    proposito: "Variables de entorno ejemplo"

  - archivo: ".env.production"
    proposito: "Template de produccion"

  - archivo: "docker-compose.yml"
    proposito: "Desarrollo (CPU)"

  - archivo: "docker-compose.prod.yml"
    proposito: "Produccion (GPU)"

  - archivo: "docker-compose.vllm.yml"
    proposito: "Solo vLLM"

  - archivo: "docker-compose.monitoring.yml"
    proposito: "Stack de monitoring"

# -----------------------------------------------------------------------------
# SCRIPTS
# -----------------------------------------------------------------------------

scripts:
  - archivo: "scripts/setup-wsl-gpu.sh"
    proposito: "Setup GPU en WSL"

# -----------------------------------------------------------------------------
# COBERTURA
# -----------------------------------------------------------------------------

cobertura:
  documentacion: "95%"
  orchestration: "100%"
  estado: "completa"

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

notas:
  - "Documentacion completa para proyecto de infraestructura"
  - "ADRs documentan decisiones de arquitectura"
  - "Guia de GPU setup para produccion"