# ═══════════════════════════════════════════════════════════════════════════════
# CONSTANTES DEL PROYECTO: ERP Transportistas
# ═══════════════════════════════════════════════════════════════════════════════

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

# ─────────────────────────────────────────────────────────────────────────────────
# IDENTIFICACION
# ─────────────────────────────────────────────────────────────────────────────────

identificacion:
  nombre: "ERP Transportistas"
  slug: "erp-transportistas"
  tipo: "CONSUMER"
  estado: "desarrollo"
  version: "1.0.0"
  descripcion: "Vertical ERP para empresas de transporte de carga y logistica"
  giro: "Autotransporte de carga / 3PL / Logistica"

# ─────────────────────────────────────────────────────────────────────────────────
# BASE DE DATOS
# ─────────────────────────────────────────────────────────────────────────────────

database:
  nombre: "erp_transportistas_db"
  tipo: "postgresql"
  version: "15"
  schemas:
    - "public"
    - "transport"
    - "fleet"
    - "tracking"
    - "fuel"
    - "maintenance"
    - "carriers"
    - "billing"
    - "compliance"

# ─────────────────────────────────────────────────────────────────────────────────
# TECNOLOGIAS
# ─────────────────────────────────────────────────────────────────────────────────

stack:
  backend:
    framework: "nestjs"
    version: "10.x"
    language: "typescript"
  frontend:
    framework: "react"
    version: "18.x"
    language: "typescript"
  database:
    engine: "postgresql"
    version: "15"
    extensions:
      - "postgis"  # Para geolocalizacion de rutas/unidades

# ─────────────────────────────────────────────────────────────────────────────────
# HERENCIA
# ─────────────────────────────────────────────────────────────────────────────────

herencia:
  tipo: "CONSUMER"
  hereda_de:
    - "workspace-v2/orchestration/"
    - "projects/erp-core/"
  exporta_a: []

# ─────────────────────────────────────────────────────────────────────────────────
# MODULOS ESPECIFICOS DEL GIRO
# ─────────────────────────────────────────────────────────────────────────────────

modulos_especificos:
  # Fase 1 - MAI (Modulo Aplicacion Inicial)
  - nombre: "clientes-tarifas"
    codigo: "MAI-002"
    descripcion: "Gestion de shippers, tarifas por lane, SLAs"
  - nombre: "ordenes-transporte"
    codigo: "MAI-003"
    descripcion: "Ordenes de transporte con restricciones logisticas"
  - nombre: "planeacion-tms"
    codigo: "MAI-004"
    descripcion: "Consolidacion, capacidad, asignacion de recursos"
  - nombre: "despacho"
    codigo: "MAI-005"
    descripcion: "Checklists pre-viaje, sellos, evidencias, liberacion"
  - nombre: "tracking"
    codigo: "MAI-006"
    descripcion: "GPS, eventos en tiempo real, alertas, ETA"
  - nombre: "pod-cierre"
    codigo: "MAI-007"
    descripcion: "Proof of Delivery, tiempos reales, cierre operativo"
  - nombre: "incidencias"
    codigo: "MAI-008"
    descripcion: "Reclamaciones, flujo de atencion, impacto economico"
  - nombre: "facturacion-transporte"
    codigo: "MAI-009"
    descripcion: "Tarifas, recargos, detention, fuel surcharge"
  - nombre: "liquidaciones"
    codigo: "MAI-010"
    descripcion: "Pago a operadores, viaticos, deducciones"
  - nombre: "gestion-flota"
    codigo: "MAI-011"
    descripcion: "Unidades, remolques, operadores, documentacion"
  - nombre: "combustible-gastos"
    codigo: "MAI-012"
    descripcion: "Control de combustible, peajes, gastos de viaje"
  - nombre: "mantenimiento-flota"
    codigo: "MAI-013"
    descripcion: "Preventivo, correctivo, disponibilidad"
  - nombre: "carriers-terceros"
    codigo: "MAI-014"
    descripcion: "Subcontratacion, documentos, scorecard"
  - nombre: "portal-cliente"
    codigo: "MAI-015"
    descripcion: "Tracking, documentos, autoservicio"

  # Fase 2 - MAE (Modulo Aplicacion Extendido)
  - nombre: "carta-porte-cfdi"
    codigo: "MAE-016"
    descripcion: "CFDI con complemento Carta Porte 3.1"
  - nombre: "hos-bitacora"
    codigo: "MAE-017"
    descripcion: "Horas de servicio, NOM-087, bitacora electronica"
  - nombre: "reportes-kpis"
    codigo: "MAE-018"
    descripcion: "OTIF, costo/km, disponibilidad, scorecards"

  # Fase 3 - MAA (Modulo Aplicacion Avanzado)
  - nombre: "optimizacion-rutas"
    codigo: "MAA-019"
    descripcion: "Optimizacion de rutas, prediccion de ETA"
  - nombre: "integraciones-edi"
    codigo: "MAA-020"
    descripcion: "API clientes, EDI, intercambio de datos"

