erp-transportistas-v2/docs/00-vision-general/VISION-ERP-TRANSPORTISTAS.md
Adrian Flores Cortes 37ed0aa919 feat: Initial project structure for ERP Transportistas
Vertical ERP for freight transport and logistics companies.

Includes:
- Project configuration (CLAUDE.md, SIMCO orchestration)
- Backend submodule (NestJS 10.x)
- Frontend submodule (React 18.x + Vite)
- Database submodule (PostgreSQL 15 + PostGIS)
- Requirements documentation (REQ-GIRO-TRANSPORTISTA.md)
- 20 modules defined (MAI/MAE/MAA phases)

Key features:
- Transport orders (OT) management
- Fleet and driver management
- Real-time GPS tracking
- POD (Proof of Delivery)
- CFDI with Carta Porte 3.1 compliance
- Fuel and maintenance control
- Third-party carrier management

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-25 09:53:54 -06:00

4.1 KiB

Vision ERP Transportistas

Version: 1.0.0 Fecha: 2026-01-25 Estado: Aprobado


Resumen Ejecutivo

ERP Transportistas es una solucion vertical especializada para empresas de autotransporte de carga, operadores logisticos y 3PL (Third-Party Logistics). El sistema integra todas las operaciones del negocio de transporte, desde la captacion de ordenes hasta la facturacion con CFDI y Carta Porte, pasando por tracking en tiempo real, control de flota y gestion de costos.


Objetivo del Producto

Proveer una plataforma integral que permita a las empresas transportistas:

  1. Digitalizar sus operaciones eliminando procesos manuales basados en Excel, WhatsApp y llamadas
  2. Visibilidad en tiempo real de flota, viajes y entregas para operaciones y clientes
  3. Cumplimiento normativo automatizado (Carta Porte 3.1, NOM-087, NOM-068)
  4. Control de costos por viaje, ruta, cliente y unidad
  5. Escalabilidad mediante subcontratacion de carriers con control de calidad

Propuesta de Valor

Problema Actual Solucion ERP Transportistas
Ordenes por telefono/WhatsApp Portal de clientes + API
Tracking manual de unidades GPS integrado + alertas automaticas
POD en papel perdido POD digital con firma y fotos
Facturacion manual compleja CFDI + Carta Porte automatizado
Costos dispersos en hojas Costeo por viaje integrado
Operadores sin control App movil + HOS + checklists
Subcontratacion sin control Portal carriers + scorecard

Usuarios Objetivo

Primarios

  • Empresas de autotransporte de carga (flota propia)
  • Operadores logisticos 3PL
  • Brokers de transporte

Secundarios

  • Shippers (clientes que contratan transporte)
  • Carriers aliados (subcontratados)

Tamano de Empresa

  • PYME: 5-50 unidades
  • Mediana: 50-200 unidades
  • Enterprise: 200+ unidades

Alcance del MVP

Incluido en MVP (Fase 1)

  • Gestion de clientes y tarifas
  • Ordenes de transporte con restricciones
  • Planeacion y asignacion basica
  • Despacho con checklists digitales
  • Tracking GPS basico
  • POD digital
  • Facturacion con CFDI + Carta Porte
  • Gestion basica de flota

Fuera del MVP (Fases 2-3)

  • Optimizacion de rutas con IA
  • Prediccion de ETA avanzada
  • EDI con clientes
  • Analitica predictiva de mantenimiento
  • App movil nativa (solo PWA en MVP)

Diferenciadores Competitivos

  1. Carta Porte nativo: No es un "addon", esta integrado desde el diseno
  2. Multi-tenant SaaS: Mismo codigo para multiples empresas
  3. Hereda de erp-core: Contabilidad, CRM, RRHH ya resueltos
  4. API-first: Integracion con cualquier GPS, PAC, ERP cliente
  5. Offline-first mobile: Opera en carretera sin conexion

Metricas de Exito

Metrica Objetivo
Time to POD < 2 horas post-entrega
On-time delivery > 95%
Costo de operacion -15% vs manual
Tiempo de facturacion < 24 horas
NPS clientes > 50

Roadmap de Alto Nivel

Q1 2026 - MVP

  • Core: OT, Viajes, Tracking, POD
  • Compliance: Carta Porte 3.1
  • Integracion: GPS, PAC

Q2 2026 - Control de Costos

  • Combustible, peajes, viaticos
  • Mantenimiento preventivo
  • Liquidacion operadores

Q3 2026 - Optimizacion

  • Consolidacion inteligente
  • Prediccion de ETA
  • Portal cliente completo

Q4 2026 - Enterprise

  • EDI con clientes
  • Analitica avanzada
  • App movil nativa

Restricciones y Supuestos

Restricciones

  • Cumplimiento con Carta Porte 3.1 es mandatorio
  • Multi-tenant desde dia 1
  • Hereda modulos de erp-core sin modificarlos

Supuestos

  • Cliente tiene acceso a GPS/telematica
  • Operadores tienen smartphone basico
  • Conectividad intermitente en carretera

Riesgos Principales

Riesgo Probabilidad Impacto Mitigacion
Cambios en Carta Porte Media Alto Arquitectura flexible
Integracion GPS fallida Media Alto Abstraccion de proveedores
Adopcion de operadores Alta Medio UX simplificado, capacitacion
Performance tracking Media Alto Redis + batch processing

ERP Transportistas - Vision v1.0.0