# CONTEXT-MAP.yml - ERP Transportistas
# Mapa de contexto del proyecto
# Sistema SIMCO v4.0.0 + NEXUS v4.0

version: "1.0.0"
project: "erp-transportistas"
updated: "2026-01-25"

# ═══════════════════════════════════════════════════════════════════════════════
# NIVELES DE CONTEXTO
# ═══════════════════════════════════════════════════════════════════════════════

context_levels:

  L0_sistema:
    descripcion: "Contexto global del workspace"
    archivos:
      - path: "../../CLAUDE.md"
        alias: "@WORKSPACE"
        carga: "automatica"
      - path: "../../orchestration/directivas/principios/PRINCIPIO-CAPVED.md"
        alias: "@CAPVED"
        carga: "automatica"
      - path: "../../orchestration/directivas/simco/SIMCO-GIT.md"
        alias: "@GIT"
        carga: "automatica"

  L1_proyecto:
    descripcion: "Contexto del proyecto ERP Transportistas"
    archivos:
      - path: "./CLAUDE.md"
        alias: "@PROJECT"
        carga: "automatica"
      - path: "./.claude/constants/CONSTANTS-PROJECT.yml"
        alias: "@CONSTANTS"
        carga: "automatica"
      - path: "./PROJECT-STATUS.md"
        alias: "@STATUS"
        carga: "bajo_demanda"
      - path: "./docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md"
        alias: "@REQS"
        carga: "bajo_demanda"

  L2_operacion:
    descripcion: "Contexto por tipo de operacion"
    tipos:
      ddl:
        archivos:
          - path: "./database/ddl/"
            alias: "@DDL"
      backend:
        archivos:
          - path: "./backend/src/modules/"
            alias: "@MODULES"
      frontend:
        archivos:
          - path: "./frontend/src/"
            alias: "@FRONTEND"
      docs:
        archivos:
          - path: "./docs/"
            alias: "@DOCS"

  L3_tarea:
    descripcion: "Contexto especifico de tarea"
    dinamico: true
    ubicacion: "./orchestration/tareas/"

# ═══════════════════════════════════════════════════════════════════════════════
# DOMINIOS DE NEGOCIO
# ═══════════════════════════════════════════════════════════════════════════════

business_domains:

  transport:
    descripcion: "Gestion de ordenes, embarques y viajes"
    schema: "transport"
    modulos:
      - MAI-002
      - MAI-003
      - MAI-004
      - MAI-005
      - MAI-007
      - MAI-008
      - MAI-009
    entidades:
      - OrdenTransporte
      - Embarque
      - Viaje
      - ParadaViaje
      - POD

  fleet:
    descripcion: "Gestion de flota y operadores"
    schema: "fleet"
    modulos:
      - MAI-011
      - MAI-013
    entidades:
      - Unidad
      - Remolque
      - Operador
      - LicenciaOperador
      - DocumentoUnidad

  tracking:
    descripcion: "Tracking y visibilidad en tiempo real"
    schema: "tracking"
    modulos:
      - MAI-006
    entidades:
      - EventoTracking
      - Geocerca
      - Alerta

  fuel:
    descripcion: "Control de combustible y gastos"
    schema: "fuel"
    modulos:
      - MAI-012
    entidades:
      - CargaCombustible
      - CrucePeaje
      - GastoViaje

  maintenance:
    descripcion: "Mantenimiento de flota"
    schema: "maintenance"
    modulos:
      - MAI-013
    entidades:
      - OrdenMantenimiento
      - PlanPreventivo
      - HistorialMantenimiento

  carriers:
    descripcion: "Gestion de terceros"
    schema: "carriers"
    modulos:
      - MAI-014
    entidades:
      - Carrier
      - DocumentoCarrier
      - ScorecardCarrier

  billing:
    descripcion: "Tarifas y facturacion"
    schema: "billing"
    modulos:
      - MAI-002
      - MAI-009
    entidades:
      - Tarifa
      - Recargo
      - FacturaTransporte

  compliance:
    descripcion: "Cumplimiento normativo"
    schema: "compliance"
    modulos:
      - MAE-016
      - MAE-017
    entidades:
      - CartaPorte
      - BitacoraHOS
      - InspeccionUnidad

# ═══════════════════════════════════════════════════════════════════════════════
# ALIASES RAPIDOS
# ═══════════════════════════════════════════════════════════════════════════════

aliases:
  # Estructura
  "@BACKEND": "backend/src/"
  "@FRONTEND": "frontend/src/"
  "@DDL": "database/ddl/"
  "@DOCS": "docs/"
  "@MODULOS": "docs/02-definicion-modulos/"
  "@ORCHESTRATION": "orchestration/"

  # Configuracion
  "@CONSTANTS": ".claude/constants/CONSTANTS-PROJECT.yml"
  "@STATUS": "PROJECT-STATUS.md"
  "@INVENTORY": "INVENTARIO.yml"

  # Requerimientos
  "@REQS": "docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md"
  "@VISION": "docs/00-vision-general/VISION-ERP-TRANSPORTISTAS.md"

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

metadata:
  created_by: "META-ORQUESTADOR"
  created_at: "2026-01-25"