# METADATA.yml - TASK-2026-01-25-DOCUMENTACION-MODULOS
# Sistema SIMCO v4.0.0

task_id: TASK-2026-01-25-DOCUMENTACION-MODULOS
title: "Documentacion de Modulos y Entidades de ERP Transportistas"
type: documentation
priority: P0
status: completed

# Fechas
created: 2026-01-25
started: 2026-01-25
completed: 2026-01-25

# Asignacion
owner: claude-code
project: erp-transportistas

# Contexto
descripcion: |
  Crear documentacion SIMCO completa para ERP Transportistas:
  - Inventarios actualizados (DATABASE, BACKEND, FRONTEND)
  - Documentacion de 11 entidades nuevas (combustible-gastos, tarifas-transporte)
  - Especificaciones de modulos prioritarios (MAI-003, MAI-006, MAI-009, MAI-011, MAE-016)
  - Actualizacion de PROXIMA-ACCION.md

# Alcance
scope:
  entidades_nuevas: 11
  modulos_prioritarios: 5
  inventarios_a_crear: 3

  entidades_combustible_gastos:
    - carga-combustible.entity.ts
    - cruce-peaje.entity.ts
    - gasto-viaje.entity.ts
    - anticipo-viatico.entity.ts
    - control-rendimiento.entity.ts

  entidades_tarifas_transporte:
    - lane.entity.ts
    - tarifa.entity.ts
    - recargo-catalogo.entity.ts
    - factura-transporte.entity.ts
    - linea-factura.entity.ts
    - fuel-surcharge.entity.ts

  modulos_prioritarios:
    - MAI-003: Ordenes de Transporte
    - MAI-006: Tracking
    - MAI-009: Facturacion Transporte
    - MAI-011: Gestion de Flota
    - MAE-016: Carta Porte CFDI

# Fases
phases:
  - id: FASE-1
    title: "Crear inventarios base"
    status: completed
    completed_date: 2026-01-25
    entregables:
      - orchestration/inventarios/DATABASE_INVENTORY.yml
      - orchestration/inventarios/BACKEND_INVENTORY.yml
    notas: "MASTER_INVENTORY.yml pendiente para siguiente iteracion"

  - id: FASE-2
    title: "Documentar entidades nuevas"
    status: completed
    completed_date: 2026-01-25
    entregables:
      - docs/02-definicion-modulos/MAI-012-combustible-gastos/ENTITIES.md
      - docs/02-definicion-modulos/MAI-009-facturacion-transporte/ENTITIES.md
    notas: "11 entidades documentadas con campos, indices, ENUMs y helpers"

  - id: FASE-3
    title: "Actualizar PROXIMA-ACCION.md"
    status: completed
    completed_date: 2026-01-25
    entregables:
      - orchestration/PROXIMA-ACCION.md
    notas: "Estado actual 45% completado documentado"

# Metodologia
methodology: CAPVED
validation_checklist:
  - "Inventarios creados con estructura SIMCO"
  - "Entidades documentadas con campos y relaciones"
  - "PROXIMA-ACCION.md actualizado con estado real"

# Trazabilidad
traceability:
  previous_task: TASK-2026-01-25-001-CREAR-PROYECTO
  related_modules:
    - MAI-009 (Facturacion Transporte)
    - MAI-012 (Combustible y Gastos)