# ===============================================================================
# MAPA DE DOCUMENTACION - MIINVENTARIO
# ===============================================================================
#
# Proposito: Centro de referencias a toda la documentacion del proyecto
# Alias: @MI_MAPA_DOC
# Herencia: INTEGRATES de template-saas
#
# ===============================================================================

version: "1.0.0"
created: "2026-01-16"
updated: "2026-01-16"
proyecto: "miinventario"
tipo: "INTEGRATES"
hereda_de: "template-saas"
nivel: 1

# -------------------------------------------------------------------------------
# DOCUMENTACION DE USUARIO (docs/)
# -------------------------------------------------------------------------------

docs:
  raiz:
    README.md:
      alias: "@MI_README"
      descripcion: "Punto de entrada del proyecto"

  vision:
    ruta: "docs/00-vision-general/"
    archivos:
      - VISION-PROYECTO.md
      - ARQUITECTURA-TECNICA.md
      - REQUERIMIENTOS-FUNCIONALES.md

# -------------------------------------------------------------------------------
# DOCUMENTACION OPERACIONAL (orchestration/)
# -------------------------------------------------------------------------------

orchestration:
  raiz:
    README.md:
      alias: "@MI_ORCH_README"
    PROJECT-STATUS.md:
      alias: "@MI_STATUS"
      descripcion: "Estado actual del proyecto"
    PROXIMA-ACCION.md:
      alias: "@MI_NEXT"
      descripcion: "Siguiente tarea a ejecutar"

  trazabilidad:
    CONTEXT-MAP.yml:
      alias: "@MI_CONTEXT"
      descripcion: "Mapeo de contexto"
    TRACEABILITY.yml:
      alias: "@MI_TRACEABILITY"
      descripcion: "Trazabilidad del proyecto"
    DEPENDENCY-GRAPH.yml:
      alias: "@MI_DEP_GRAPH"
      descripcion: "Grafo de dependencias"
    _inheritance.yml:
      alias: "@MI_INHERITANCE"
      descripcion: "Herencia: INTEGRATES template-saas"

  inventarios:
    ruta: "orchestration/inventarios/"
    alias: "@MI_INV"
    archivos:
      MASTER_INVENTORY.yml:
        alias: "@MI_INV_MASTER"
      DATABASE_INVENTORY.yml:
        alias: "@MI_INV_DB"
      BACKEND_INVENTORY.yml:
        alias: "@MI_INV_BE"
      MOBILE_INVENTORY.yml:
        alias: "@MI_INV_MOBILE"

  directivas:
    ruta: "orchestration/directivas/"
    alias: "@MI_DIRECTIVAS"
    hereda_de: "@WS_DIRECTIVAS"
    archivos:
      - README.md
      - proyecto-triggers/TRIGGER-COHERENCIA-CAPAS.md
      - proyecto-triggers/TRIGGER-INVENTARIOS.md

  agentes:
    ruta: "orchestration/agents/"
    alias: "@MI_AGENTS"
    archivos:
      perfiles:
        - PERFIL-DDL-AGENT.md
        - PERFIL-BACKEND-AGENT.md
        - PERFIL-MOBILE-AGENT.md
      trazas:
        - _INDEX.yml

  trazas:
    ruta: "orchestration/trazas/"
    alias: "@MI_TRAZAS"

# -------------------------------------------------------------------------------
# REFERENCIAS AL WORKSPACE
# -------------------------------------------------------------------------------

workspace_refs:
  archivo: "orchestration/_refs/WS-REFERENCES.yml"
  alias: "@MI_WS_REFS"
  contenido:
    - "@WS_DIRECTIVAS"
    - "@WS_PERFILES"
    - "@WS_TEMPLATES"
    - "@WS_DEFINITIONS"

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

estadisticas:
  docs:
    total_archivos: "~15"
    carpetas: 3
  orchestration:
    total_archivos: "~20"
    inventarios: 4
    trazas: 1
  total_aliases: 20
  cobertura_documentacion: "85%"
  ultima_auditoria: "2026-01-16"

# -------------------------------------------------------------------------------
# NAVEGACION RAPIDA POR ROL
# -------------------------------------------------------------------------------

por_rol:
  desarrollador_backend:
    inicio: "@MI_INV_BE"
    api: "@MI_STATUS"

  desarrollador_mobile:
    inicio: "@MI_INV_MOBILE"
    api: "@MI_STATUS"

  dba:
    inicio: "@MI_INV_DB"

  orquestador:
    inicio: "@MI_STATUS"
    siguiente: "@MI_NEXT"