# ─────────────────────────────────────────────────────────────────────────────────
# ENTIDADES PRINCIPALES
# ─────────────────────────────────────────────────────────────────────────────────

entidades_principales:
  - nombre: "OrdenTransporte"
    schema: "transport"
    descripcion: "Solicitud de servicio de transporte"
  - nombre: "Embarque"
    schema: "transport"
    descripcion: "Agrupacion logica de OTs para ejecucion"
  - nombre: "Viaje"
    schema: "transport"
    descripcion: "Ejecucion operativa (unidad + operador + ruta)"
  - nombre: "Unidad"
    schema: "fleet"
    descripcion: "Tractora, remolque, caja"
  - nombre: "Operador"
    schema: "fleet"
    descripcion: "Conductor con licencias y skills"
  - nombre: "Tarifa"
    schema: "billing"
    descripcion: "Precio por lane/servicio/equipo"
  - nombre: "EventoTracking"
    schema: "tracking"
    descripcion: "Posicion GPS y eventos de viaje"
  - nombre: "POD"
    schema: "transport"
    descripcion: "Proof of Delivery con evidencias"
  - nombre: "CartaPorte"
    schema: "compliance"
    descripcion: "CFDI con complemento Carta Porte"

# ─────────────────────────────────────────────────────────────────────────────────
# VARIABLES DE ENTORNO REQUERIDAS
# ─────────────────────────────────────────────────────────────────────────────────

env_required:
  - "DATABASE_URL"
  - "JWT_SECRET"
  - "REDIS_URL"
  - "PAC_URL"           # Proveedor de timbrado CFDI
  - "PAC_USER"
  - "PAC_PASSWORD"
  - "GPS_PROVIDER_URL"  # Proveedor de telematica
  - "GPS_API_KEY"
  - "MAPS_API_KEY"      # Google Maps / HERE / similar

# ─────────────────────────────────────────────────────────────────────────────────
# INTEGRACIONES EXTERNAS
# ─────────────────────────────────────────────────────────────────────────────────

integraciones:
  - nombre: "GPS/Telematica"
    tipo: "api"
    descripcion: "Recepcion de posiciones y eventos de unidades"
  - nombre: "PAC (SAT)"
    tipo: "api"
    descripcion: "Timbrado CFDI con Carta Porte"
  - nombre: "Mapas/Geocoding"
    tipo: "api"
    descripcion: "Calculo de distancias, geocodificacion, ETA"
  - nombre: "WhatsApp/SMS"
    tipo: "api"
    descripcion: "Notificaciones a clientes y operadores"
  - nombre: "Tarjetas Combustible"
    tipo: "archivo"
    descripcion: "Conciliacion de cargas de combustible"
  - nombre: "TAG Peajes"
    tipo: "archivo"
    descripcion: "Conciliacion de cruces de casetas"

# ═══════════════════════════════════════════════════════════════════════════════
# FIN DE CONSTANTES
# ═══════════════════════════════════════════════════════════════════════════════