erp-transportistas-v2/orchestration/PROXIMA-ACCION.md
Adrian Flores Cortes 4c538eef9c [TASK-2026-02-03-PLAN-DEMO] docs: Update PROXIMA-ACCION with demo cycle reference
- Added reference to FEATURE-DEMO-2026-Q1Q2
- Updated progress: Backend 60%, Frontend 20%, Mobile 80%
- Listed 10 demo tasks (TRANS-D-001 to TRANS-D-010) with 102 SP total
- Documented completed sprints S1-S8

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 04:14:25 -06:00

329 lines
13 KiB
Markdown

# PROXIMA-ACCION.md - ERP Transportistas
**Ultima Actualizacion:** 2026-02-03
**Sistema:** SIMCO v4.0.0
**Estado del Proyecto:** 65% completado | DDL 100% | Docs 100% | Backend 60% | Frontend 20% | Mobile 80%
---
## ⚡ CICLO DEMO ACTIVO
**Plan Maestro:** `@PLAN-DEMO-2026``workspace-v2/orchestration/planes/PLAN-DEMO-CICLO-2026-Q1Q2.md`
**Feature:** `workspace-v2/orchestration/tareas/FEATURE-DEMO-2026-Q1Q2/`
**Objetivo:** Llevar de 65% → 85% para DEMO-READY
### Tareas del Ciclo (erp-transportistas)
| ID | Tarea | SP | Estado |
|----|-------|----:|--------|
| TRANS-D-001 | MAI-003 Órdenes de Transporte backend | 13 | PENDIENTE |
| TRANS-D-002 | MAI-002 Clientes y Tarifas backend | 8 | PENDIENTE |
| TRANS-D-003 | **MAE-016 Carta Porte CFDI 3.1** | 21 | PENDIENTE |
| TRANS-D-004 | Tests GPS, Dispatch, Offline | 8 | PENDIENTE |
| TRANS-D-005 | UI Órdenes de Transporte | 13 | PENDIENTE |
| TRANS-D-006 | UI Clientes y Tarifas | 8 | PENDIENTE |
| TRANS-D-007 | UI Carta Porte | 13 | PENDIENTE |
| TRANS-D-008 | Completar App Mobile | 8 | PENDIENTE |
| TRANS-D-009 | WhatsApp Notificaciones | 5 | PENDIENTE |
| TRANS-D-010 | Validación E2E | 5 | PENDIENTE |
**Total:** 102 SP / 15 sprints estimados
### Progreso Actualizado (2026-02-03)
| Capa | Progreso Anterior | Progreso Actual | Delta |
|------|-------------------|-----------------|-------|
| DDL | 100% | 100% | - |
| Backend | 15% | 60% | +45% |
| Frontend | 0% | 20% | +20% |
| Mobile | 0% | 80% | +80% |
**Sprints completados desde 2026-01-27:**
- S1: GPS Backend ✅
- S2: Dispatch Backend ✅
- S3: Integración GPS-Dispatch ✅
- S4: Offline Backend ✅
- S5: WhatsApp Backend ✅
- S6: Dashboard Despacho Frontend ✅
- S7: Tracking Map Components ✅
- S8: App Expo Mobile ✅
---
---
## Estado Actual (2026-01-27)
### DOCUMENTACION COMPLETA
La fase de documentacion funcional y tecnica ha sido completada exitosamente:
| Fase | Estado | Entregables |
|------|--------|-------------|
| Fase 2: Modulos Criticos (P0) | COMPLETO | 10 modulos especificados |
| Fase 3: Modulos Secundarios | COMPLETO | 7 modulos especificados |
| Fase 4: Arquitectura | COMPLETO | Flujo E2E, integraciones, RBAC, KPIs |
| Fase 5: Matrices | COMPLETO | 4 matrices de trazabilidad |
| Fase 6: Validacion | COMPLETO | PROJECT-STATUS actualizado |
| Fase 7: Gaps GPS/Dispatch | COMPLETO | ANALISIS-GAPS.md |
| Fase 8: Planes Implementacion | COMPLETO | PLAN-COPIA-GPS/DISPATCH, ROADMAP |
### Tarea Activa: TASK-007
| Entregable | Estado | Ubicacion |
|------------|--------|-----------|
| ANALISIS-GAPS.md | COMPLETO | orchestration/tareas/2026-01-27/TASK-007-.../ |
| INTEGRACION-GPS-PROVIDERS.md | COMPLETO | docs/30-integraciones/ |
| README.md (Despacho) | COMPLETO | docs/02-definicion-modulos/MAI-005-despacho/ |
| SINCRONIZACION-OFFLINE.md | COMPLETO | docs/10-arquitectura/ |
| ARQUITECTURA-GPS.md | COMPLETO | docs/10-arquitectura/ |
| PLAN-COPIA-GPS.md | COMPLETO | orchestration/tareas/2026-01-27/TASK-007-.../ |
| PLAN-COPIA-DISPATCH.md | COMPLETO | orchestration/tareas/2026-01-27/TASK-007-.../ |
| ROADMAP-IMPLEMENTACION.md | COMPLETO | orchestration/tareas/2026-01-27/TASK-007-.../ |
### Progreso General
| Capa | Progreso | Notas |
|------|----------|-------|
| DDL | 100% | 8 schemas, ~58 tablas |
| Documentacion Funcional | 100% | 18 modulos, 69 US, 403 SP |
| Documentacion Tecnica | 100% | Arquitectura, RBAC, KPIs, matrices, integraciones |
| Backend | 15% | Entities base copiadas, modulos GPS/Dispatch pendientes |
| Frontend | 0% | Pendiente |
### Metricas de Documentacion Actualizadas
| Metrica | Valor Anterior | Valor Actual |
|---------|----------------|--------------|
| Modulos especificados | 18/20 | 20/20 |
| User Stories | 54 | 69 (+15 GPS/Dispatch/Offline) |
| Story Points | 325 | 403 (+78) |
| Requerimientos funcionales | 78 | 93 (+15) |
| KPIs definidos | 17 | 17 |
| Roles RBAC | 16 | 16 |
| Integraciones documentadas | 5 | 8 (+3: GPS providers, WhatsApp, Offline) |
---
## Proximas Acciones
### P0 - Inmediato: Sprint 1-2 (36h)
#### Sprint 1: Modulo GPS Backend (16h)
| # | Tarea | Esfuerzo | Estado |
|---|-------|----------|--------|
| 1 | Crear estructura carpetas backend/src/modules/gps/ | 0.5h | PENDIENTE |
| 2 | Copiar entities GPS de erp-mecanicas-diesel | 1.0h | PENDIENTE |
| 3 | Adaptar entities (FK fleet.unidades, schema tracking) | 2.0h | PENDIENTE |
| 4 | Crear DDL: dispositivos_gps, eventos_geocerca, segmentos_ruta | 1.5h | PENDIENTE |
| 5 | Ejecutar migraciones DDL en PostgreSQL | 0.5h | PENDIENTE |
| 6 | Copiar y adaptar services GPS | 2.5h | PENDIENTE |
| 7 | Copiar y adaptar controllers GPS | 1.5h | PENDIENTE |
| 8 | Registrar GpsModule en app.module.ts | 0.5h | PENDIENTE |
| 9 | Build y lint del backend | 1.0h | PENDIENTE |
| 10 | Tests unitarios basicos GPS | 3.0h | PENDIENTE |
**Referencia:** `PLAN-COPIA-GPS.md`
#### Sprint 2: Modulo Dispatch Backend (20h)
| # | Tarea | Esfuerzo | Estado |
|---|-------|----------|--------|
| 11 | Crear estructura carpetas backend/src/modules/dispatch/ | 0.5h | PENDIENTE |
| 12 | Crear DDL schema despacho completo | 2.0h | PENDIENTE |
| 13 | Crear DDL tablas fleet.certificaciones_operador y turnos_operador | 1.0h | PENDIENTE |
| 14 | Ejecutar migraciones DDL | 0.5h | PENDIENTE |
| 15 | Copiar entities Dispatch | 1.0h | PENDIENTE |
| 16 | Renombrar TechnicianSkill -> OperadorCertificacion | 1.0h | PENDIENTE |
| 17 | Renombrar TechnicianShift -> TurnoOperador | 1.0h | PENDIENTE |
| 18 | Adaptar entities (incident -> viaje, FK a transport.viajes) | 2.0h | PENDIENTE |
| 19 | Copiar services Dispatch | 1.0h | PENDIENTE |
| 20 | Adaptar algoritmo scoring para transporte | 4.0h | PENDIENTE |
| 21 | Copiar y adaptar controllers Dispatch | 1.5h | PENDIENTE |
| 22 | Build, lint y tests | 4.0h | PENDIENTE |
**Referencia:** `PLAN-COPIA-DISPATCH.md`
---
### P1 - Corto Plazo: Sprint 3-5 (44h)
#### Sprint 3: Integracion GPS-Dispatch (12h)
| # | Tarea | Esfuerzo | Estado |
|---|-------|----------|--------|
| 23 | Inyectar GpsDeviceService en DispatchService | 1.0h | PENDIENTE |
| 24 | Obtener posicion real en suggestBestAssignment | 2.0h | PENDIENTE |
| 25 | Verificar geocerca origen en asignacion | 2.0h | PENDIENTE |
| 26 | Sincronizar UnitStatus con ultima posicion GPS | 2.0h | PENDIENTE |
| 27 | Calcular distancia ruta real (no lineal) | 2.0h | PENDIENTE |
| 28 | Tests de integracion GPS-Dispatch | 3.0h | PENDIENTE |
#### Sprint 4: Modo Offline Basico (24h)
| # | Tarea | Esfuerzo | Estado |
|---|-------|----------|--------|
| 29 | Disenar arquitectura sync queue | 2.0h | PENDIENTE |
| 30 | Crear entidad OfflineQueue | 2.0h | PENDIENTE |
| 31 | Implementar OfflineStorageService | 4.0h | PENDIENTE |
| 32 | Implementar SyncService con cola prioritaria | 4.0h | PENDIENTE |
| 33 | Crear endpoints de sincronizacion | 2.0h | PENDIENTE |
| 34 | Implementar deteccion de conectividad | 2.0h | PENDIENTE |
| 35 | Implementar resolucion de conflictos | 4.0h | PENDIENTE |
| 36 | Tests offline | 4.0h | PENDIENTE |
#### Sprint 5: WhatsApp Templates (8h)
| # | Tarea | Esfuerzo | Estado |
|---|-------|----------|--------|
| 37 | Disenar templates segun WHATSAPP-TEMPLATES.yml | 2.0h | PENDIENTE |
| 38 | Registrar templates en Meta Business | 1.0h | PENDIENTE |
| 39 | Crear WhatsAppNotificationService | 2.0h | PENDIENTE |
| 40 | Integrar con escalamientos Dispatch | 1.5h | PENDIENTE |
| 41 | Tests de notificaciones | 1.5h | PENDIENTE |
---
### P2 - Mediano Plazo: Sprint 6-8 (68h)
#### Sprint 6: Frontend Dashboard Despacho (20h)
| # | Tarea | Esfuerzo | Estado |
|---|-------|----------|--------|
| 42 | Crear pagina DespachoPage con layout | 2.0h | PENDIENTE |
| 43 | Integrar mapa Leaflet | 3.0h | PENDIENTE |
| 44 | Mostrar unidades en mapa con markers por estado | 2.0h | PENDIENTE |
| 45 | Mostrar geocercas en mapa | 2.0h | PENDIENTE |
| 46 | Panel lateral viajes pendientes | 3.0h | PENDIENTE |
| 47 | Modal asignacion con sugerencias | 3.0h | PENDIENTE |
| 48 | WebSocket para actualizaciones tiempo real | 3.0h | PENDIENTE |
| 49 | Tests E2E basicos | 2.0h | PENDIENTE |
#### Sprint 7: Frontend Mapa Tracking (16h)
| # | Tarea | Esfuerzo | Estado |
|---|-------|----------|--------|
| 50 | Crear pagina TrackingPage | 2.0h | PENDIENTE |
| 51 | Mostrar ruta planeada en mapa | 2.0h | PENDIENTE |
| 52 | Mostrar ruta recorrida (polyline) | 2.0h | PENDIENTE |
| 53 | Animacion posicion actual | 2.0h | PENDIENTE |
| 54 | Panel timeline eventos viaje | 2.0h | PENDIENTE |
| 55 | ETA dinamico con barra progreso | 2.0h | PENDIENTE |
| 56 | WebSocket posiciones | 2.0h | PENDIENTE |
| 57 | Tests | 2.0h | PENDIENTE |
#### Sprint 8: App Conductor con Offline (32h)
| # | Tarea | Esfuerzo | Estado |
|---|-------|----------|--------|
| 58 | Setup React Native / Expo | 4.0h | PENDIENTE |
| 59 | Pantalla login offline-first | 3.0h | PENDIENTE |
| 60 | Pantalla viaje actual | 4.0h | PENDIENTE |
| 61 | Captura eventos (llegada, salida, etc) | 4.0h | PENDIENTE |
| 62 | Captura POD con camara | 4.0h | PENDIENTE |
| 63 | GPS background tracking | 4.0h | PENDIENTE |
| 64 | SQLite local storage | 3.0h | PENDIENTE |
| 65 | Sincronizacion con cola | 4.0h | PENDIENTE |
| 66 | Tests en dispositivo | 2.0h | PENDIENTE |
---
## Modulos del Sistema - Estado Actualizado
### Fase 1 - MAI (Inicial)
| Codigo | Nombre | DDL | Docs | Backend | Frontend |
|--------|--------|:---:|:----:|:-------:|:--------:|
| MAI-001 | Fundamentos | - | - | COMPLETO | - |
| MAI-002 | Clientes y Tarifas | COMPLETO | COMPLETO | 0% | 0% |
| MAI-003 | Ordenes de Transporte | COMPLETO | COMPLETO | 10% | 0% |
| MAI-004 | Planeacion TMS | COMPLETO | COMPLETO | 0% | 0% |
| MAI-005 | Despacho | COMPLETO | COMPLETO | 0% -> S2 | 0% -> S6 |
| MAI-006 | Tracking (GPS) | COMPLETO | COMPLETO | 5% -> S1 | 0% -> S7 |
| MAI-007 | POD y Cierre | COMPLETO | COMPLETO | 0% | 0% |
| MAI-008 | Incidencias | COMPLETO | COMPLETO | 0% | 0% |
| MAI-009 | Facturacion Transporte | COMPLETO | COMPLETO | 15% | 0% |
| MAI-010 | Liquidaciones | COMPLETO | COMPLETO | 0% | 0% |
| MAI-011 | Gestion de Flota | COMPLETO | COMPLETO | 10% | 0% |
| MAI-012 | Combustible y Gastos | COMPLETO | COMPLETO | 20% | 0% |
| MAI-013 | Mantenimiento Flota | COMPLETO | COMPLETO | 0% | 0% |
| MAI-014 | Carriers (Terceros) | COMPLETO | COMPLETO | 0% | 0% |
| MAI-015 | Portal Cliente | COMPLETO | COMPLETO | 0% | 0% |
### Fase 2 - MAE (Extendido)
| Codigo | Nombre | DDL | Docs | Backend | Frontend |
|--------|--------|:---:|:----:|:-------:|:--------:|
| MAE-016 | Carta Porte CFDI | COMPLETO | COMPLETO | 10% | 0% |
| MAE-017 | HOS y Bitacora | COMPLETO | COMPLETO | 0% | 0% |
| MAE-018 | Reportes y KPIs | COMPLETO | COMPLETO | 0% | 0% |
| MAE-019 | Modo Offline | NUEVO | COMPLETO | 0% -> S4 | 0% -> S8 |
| MAE-020 | Integracion WhatsApp | NUEVO | COMPLETO | 0% -> S5 | - |
### Fase 3 - MAA (Avanzado)
| Codigo | Nombre | DDL | Docs | Backend | Frontend |
|--------|--------|:---:|:----:|:-------:|:--------:|
| MAA-021 | Optimizacion Rutas | - | - | 0% | 0% |
| MAA-022 | Integraciones EDI | - | - | 0% | 0% |
---
## Calendario de Sprints
| Sprint | Fecha Inicio | Fecha Fin | Modulo Principal | Horas |
|--------|--------------|-----------|------------------|-------|
| S1 | 2026-01-28 | 2026-01-31 | GPS Backend | 16 |
| S2 | 2026-02-03 | 2026-02-07 | Dispatch Backend | 20 |
| S3 | 2026-02-10 | 2026-02-12 | Integracion GPS-Dispatch | 12 |
| S4 | 2026-02-13 | 2026-02-19 | Offline Basico | 24 |
| S5 | 2026-02-20 | 2026-02-21 | WhatsApp Templates | 8 |
| S6 | 2026-02-24 | 2026-02-28 | Dashboard Despacho | 20 |
| S7 | 2026-03-03 | 2026-03-05 | Mapa Tracking | 16 |
| S8 | 2026-03-06 | 2026-03-14 | App Conductor | 32 |
**Total:** 148 horas de desarrollo
---
## Archivos de Referencia
| Recurso | Ubicacion |
|---------|-----------|
| PROJECT-STATUS.md | `PROJECT-STATUS.md` |
| TASK-007 Documentos | `orchestration/tareas/2026-01-27/TASK-007-integracion-definiciones-gps-core/` |
| PLAN-COPIA-GPS.md | `orchestration/tareas/2026-01-27/TASK-007-integracion-definiciones-gps-core/PLAN-COPIA-GPS.md` |
| PLAN-COPIA-DISPATCH.md | `orchestration/tareas/2026-01-27/TASK-007-integracion-definiciones-gps-core/PLAN-COPIA-DISPATCH.md` |
| ROADMAP-IMPLEMENTACION.md | `orchestration/tareas/2026-01-27/TASK-007-integracion-definiciones-gps-core/ROADMAP-IMPLEMENTACION.md` |
| Requerimientos | `docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md` |
| Modulos | `docs/02-definicion-modulos/` |
| Arquitectura | `docs/10-arquitectura/FLUJO-PRINCIPAL-TRANSPORTE.md` |
| GPS Multi-Provider | `docs/30-integraciones/INTEGRACION-GPS-PROVIDERS.md` |
| Dispatch Center | `docs/02-definicion-modulos/MAI-005-despacho/README.md` |
| Offline Sync | `docs/10-arquitectura/SINCRONIZACION-OFFLINE.md` |
| Arquitectura GPS | `docs/10-arquitectura/ARQUITECTURA-GPS.md` |
| Arquitectura Dispatch | `docs/10-arquitectura/ARQUITECTURA-DISPATCH.md` |
| Frontend Docs | `docs/20-frontend/README.md` |
| RBAC | `docs/40-estandares/MATRIZ-RBAC-TRANSPORTISTAS.yml` |
| KPIs | `docs/40-estandares/ESPECIFICACION-KPIS.yml` |
| Matrices | `orchestration/matrices/` |
| DDL | `database/ddl/` |
---
## Historial de Cambios
| Fecha | Cambio |
|-------|--------|
| 2026-01-27 | Agregados planes de implementacion GPS/Dispatch/Offline (TASK-007) |
| 2026-01-27 | Actualizado metricas: 69 US, 403 SP, 20 modulos |
| 2026-01-27 | Agregado calendario de sprints S1-S8 |
| 2026-01-27 | Documentacion completa (Fase 2-6): 18 modulos, 54 US, arquitectura, matrices |
| 2026-01-27 | Correccion porcentajes tras auditoria |
| 2026-01-25 | Creacion inicial |
---
*Sistema SIMCO v4.0.0 - ERP Transportistas*