# MAPA-DOCUMENTACION.yml - ERP Transportistas
# Indice de documentacion del proyecto
# Sistema SIMCO v4.0.0
# ACTUALIZADO: 2026-01-27 (Auditoria Fase 0)

version: "2.0.0"
project: "erp-transportistas"
updated: "2026-01-27"

# ═══════════════════════════════════════════════════════════════════════════════
# ESTRUCTURA DE DOCUMENTACION (ACTUAL)
# ═══════════════════════════════════════════════════════════════════════════════

estructura:

  raiz:
    - archivo: "CLAUDE.md"
      tipo: "configuracion"
      descripcion: "Instrucciones para Claude Code"
      estado: "completado"

    - archivo: "README.md"
      tipo: "documentacion"
      descripcion: "Documentacion general del proyecto"
      estado: "completado"

    - archivo: "PROJECT-STATUS.md"
      tipo: "estado"
      descripcion: "Estado actual del proyecto"
      estado: "requiere_actualizacion"

    - archivo: "INVENTARIO.yml"
      tipo: "inventario"
      descripcion: "Inventario SIMCO del proyecto"
      estado: "completado"

  docs:
    _definitions:
      descripcion: "Definiciones centralizadas"
      archivos:
        - archivo: "_INDEX.yml"
          estado: "completado"
        - archivo: "MODULES-CATALOG.md"
          estado: "completado"
        - archivo: "ENTITIES-CATALOG.md"
          estado: "corregido_2026-01-27"
        - archivo: "SERVICES-CATALOG.md"
          estado: "pendiente"
        - archivo: "DATABASE-SCHEMA.md"
          estado: "completado"

    _quick:
      descripcion: "Referencias rapidas"
      archivos:
        - archivo: "QUICK-INDEX.yml"
          estado: "completado"
        - archivo: "QUICK-MODULES.yml"
          estado: "completado"
        - archivo: "QUICK-DATABASE.yml"
          estado: "completado"
        - archivo: "QUICK-API.yml"
          estado: "completado"

    00-vision-general:
      descripcion: "Vision del producto"
      archivos:
        - archivo: "VISION-ERP-TRANSPORTISTAS.md"
          estado: "completado"

    02-definicion-modulos:
      descripcion: "Definicion funcional de modulos"
      estado_general: "parcial"
      modulos_documentados:

        MAI-003-ordenes-transporte:
          estado: "80%"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 10
          directorio: "historias-usuario/"

        MAI-006-tracking:
          estado: "60%"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 0

        MAI-011-gestion-flota:
          estado: "60%"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 0

        MAI-012-combustible-gastos:
          estado: "30%"
          archivos:
            - ENTITIES.md
          historias_usuario: 0

        MAI-009-facturacion-transporte:
          estado: "10%"
          archivos:
            - ENTITIES.md
          historias_usuario: 0

        MAE-016-carta-porte:
          estado: "80%"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 10
          directorio: "historias-usuario/"

      modulos_sin_documentacion:
        - MAI-002
        - MAI-004
        - MAI-005
        - MAI-007
        - MAI-008
        - MAI-010
        - MAI-013
        - MAI-014
        - MAI-015
        - MAE-017
        - MAE-018
        - MAA-019
        - MAA-020

    03-requerimientos:
      descripcion: "Requerimientos del giro"
      archivos:
        - archivo: "REQ-GIRO-TRANSPORTISTA.md"
          estado: "completado"
          rf_definidos: 68
          procesos: 13

  orchestration:
    raiz:
      - archivo: "BOOTLOADER.md"
        tipo: "configuracion"
        estado: "completado"

      - archivo: "PROJECT-PROFILE.yml"
        tipo: "perfil"
        estado: "completado"

      - archivo: "CONTEXT-MAP.yml"
        tipo: "mapa"
        estado: "completado"

      - archivo: "DEPENDENCY-GRAPH.yml"
        tipo: "dependencias"
        estado: "completado"

      - archivo: "MAPA-DOCUMENTACION.yml"
        tipo: "indice"
        estado: "actualizado_2026-01-27"

      - archivo: "PROXIMA-ACCION.md"
        tipo: "planificacion"
        estado: "actualizado_2026-01-27"

    inventarios:
      descripcion: "Inventarios sincronizados"
      archivos:
        - archivo: "DATABASE_INVENTORY.yml"
          estado: "completado"
        - archivo: "BACKEND_INVENTORY.yml"
          estado: "corregido_2026-01-27"
        - archivo: "MASTER_INVENTORY.yml"
          estado: "nuevo_2026-01-27"

    tareas:
      descripcion: "Historial de tareas"
      estructura: "TASK-YYYY-MM-DD-{nombre}/"
      tareas_existentes:
        - TASK-2026-01-25-001-CREAR-PROYECTO
        - TASK-2026-01-25-DOCUMENTACION-MODULOS

