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

152 lines
4.1 KiB
Markdown

# 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*