# ===============================================================================
# MAPA DE DOCUMENTACION - INMOBILIARIA-ANALYTICS
# ===============================================================================
#
# Proposito: Centro de referencias a toda la documentacion del proyecto
# Alias: @INMO_MAPA_DOC
# Herencia: STANDALONE (hereda directivas de workspace-v2)
# Estado: IDEA (P4 - Backlog)
#
# ===============================================================================

version: "1.0.0"
created: "2026-01-24"
updated: "2026-01-24"
proyecto: "inmobiliaria-analytics"
tipo: "STANDALONE"
hereda_de: "workspace-v2"
nivel: "CONSUMER (L2)"
estado: "IDEA"
prioridad: "P4"

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

docs:
  raiz:
    README.md:
      alias: "@INMO_README"
      descripcion: "Punto de entrada del proyecto"
      estado: "por crear"

  vision:
    ruta: "docs/00-vision-general/"
    alias: "@INMO_VISION"
    descripcion: "Vision, arquitectura, requerimientos"
    estado: "por crear"

  epicas:
    ruta: "docs/01-epicas/"
    alias: "@INMO_EPICAS"
    descripcion: "Epicas del proyecto"
    estado: "por crear"

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

orchestration:
  raiz:
    _MAP.md:
      alias: "@INMO_ORCH_MAP"
      descripcion: "Mapa de navegacion orchestration"
    PROJECT-STATUS.md:
      alias: "@INMO_STATUS"
      descripcion: "Estado actual del proyecto"
    PROXIMA-ACCION.md:
      alias: "@INMO_NEXT"
      descripcion: "Siguiente tarea a ejecutar"
    BOOTLOADER.md:
      alias: "@INMO_BOOT"
      descripcion: "Protocolo de arranque NEXUS"

  trazabilidad:
    CONTEXT-MAP.yml:
      alias: "@INMO_CONTEXT"
      descripcion: "Mapeo de contexto NEXUS"
    _inheritance.yml:
      alias: "@INMO_INHERITANCE"
      descripcion: "Herencia: STANDALONE desde workspace-v2"
    DEPENDENCY-GRAPH.yml:
      alias: "@INMO_DEPS"
      descripcion: "Grafo de dependencias"
    TRACEABILITY.yml:
      alias: "@INMO_TRACE"
      descripcion: "Trazabilidad del proyecto"
    PROJECT-PROFILE.yml:
      alias: "@INMO_PROFILE"
      descripcion: "Perfil y metadata del proyecto"

  guidelines:
    ruta: "orchestration/00-guidelines/"
    alias: "@INMO_GUIDELINES"
    archivos:
      CONTEXTO-PROYECTO.md:
        alias: "@INMO_CONTEXTO"
        descripcion: "Contexto y variables del proyecto"
      HERENCIA-DIRECTIVAS.md:
        alias: "@INMO_HERENCIA_DIR"
        descripcion: "Herencia de directivas"
      HERENCIA-SIMCO.md:
        alias: "@INMO_HERENCIA_SIMCO"
        descripcion: "Herencia del sistema SIMCO"

  inventarios:
    ruta: "orchestration/inventarios/"
    alias: "@INMO_INV"
    nota: "Inventarios vacios - proyecto en fase IDEA"
    archivos:
      MASTER_INVENTORY.yml:
        alias: "@INMO_INV_MASTER"
        estado: "vacio"
      DATABASE_INVENTORY.yml:
        alias: "@INMO_INV_DB"
        estado: "vacio"
      BACKEND_INVENTORY.yml:
        alias: "@INMO_INV_BE"
        estado: "vacio"
      FRONTEND_INVENTORY.yml:
        alias: "@INMO_INV_FE"
        estado: "vacio"

  trazas:
    ruta: "orchestration/trazas/"
    alias: "@INMO_TRAZAS"
    archivos:
      - TRAZA-TAREAS-BACKEND.md
      - TRAZA-TAREAS-DATABASE.md
      - TRAZA-TAREAS-FRONTEND.md

  archivo:
    ruta: "orchestration/_archive/"
    descripcion: "Contenido archivado (no estandar)"
    contenido:
      - "environment/ - Configuracion de ambiente pre-estandarizacion"
      - "estados/ - Estados de subagentes pre-estandarizacion"

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

workspace_refs:
  directivas:
    alias: "@WS_DIRECTIVAS"
    ruta: "workspace-v2/orchestration/directivas/"
    descripcion: "Directivas SIMCO del workspace"

  simco:
    alias: "@WS_SIMCO"
    ruta: "workspace-v2/orchestration/directivas/simco/"
    descripcion: "Sistema SIMCO"

  perfiles:
    alias: "@WS_PERFILES"
    ruta: "workspace-v2/orchestration/agents/perfiles/"
    descripcion: "Perfiles de agentes"

  templates:
    alias: "@WS_TEMPLATES"
    ruta: "workspace-v2/shared/templates/"
    descripcion: "Templates compartidos"

# -------------------------------------------------------------------------------
# MODULOS PLANEADOS
# -------------------------------------------------------------------------------

modulos_planeados:
  - id: "INMO-001"
    nombre: "Analisis de Mercado"
    descripcion: "Analisis de precios y tendencias"
    estado: "idea"

  - id: "INMO-002"
    nombre: "Valuacion Automatizada"
    descripcion: "Estimacion de valor de propiedades"
    estado: "idea"

  - id: "INMO-003"
    nombre: "Comparativos"
    descripcion: "Comparacion entre propiedades similares"
    estado: "idea"

  - id: "INMO-004"
    nombre: "Reportes de Inversion"
    descripcion: "ROI y analisis de rentabilidad"
    estado: "idea"

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

estadisticas:
  docs:
    total_archivos: 0
    carpetas: 0
    nota: "Proyecto en fase IDEA - sin documentacion de usuario"
  orchestration:
    total_archivos: 10
    inventarios: 4
    trazas: 3
  total_aliases: 20
  cobertura_documentacion: "0%"
  ultima_auditoria: "2026-01-24"

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

por_rol:
  orquestador:
    inicio: "@INMO_STATUS"
    siguiente: "@INMO_NEXT"
    contexto: "@INMO_CONTEXT"

  desarrollador:
    nota: "Proyecto en fase IDEA - sin desarrollo activo"
    permitido: "Solo documentacion y planeacion"

  dba:
    nota: "Proyecto en fase IDEA - sin base de datos"

# -------------------------------------------------------------------------------
# RESTRICCIONES P4
# -------------------------------------------------------------------------------

restricciones:
  prioridad: "P4 (Backlog)"
  permitido:
    - "Documentacion de requerimientos"
    - "Planeacion de arquitectura"
    - "Definicion de epicas"
    - "Investigacion de mercado"
  bloqueado:
    - "Desarrollo de codigo"
    - "Implementacion de features"
    - "Setup de infraestructura"
    - "Testing"
  razon: "Recursos limitados - priorizar proyectos P0-P3"

# ===============================================================================
# FIN DE MAPA DE DOCUMENTACION
# ===============================================================================