# ═══════════════════════════════════════════════════════════════════════════════
# CARPETAS ELIMINADAS (2026-01-27)
# ═══════════════════════════════════════════════════════════════════════════════

eliminadas_auditoria:
  fecha: "2026-01-27"
  razon: "Carpetas vacias sin contenido"
  carpetas:
    - "docs/01-analisis-referencias/"
    - "docs/10-modelado/"
    - "docs/20-user-stories/"
    - "docs/30-integraciones/"
    - "docs/90-transversal/"
    - "docs/97-adr/"

# ═══════════════════════════════════════════════════════════════════════════════
# DOCUMENTOS PENDIENTES (PRIORIZADOS)
# ═══════════════════════════════════════════════════════════════════════════════

pendientes:

  P0_inmediato:
    - path: "docs/02-definicion-modulos/MAI-007-pod-cierre/"
      descripcion: "Modulo critico - bloquea facturacion"
      archivos_requeridos:
        - README.md
        - REQUERIMIENTOS.md
        - RESUMEN-EPICA.md
        - historias-usuario/ (5-10 US)

    - path: "docs/02-definicion-modulos/MAI-004-planeacion/"
      descripcion: "Workflow critico"
      archivos_requeridos:
        - README.md
        - REQUERIMIENTOS.md
        - RESUMEN-EPICA.md
        - historias-usuario/ (5-10 US)

    - path: "docs/02-definicion-modulos/MAI-005-despacho/"
      descripcion: "Workflow + NOM-068"
      archivos_requeridos:
        - README.md
        - REQUERIMIENTOS.md
        - RESUMEN-EPICA.md
        - historias-usuario/ (5-10 US)

    - path: "docs/02-definicion-modulos/MAI-002-tarifas-sla/"
      descripcion: "Base comercial"
      archivos_requeridos:
        - README.md
        - REQUERIMIENTOS.md
        - RESUMEN-EPICA.md
        - historias-usuario/ (5-10 US)

  P1_corto_plazo:
    - path: "docs/02-definicion-modulos/MAI-009-facturacion-transporte/"
      descripcion: "Completar documentacion (tiene ENTITIES.md)"
      archivos_faltantes:
        - README.md
        - REQUERIMIENTOS.md
        - RESUMEN-EPICA.md

    - path: "docs/02-definicion-modulos/MAI-010-liquidaciones/"
      descripcion: "Pago operadores"

    - path: "docs/02-definicion-modulos/MAI-008-incidencias/"
      descripcion: "Soporte operativo"

    - path: "docs/02-definicion-modulos/MAI-006-tracking/historias-usuario/"
      descripcion: "Agregar 5-10 user stories"

    - path: "docs/02-definicion-modulos/MAI-011-gestion-flota/historias-usuario/"
      descripcion: "Agregar 5-10 user stories"

  P2_mediano_plazo:
    - path: "docs/02-definicion-modulos/MAI-012-combustible-gastos/"
      descripcion: "Completar (tiene ENTITIES.md)"

    - path: "docs/02-definicion-modulos/MAI-013-mantenimiento/"
      descripcion: "Mantenimiento flota"

    - path: "docs/02-definicion-modulos/MAI-014-carriers/"
      descripcion: "Terceros"

    - path: "docs/02-definicion-modulos/MAE-017-hos-bitacora/"
      descripcion: "Compliance HOS"

    - path: "docs/02-definicion-modulos/MAE-018-reportes-kpis/"
      descripcion: "Analytics"

# ═══════════════════════════════════════════════════════════════════════════════
# ESTADISTICAS (CORREGIDAS)
# ═══════════════════════════════════════════════════════════════════════════════

estadisticas:
  total_archivos_docs: 45
  archivos_completados: 32
  archivos_parciales: 8
  archivos_pendientes: "~40 (modulos sin documentar)"

  modulos:
    total: 20
    documentados_completos: 2
    documentados_parciales: 4
    sin_documentar: 14

  user_stories:
    existentes: 30
    requeridas_estimado: 180
    gap: 150

  cobertura_documentacion: "25%"

# ═══════════════════════════════════════════════════════════════════════════════
# HISTORIAL
# ═══════════════════════════════════════════════════════════════════════════════

historial:
  - fecha: "2026-01-25"
    autor: "META-ORQUESTADOR"
    cambio: "Creacion inicial"

  - fecha: "2026-01-27"
    autor: "AUDITOR"
    cambio: |
      Auditoria Fase 0:
      - Eliminadas 6 carpetas vacias
      - Estadisticas corregidas
      - Pendientes priorizados
      - Estructura actualizada

# ═══════════════════════════════════════════════════════════════════════════════
# METADATA
# ═══════════════════════════════════════════════════════════════════════════════

metadata:
  created_by: "META-ORQUESTADOR"
  created_at: "2026-01-25"
  last_audit: "2026-01-27"
  auditor: "AUDITOR-FASE-0"