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>
152 lines
4.1 KiB
Markdown
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*
|