# PROJECT-PROFILE.yml - ERP Transportistas
# Perfil del proyecto para propagacion y herencia
# Sistema SIMCO v4.0.0

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

# ═══════════════════════════════════════════════════════════════════════════════
# IDENTIFICACION
# ═══════════════════════════════════════════════════════════════════════════════

identification:
  name: "ERP Transportistas"
  slug: "erp-transportistas"
  type: "CONSUMER"
  industry: "Transporte de Carga / Logistica / 3PL"
  version: "1.0.0"

# ═══════════════════════════════════════════════════════════════════════════════
# HERENCIA
# ═══════════════════════════════════════════════════════════════════════════════

inheritance:
  parent: "erp-core"
  grandparent: "template-saas"

  modules_inherited:
    full:
      - auth
      - users
      - roles
      - tenants
      - audit
      - notifications
      - billing
      - plans
      - webhooks
      - feature_flags
      - ai_integration
      - whatsapp_business
      - mcp_server

    extended:
      - catalogs
      - settings
      - financial
      - inventory
      - purchasing
      - sales
      - crm
      - partners
      - reports
      - projects

# ═══════════════════════════════════════════════════════════════════════════════
# MODULOS PROPIOS
# ═══════════════════════════════════════════════════════════════════════════════

own_modules:
  phase_1_mai:
    - code: "MAI-002"
      name: "clientes-tarifas"
      priority: "high"
      dependencies: []

    - code: "MAI-003"
      name: "ordenes-transporte"
      priority: "critical"
      dependencies: ["MAI-002"]

    - code: "MAI-004"
      name: "planeacion-tms"
      priority: "high"
      dependencies: ["MAI-003"]

    - code: "MAI-005"
      name: "despacho"
      priority: "high"
      dependencies: ["MAI-004", "MAI-011"]

    - code: "MAI-006"
      name: "tracking"
      priority: "critical"
      dependencies: ["MAI-005"]

    - code: "MAI-007"
      name: "pod-cierre"
      priority: "high"
      dependencies: ["MAI-006"]

    - code: "MAI-008"
      name: "incidencias"
      priority: "medium"
      dependencies: ["MAI-006"]

    - code: "MAI-009"
      name: "facturacion-transporte"
      priority: "high"
      dependencies: ["MAI-007"]

    - code: "MAI-010"
      name: "liquidaciones"
      priority: "medium"
      dependencies: ["MAI-007"]

    - code: "MAI-011"
      name: "gestion-flota"
      priority: "critical"
      dependencies: []

    - code: "MAI-012"
      name: "combustible-gastos"
      priority: "medium"
      dependencies: ["MAI-011"]

    - code: "MAI-013"
      name: "mantenimiento-flota"
      priority: "medium"
      dependencies: ["MAI-011"]

    - code: "MAI-014"
      name: "carriers-terceros"
      priority: "medium"
      dependencies: ["MAI-003"]

    - code: "MAI-015"
      name: "portal-cliente"
      priority: "low"
      dependencies: ["MAI-006", "MAI-007"]

  phase_2_mae:
    - code: "MAE-016"
      name: "carta-porte-cfdi"
      priority: "critical"
      dependencies: ["MAI-009"]

    - code: "MAE-017"
      name: "hos-bitacora"
      priority: "medium"
      dependencies: ["MAI-011"]

    - code: "MAE-018"
      name: "reportes-kpis"
      priority: "medium"
      dependencies: ["MAI-007"]

  phase_3_maa:
    - code: "MAA-019"
      name: "optimizacion-rutas"
      priority: "low"
      dependencies: ["MAI-004"]

    - code: "MAA-020"
      name: "integraciones-edi"
      priority: "low"
      dependencies: ["MAI-003"]

# ═══════════════════════════════════════════════════════════════════════════════
# ENTIDADES PRINCIPALES
# ═══════════════════════════════════════════════════════════════════════════════

core_entities:
  - name: "OrdenTransporte"
    schema: "transport"
    table: "ordenes_transporte"
    module: "MAI-003"

  - name: "Embarque"
    schema: "transport"
    table: "embarques"
    module: "MAI-003"

  - name: "Viaje"
    schema: "transport"
    table: "viajes"
    module: "MAI-005"

  - name: "Unidad"
    schema: "fleet"
    table: "unidades"
    module: "MAI-011"

  - name: "Remolque"
    schema: "fleet"
    table: "remolques"
    module: "MAI-011"

  - name: "Operador"
    schema: "fleet"
    table: "operadores"
    module: "MAI-011"

  - name: "EventoTracking"
    schema: "tracking"
    table: "eventos_tracking"
    module: "MAI-006"

  - name: "POD"
    schema: "transport"
    table: "pods"
    module: "MAI-007"

  - name: "Tarifa"
    schema: "billing"
    table: "tarifas"
    module: "MAI-002"

  - name: "CartaPorte"
    schema: "compliance"
    table: "cartas_porte"
    module: "MAE-016"

# ═══════════════════════════════════════════════════════════════════════════════
# INTEGRACIONES
# ═══════════════════════════════════════════════════════════════════════════════

integrations:
  required:
    - name: "GPS/Telematica"
      type: "api"
      module: "MAI-006"
      providers: ["Geotab", "Samsara", "CalAmp", "Generic"]

    - name: "PAC (CFDI)"
      type: "api"
      module: "MAE-016"
      providers: ["Finkok", "Facturapi", "SW Sapien"]

    - name: "Mapas"
      type: "api"
      module: "MAI-004"
      providers: ["Google Maps", "HERE", "OpenRouteService"]

  optional:
    - name: "Tarjetas Combustible"
      type: "file"
      module: "MAI-012"

    - name: "TAG Peajes"
      type: "file"
      module: "MAI-012"

# ═══════════════════════════════════════════════════════════════════════════════
# COMPLIANCE
# ═══════════════════════════════════════════════════════════════════════════════

compliance:
  mexico:
    - name: "Carta Porte 3.1"
      authority: "SAT"
      mandatory: true
      module: "MAE-016"

    - name: "NOM-087"
      authority: "SCT"
      mandatory: true
      module: "MAE-017"
      description: "Bitacora de horas de servicio"

    - name: "NOM-068"
      authority: "SCT"
      mandatory: true
      module: "MAI-005"
      description: "Condiciones fisico-mecanicas"

# ═══════════════════════════════════════════════════════════════════════════════
# WORKFLOWS
# ═══════════════════════════════════════════════════════════════════════════════

workflows:
  main:
    name: "Flujo Principal de Viaje"
    states:
      - "BORRADOR"
      - "PLANEADO"
      - "DESPACHADO"
      - "EN_TRANSITO"
      - "EN_DESTINO"
      - "ENTREGADO"
      - "CERRADO"
      - "FACTURADO"
      - "COBRADO"

  incidencia:
    name: "Flujo de Incidencias"
    states:
      - "ABIERTA"
      - "ASIGNADA"
      - "EN_INVESTIGACION"
      - "RESUELTA"
      - "CERRADA"

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

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