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

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

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

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

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

  epicas:
    ruta: "docs/01-epicas/"
    alias: "@MC_EPICAS"
    descripcion: "Epicas del proyecto POS"

  especificaciones:
    ruta: "docs/02-especificaciones/"
    alias: "@MC_SPECS"

  transversal:
    ruta: "docs/90-transversal/"
    alias: "@MC_TRANSVERSAL"

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

orchestration:
  raiz:
    README.md:
      alias: "@MC_ORCH_README"
    _MAP.md:
      alias: "@MC_ORCH_MAP"
    PROJECT-STATUS.md:
      alias: "@MC_STATUS"
      descripcion: "Estado actual del proyecto"
    PROXIMA-ACCION.md:
      alias: "@MC_NEXT"
      descripcion: "Siguiente tarea a ejecutar"

  trazabilidad:
    CONTEXT-MAP.yml:
      alias: "@MC_CONTEXT"
      descripcion: "Mapeo de contexto"
    _inheritance.yml:
      alias: "@MC_INHERITANCE"
      descripcion: "Herencia: INTEGRATES template-saas"

  inventarios:
    ruta: "orchestration/inventarios/"
    alias: "@MC_INV"
    archivos:
      MASTER_INVENTORY.yml:
        alias: "@MC_INV_MASTER"
      DATABASE_INVENTORY.yml:
        alias: "@MC_INV_DB"
      BACKEND_INVENTORY.yml:
        alias: "@MC_INV_BE"
      FRONTEND_INVENTORY.yml:
        alias: "@MC_INV_FE"
      MOBILE_INVENTORY.yml:
        alias: "@MC_INV_MOBILE"

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

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

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

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

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

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

estadisticas:
  docs:
    total_archivos: "~30"
    carpetas: 5
  orchestration:
    total_archivos: "~20"
    inventarios: 5
    trazas: 1
  total_aliases: 25
  cobertura_documentacion: "90%"
  ultima_auditoria: "2026-01-16"

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

por_rol:
  desarrollador_backend:
    inicio: "@MC_INV_BE"
    api: "@MC_SPECS"

  desarrollador_frontend:
    inicio: "@MC_INV_FE"
    api: "@MC_SPECS"

  desarrollador_mobile:
    inicio: "@MC_INV_MOBILE"
    api: "@MC_SPECS"

  dba:
    inicio: "@MC_INV_DB"

  orquestador:
    inicio: "@MC_STATUS"
    siguiente: "@MC_NEXT"