# ═══════════════════════════════════════════════════════════════════════════════
# MAPA-DOCUMENTACION.yml - Template SaaS
# ═══════════════════════════════════════════════════════════════════════════════
#
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
# Propósito: Mapa de toda la documentación del proyecto
# Fecha: 2026-01-24
#
# ═══════════════════════════════════════════════════════════════════════════════

version: "1.0.0"
proyecto: "template-saas"
tipo: "PROVIDER"
fecha_actualizacion: "2026-01-24"

# ─────────────────────────────────────────────────────────────────────────────
# DOCUMENTACIÓN PRINCIPAL (orchestration/)
# ─────────────────────────────────────────────────────────────────────────────

orchestration:
  navegacion:
    - archivo: "_MAP.md"
      proposito: "Mapa de navegación visual"
      estado: "completo"

    - archivo: "_INDEX.md"
      proposito: "Índice legacy (deprecated)"
      estado: "deprecated"
      nota: "Usar _MAP.md en su lugar"

  configuracion:
    - archivo: "_inheritance.yml"
      proposito: "Define herencia PROVIDER"
      estado: "completo"
      critico: true

    - archivo: "BOOTLOADER.md"
      proposito: "Protocolo de arranque NEXUS"
      estado: "completo"

    - archivo: "CONTEXT-MAP.yml"
      proposito: "Mapa de contexto para agentes"
      estado: "completo"

    - archivo: "PROJECT-PROFILE.yml"
      proposito: "Perfil y metadata del proyecto"
      estado: "completo"

    - archivo: "PROJECT-STATUS.md"
      proposito: "Estado actual del proyecto"
      estado: "completo"

    - archivo: "PROXIMA-ACCION.md"
      proposito: "Checkpoint de sesión"
      estado: "activo"

  trazabilidad:
    - archivo: "DEPENDENCY-GRAPH.yml"
      proposito: "Grafo de dependencias"
      estado: "completo"

    - archivo: "TRACEABILITY.yml"
      proposito: "Historial de cambios y propagaciones"
      estado: "completo"

    - archivo: "MAPA-DOCUMENTACION.yml"
      proposito: "Este archivo"
      estado: "completo"

  subcarpetas:
    00-guidelines:
      - archivo: "CONTEXTO-PROYECTO.md"
        proposito: "Contexto general del proyecto"
        estado: "completo"

      - archivo: "HERENCIA-SIMCO.md"
        proposito: "Cómo hereda directivas"
        estado: "completo"

    inventarios:
      - archivo: "MASTER_INVENTORY.yml"
        proposito: "Inventario maestro consolidado"
        estado: "completo"

      - archivo: "DATABASE_INVENTORY.yml"
        proposito: "Inventario de tablas DDL"
        estado: "completo"

      - archivo: "BACKEND_INVENTORY.yml"
        proposito: "Inventario de entidades y servicios"
        estado: "completo"

      - archivo: "FRONTEND_INVENTORY.yml"
        proposito: "Inventario de componentes"
        estado: "completo"

    trazas:
      - archivo: "TRAZA-TAREAS-DATABASE.md"
        proposito: "Historial de tareas DDL"
        estado: "activo"

      - archivo: "TRAZA-TAREAS-BACKEND.md"
        proposito: "Historial de tareas backend"
        estado: "activo"

      - archivo: "TRAZA-TAREAS-FRONTEND.md"
        proposito: "Historial de tareas frontend"
        estado: "activo"

    analisis:
      - archivo: "_INDEX.md"
        proposito: "Índice de análisis realizados"
        estado: "completo"
      nota: "Contiene 60+ archivos de análisis históricos"

    planes:
      - archivo: "HISTORICO-SPRINTS.md"
        proposito: "Historial de sprints completados"
        estado: "activo"

# ─────────────────────────────────────────────────────────────────────────────
# DOCUMENTACIÓN DE USUARIO (docs/)
# ─────────────────────────────────────────────────────────────────────────────

docs:
  nota: "Documentación de usuario del proyecto"
  ubicacion: "projects/template-saas/docs/"
  estado: "parcial"

  carpetas:
    - nombre: "00-vision-general/"
      estado: "pendiente"

    - nombre: "10-arquitectura/"
      estado: "parcial"

    - nombre: "70-onboarding/"
      estado: "pendiente"

# ─────────────────────────────────────────────────────────────────────────────
# DOCUMENTACIÓN DE CÓDIGO
# ─────────────────────────────────────────────────────────────────────────────

codigo:
  backend:
    ubicacion: "projects/template-saas/backend/"
    readme: "README.md"
    estado: "completo"

  frontend:
    ubicacion: "projects/template-saas/frontend/"
    readme: "README.md"
    estado: "parcial"

  database:
    ubicacion: "projects/template-saas/database/"
    readme: "README.md"
    ddl: "ddl/"
    estado: "completo"

# ─────────────────────────────────────────────────────────────────────────────
# ESTADÍSTICAS
# ─────────────────────────────────────────────────────────────────────────────

estadisticas:
  total_archivos_orchestration: 85
  archivos_obligatorios_completos: 10
  archivos_obligatorios_total: 10
  cobertura_obligatorios: "100%"

  por_carpeta:
    root: 12
    00-guidelines: 2
    inventarios: 4
    trazas: 4
    analisis: 60+
    planes: 2

# ─────────────────────────────────────────────────────────────────────────────
# NOTAS
# ─────────────────────────────────────────────────────────────────────────────

notas:
  - "Template-saas es PROVIDER - su documentación es referencia para consumidores"
  - "Mantener actualizado con cada nuevo archivo creado"
  - "La carpeta analisis/ contiene histórico extenso de fases de desarrollo"