# MAPA-DOCUMENTACION.yml - ERP Transportistas
# Indice de documentacion del proyecto
# Sistema SIMCO v4.0.0
# ACTUALIZADO: 2026-01-27 (TASK-007.1 Purga Documental)

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

# ═══════════════════════════════════════════════════════════════════════════════
# PATRON DE DOCUMENTACION DE MODULOS
# ═══════════════════════════════════════════════════════════════════════════════
#
# Cada modulo debe tener:
# - README.md: Descripcion tecnica (entidades, API, funcionalidades, dependencias)
# - RESUMEN-EPICA.md: Vision de negocio (objetivos, alcance, metricas, riesgos)
# - REQUERIMIENTOS.md: Requerimientos funcionales detallados
# - historias-usuario/: Directorio con US individuales (US-MAIXX-001.md, etc.)
#
# NOTA: README.md y RESUMEN-EPICA.md son COMPLEMENTARIOS, no duplicados.
# README = perspectiva tecnica | RESUMEN-EPICA = perspectiva de negocio
#

# ═══════════════════════════════════════════════════════════════════════════════
# 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-002-tarifas-sla:
          estado: "COMPLETADO"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 5
          directorio: "historias-usuario/"

        MAI-003-ordenes-transporte:
          estado: "COMPLETADO"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
          historias_usuario: 10
          directorio: "historias-usuario/"
          nota: "README.md incluye notas de epica consolidadas"

        MAI-004-planeacion:
          estado: "COMPLETADO"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 3
          directorio: "historias-usuario/"

        MAI-005-despacho:
          estado: "COMPLETADO"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 3
          directorio: "historias-usuario/"
          pendiente: "Agregar algoritmo de asignacion inteligente (GAP-002)"

        MAI-006-tracking:
          estado: "COMPLETADO"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 10
          pendiente: "Agregar GPS multi-provider (GAP-001) y Geofencing avanzado (GAP-006)"

        MAI-007-pod-cierre:
          estado: "COMPLETADO"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 3
          directorio: "historias-usuario/"

        MAI-008-incidencias:
          estado: "COMPLETADO"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 3
          directorio: "historias-usuario/"

        MAI-009-facturacion-transporte:
          estado: "COMPLETADO"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 3
          directorio: "historias-usuario/"

        MAI-010-liquidaciones:
          estado: "COMPLETADO"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 3
          directorio: "historias-usuario/"

        MAI-011-gestion-flota:
          estado: "COMPLETADO"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 3
          pendiente: "Agregar catalogo de motores (GAP-004)"

        MAI-012-combustible-gastos:
          estado: "COMPLETADO"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 3
          directorio: "historias-usuario/"

        MAI-013-mantenimiento-flota:
          estado: "COMPLETADO"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 3
          directorio: "historias-usuario/"

        MAI-014-carriers:
          estado: "COMPLETADO"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 3
          directorio: "historias-usuario/"

        MAI-015-portal-cliente:
          estado: "COMPLETADO"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 3
          directorio: "historias-usuario/"

        MAE-016-carta-porte:
          estado: "COMPLETADO"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
          historias_usuario: 10
          directorio: "historias-usuario/"
          nota: "README.md incluye notas de epica consolidadas"

        MAE-017-hos-bitacora:
          estado: "COMPLETADO"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 3
          directorio: "historias-usuario/"

        MAE-018-reportes-kpis:
          estado: "COMPLETADO"
          archivos:
            - README.md
            - REQUERIMIENTOS.md
            - RESUMEN-EPICA.md
          historias_usuario: 3
          directorio: "historias-usuario/"

      modulos_futuros:
        - MAA-019 (Optimizacion Rutas - Fase 3)
        - MAA-020 (Integraciones EDI - Fase 3)

    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: 130
  archivos_completados: 115
  archivos_parciales: 10
  archivos_pendientes: 5

  modulos:
    total: 20
    documentados_completos: 18
    documentados_parciales: 0
    futuros: 2

  user_stories:
    existentes: 54
    requeridas_estimado: 78
    gap: 24
    nota: "TASK-007 identifica 15 US adicionales para GPS/Dispatch/Offline"

  cobertura_documentacion: "100% (modulos Fase 1 y 2)"

  gaps_identificados:
    - GAP-001: GPS Multi-Provider (agregar a MAI-006)
    - GAP-002: Algoritmo Asignacion Inteligente (agregar a MAI-005)
    - GAP-003: Modo Offline para Conductores (nuevo)
    - GAP-004: Catalogo de Motores (agregar a MAI-011)
    - GAP-005: Templates WhatsApp Transporte (nuevo)
    - GAP-006: Geocercas Avanzadas (agregar a MAI-006)
    - GAP-007: Multi GPS Providers (agregar a MAI-006)

# ═══════════════════════════════════════════════════════════════════════════════
# 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

  - fecha: "2026-01-27"
    autor: "TASK-007.1"
    cambio: |
      Purga y Sincronizacion Documental:
      - Estadisticas actualizadas: 18/20 modulos completados
      - Patron README + RESUMEN-EPICA documentado
      - SERVICES-CATALOG sincronizado con BACKEND_INVENTORY
      - 7 gaps identificados con fuente erp-mecanicas-diesel
      - Cobertura documentacion actualizada a 100%

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

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