# MASTER_INVENTORY.yml - ERP Transportistas
# Sistema SIMCO v4.0.0
# Inventario Maestro Consolidado
# Creado: 2026-01-27 (Auditoria Fase 0)

version: "1.0.0"
created: "2026-01-27"
updated: "2026-01-27"
audit_date: "2026-01-27"

# ═══════════════════════════════════════════════════════════════════════════════
# RESUMEN EJECUTIVO
# ═══════════════════════════════════════════════════════════════════════════════

resumen:
  proyecto: erp-transportistas
  tipo: ERP Vertical (Transporte de Carga)
  hereda_de: erp-core
  estado_general: "15% completado"

  metricas:
    ddl:
      schemas: 8
      tablas_estimadas: 98
      enums_estimados: 47
      progreso: "100%"

    backend:
      framework: NestJS
      entities_total: 153
      entities_heredadas: 109
      entities_propias: 44
      entities_especializadas_faltantes: 58
      controllers: 35
      services_propios: 0
      progreso: "15%"

    frontend:
      framework: React
      componentes: 0
      paginas: 0
      progreso: "0%"

    documentacion:
      modulos_total: 20
      modulos_documentados: 4
      user_stories: 30
      progreso: "25%"

# ═══════════════════════════════════════════════════════════════════════════════
# COHERENCIA ENTRE CAPAS
# ═══════════════════════════════════════════════════════════════════════════════

coherencia:
  ddl_vs_backend:
    tablas_ddl: 98
    entities_especializadas_esperadas: 98
    entities_especializadas_implementadas: 44
    gap: 54
    coherencia_porcentaje: "45%"
    estado: "INCOHERENTE - Requiere implementacion de entities"

  backend_vs_documentacion:
    modulos_documentados_con_entities: 4
    modulos_documentados_sin_entities: 6
    modulos_sin_documentacion: 10
    estado: "INCOHERENTE - Falta documentacion de modulos"

  rf_vs_modulos:
    rf_totales_giro: 68
    rf_cubiertos_por_modulos: 40
    rf_sin_modulo: 28
    cobertura: "59%"
    estado: "PARCIAL - Requiere mapeo completo"

# ═══════════════════════════════════════════════════════════════════════════════
# INVENTARIO DE MODULOS
# ═══════════════════════════════════════════════════════════════════════════════

modulos:
  fase_1_mai:
    - codigo: MAI-001
      nombre: Fundamentos
      ddl: "-"
      backend: "100%"
      docs: "-"
      frontend: "-"
      herencia: "100% erp-core"
      prioridad: "-"

    - codigo: MAI-002
      nombre: Clientes y Tarifas
      ddl: "0%"
      backend: "0%"
      docs: "0%"
      frontend: "0%"
      prioridad: P0
      rf_relacionados: [RF-4.1.1, RF-4.1.2, RF-4.1.3, RF-4.1.4, RF-4.1.5]

    - codigo: MAI-003
      nombre: Ordenes de Transporte
      ddl: "100%"
      backend: "10%"
      docs: "80%"
      frontend: "0%"
      prioridad: P0
      rf_relacionados: [RF-4.2.1, RF-4.2.2, RF-4.2.3, RF-4.2.4, RF-4.2.5, RF-4.2.6]
      archivos_docs:
        - docs/02-definicion-modulos/MAI-003-ordenes-transporte/README.md
        - docs/02-definicion-modulos/MAI-003-ordenes-transporte/REQUERIMIENTOS.md
        - docs/02-definicion-modulos/MAI-003-ordenes-transporte/RESUMEN-EPICA.md
      user_stories: 10

    - codigo: MAI-004
      nombre: Planeacion TMS
      ddl: "100%"
      backend: "0%"
      docs: "0%"
      frontend: "0%"
      prioridad: P0
      rf_relacionados: [RF-4.3.1, RF-4.3.2, RF-4.3.3, RF-4.3.4, RF-4.3.5, RF-4.3.6]

    - codigo: MAI-005
      nombre: Despacho
      ddl: "100%"
      backend: "0%"
      docs: "0%"
      frontend: "0%"
      prioridad: P0
      rf_relacionados: [RF-4.4.1, RF-4.4.2, RF-4.4.3, RF-4.4.4, RF-4.4.5, RF-4.4.6]

    - codigo: MAI-006
      nombre: Tracking
      ddl: "100%"
      backend: "5%"
      docs: "60%"
      frontend: "0%"
      prioridad: P1
      rf_relacionados: [RF-4.5.1, RF-4.5.2, RF-4.5.3, RF-4.5.4, RF-4.5.5, RF-4.5.6]
      archivos_docs:
        - docs/02-definicion-modulos/MAI-006-tracking/README.md
        - docs/02-definicion-modulos/MAI-006-tracking/REQUERIMIENTOS.md
        - docs/02-definicion-modulos/MAI-006-tracking/RESUMEN-EPICA.md

    - codigo: MAI-007
      nombre: POD y Cierre
      ddl: "100%"
      backend: "0%"
      docs: "0%"
      frontend: "0%"
      prioridad: P0
      rf_relacionados: [RF-4.7.1, RF-4.7.2, RF-4.7.3, RF-4.7.4]

    - codigo: MAI-008
      nombre: Incidencias
      ddl: "100%"
      backend: "0%"
      docs: "0%"
      frontend: "0%"
      prioridad: P1
      rf_relacionados: [RF-4.6.1, RF-4.6.2, RF-4.6.3, RF-4.6.4, RF-4.6.5, RF-4.6.6]

    - codigo: MAI-009
      nombre: Facturacion Transporte
      ddl: "100%"
      backend: "15%"
      docs: "0%"
      frontend: "0%"
      prioridad: P1
      rf_relacionados: [RF-4.8.1, RF-4.8.2, RF-4.8.3, RF-4.8.4, RF-4.8.5]
      entities_implementadas: 6

    - codigo: MAI-010
      nombre: Liquidaciones
      ddl: "100%"
      backend: "0%"
      docs: "0%"
      frontend: "0%"
      prioridad: P1
      rf_relacionados: [RF-4.9.1, RF-4.9.2, RF-4.9.3, RF-4.9.4]

    - codigo: MAI-011
      nombre: Gestion de Flota
      ddl: "100%"
      backend: "10%"
      docs: "60%"
      frontend: "0%"
      prioridad: P0
      rf_relacionados: [RF-4.11.1, RF-4.11.2, RF-4.11.3, RF-4.11.4, RF-4.11.5]
      archivos_docs:
        - docs/02-definicion-modulos/MAI-011-gestion-flota/README.md
        - docs/02-definicion-modulos/MAI-011-gestion-flota/REQUERIMIENTOS.md
        - docs/02-definicion-modulos/MAI-011-gestion-flota/RESUMEN-EPICA.md

    - codigo: MAI-012
      nombre: Combustible y Gastos
      ddl: "100%"
      backend: "20%"
      docs: "30%"
      frontend: "0%"
      prioridad: P2
      rf_relacionados: [RF-4.10.1, RF-4.10.2, RF-4.10.3, RF-4.10.4, RF-4.10.5]
      entities_implementadas: 5
      archivos_docs:
        - docs/02-definicion-modulos/MAI-012-combustible-gastos/ENTITIES.md

    - codigo: MAI-013
      nombre: Mantenimiento Flota
      ddl: "100%"
      backend: "0%"
      docs: "0%"
      frontend: "0%"
      prioridad: P2
      rf_relacionados: [RF-4.11.1, RF-4.11.2, RF-4.11.3, RF-4.11.4, RF-4.11.5]

    - codigo: MAI-014
      nombre: Carriers (Terceros)
      ddl: "100%"
      backend: "0%"
      docs: "0%"
      frontend: "0%"
      prioridad: P2
      rf_relacionados: [RF-4.12.1, RF-4.12.2, RF-4.12.3, RF-4.12.4, RF-4.12.5, RF-4.12.6]

    - codigo: MAI-015
      nombre: Portal Cliente
      ddl: "100%"
      backend: "0%"
      docs: "0%"
      frontend: "0%"
      prioridad: P3
      rf_relacionados: [RF-4.13.1, RF-4.13.2, RF-4.13.3, RF-4.13.4]

  fase_2_mae:
    - codigo: MAE-016
      nombre: Carta Porte CFDI
      ddl: "100%"
      backend: "10%"
      docs: "80%"
      frontend: "0%"
      prioridad: P1
      rf_relacionados: [RF-5.1.1, RF-5.1.2, RF-5.1.3, RF-5.1.4, RF-5.1.5, RF-5.1.6, RF-5.1.7]
      archivos_docs:
        - docs/02-definicion-modulos/MAE-016-carta-porte/README.md
        - docs/02-definicion-modulos/MAE-016-carta-porte/REQUERIMIENTOS.md
        - docs/02-definicion-modulos/MAE-016-carta-porte/RESUMEN-EPICA.md
      user_stories: 10

    - codigo: MAE-017
      nombre: HOS y Bitacora
      ddl: "100%"
      backend: "0%"
      docs: "0%"
      frontend: "0%"
      prioridad: P3
      rf_relacionados: [RF-5.2.1, RF-5.2.2, RF-5.2.3, RF-5.2.4]

    - codigo: MAE-018
      nombre: Reportes y KPIs
      ddl: "100%"
      backend: "0%"
      docs: "0%"
      frontend: "0%"
      prioridad: P2

  fase_3_maa:
    - codigo: MAA-019
      nombre: Optimizacion Rutas
      ddl: "0%"
      backend: "0%"
      docs: "0%"
      frontend: "0%"
      prioridad: P3

    - codigo: MAA-020
      nombre: Integraciones EDI
      ddl: "0%"
      backend: "0%"
      docs: "0%"
      frontend: "0%"
      prioridad: P3

# ═══════════════════════════════════════════════════════════════════════════════
# PRIORIZACION DE MODULOS
# ═══════════════════════════════════════════════════════════════════════════════

priorizacion:
  criterios:
    bloqueante_workflow: 5
    compliance_requerido: 4
    alta_dependencia: 3
    backend_parcial: 2
    solicitado: 1

  resultado:
    P0:
      - codigo: MAI-007
        nombre: POD y Cierre
        puntos: 8
        justificacion: "Bloquea facturacion, cierre operativo"

      - codigo: MAI-004
        nombre: Planeacion TMS
        puntos: 8
        justificacion: "Workflow critico OT -> Viaje"

      - codigo: MAI-005
        nombre: Despacho
        puntos: 8
        justificacion: "Workflow + NOM-068 compliance"

      - codigo: MAI-002
        nombre: Tarifas y SLA
        puntos: 7
        justificacion: "Base comercial obligatoria"

      - codigo: MAI-003
        nombre: Ordenes de Transporte
        puntos: 7
        justificacion: "Core del sistema, ya tiene docs"

      - codigo: MAI-011
        nombre: Gestion de Flota
        puntos: 7
        justificacion: "Recursos criticos, ya tiene docs"

    P1:
      - codigo: MAI-009
        nombre: Facturacion Transporte
        puntos: 6
        justificacion: "Monetizacion"

      - codigo: MAI-010
        nombre: Liquidaciones
        puntos: 5
        justificacion: "Pago operadores"

      - codigo: MAI-008
        nombre: Incidencias
        puntos: 4
        justificacion: "Soporte operativo"

      - codigo: MAI-006
        nombre: Tracking
        puntos: 4
        justificacion: "Visibilidad, ya tiene docs"

      - codigo: MAE-016
        nombre: Carta Porte CFDI
        puntos: 6
        justificacion: "Compliance fiscal obligatorio"

    P2:
      - codigo: MAI-012
        nombre: Combustible y Gastos
        puntos: 4
        justificacion: "Control costos, entities existentes"

      - codigo: MAI-013
        nombre: Mantenimiento Flota
        puntos: 3
        justificacion: "Disponibilidad"

      - codigo: MAI-014
        nombre: Carriers
        puntos: 3
        justificacion: "Escalabilidad"

      - codigo: MAE-018
        nombre: Reportes y KPIs
        puntos: 2
        justificacion: "Analytics"

    P3:
      - codigo: MAI-015
        nombre: Portal Cliente
        puntos: 2
        justificacion: "Fase posterior"

      - codigo: MAE-017
        nombre: HOS y Bitacora
        puntos: 3
        justificacion: "Compliance secundario"

      - codigo: MAA-019
        nombre: Optimizacion Rutas
        puntos: 1
        justificacion: "Fase avanzada"

      - codigo: MAA-020
        nombre: Integraciones EDI
        puntos: 1
        justificacion: "Fase avanzada"

# ═══════════════════════════════════════════════════════════════════════════════
# GAPS Y ACCIONES REQUERIDAS
# ═══════════════════════════════════════════════════════════════════════════════

gaps:
  documentacion:
    modulos_sin_requerimientos:
      - MAI-002
      - MAI-004
      - MAI-005
      - MAI-007
      - MAI-008
      - MAI-009
      - MAI-010
      - MAI-013
      - MAI-014
      - MAI-015
      - MAE-017
      - MAE-018
    total: 12
    accion: "Crear REQUERIMIENTOS.md por modulo"

  backend:
    entities_especializadas_faltantes: 58
    services_faltantes: "todos los propios"
    dtos_faltantes: "todos los propios"
    accion: "Implementar entities, services y DTOs"

  coherencia:
    ddl_sin_entity: 54
    entity_sin_service: 44
    accion: "Completar implementacion backend"

# ═══════════════════════════════════════════════════════════════════════════════
# REFERENCIAS A OTROS INVENTARIOS
# ═══════════════════════════════════════════════════════════════════════════════

referencias:
  - archivo: DATABASE_INVENTORY.yml
    descripcion: "Detalle de DDL y schemas"
    ultima_actualizacion: "2026-01-25"

  - archivo: BACKEND_INVENTORY.yml
    descripcion: "Detalle de entities y modulos backend"
    ultima_actualizacion: "2026-01-27"

  - archivo: ../docs/_definitions/ENTITIES-CATALOG.md
    descripcion: "Catalogo detallado de entities"
    ultima_actualizacion: "2026-01-27"

  - archivo: ../docs/_definitions/MODULES-CATALOG.md
    descripcion: "Catalogo de modulos"
    ultima_actualizacion: "2026-01-26"

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

historial:
  - fecha: "2026-01-27"
    autor: "AUDITOR"
    cambio: "Creacion inicial como parte de Auditoria Fase 0"