erp-transportistas-v2/docs/02-definicion-modulos/MAI-015-portal-cliente/historias-usuario/US-MAI015-001.md
Adrian Flores Cortes ec43d9c6cd docs: Add Phase 3 secondary modules specifications (P1/P2/P3)
Modules documented:
- MAI-003 (OT): README, REQUERIMIENTOS, RESUMEN-EPICA, 10 US
- MAI-006 (Tracking): README, REQUERIMIENTOS, RESUMEN-EPICA
- MAI-008 (Incidencias): 3 US (18 SP)
- MAI-011 (Flota): README, REQUERIMIENTOS, RESUMEN-EPICA
- MAI-012 (Combustible): 3 US (18 SP)
- MAI-013 (Mantenimiento): 3 US (18 SP)
- MAI-014 (Carriers): 3 US (18 SP)
- MAI-015 (Portal): 3 US (18 SP)
- MAE-016 (Carta Porte): 10 US
- MAE-017 (HOS): 3 US (16 SP)
- MAE-018 (Reportes): 3 US (18 SP)

Phase 2+3 complete: 13 modules, 50+ User Stories

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 02:24:35 -06:00

8.6 KiB

US-MAI015-001: Consultar tracking y documentos

ID: US-MAI015-001 Modulo: MAI-015 (Portal Cliente) Prioridad: Alta Story Points: 8


Historia de Usuario

Como usuario cliente Quiero consultar el tracking de mis envios y descargar documentos Para tener visibilidad sin depender del call center


Criterios de Aceptacion

CA-001: Ver lista de envios

Dado que tengo envios activos Cuando accedo al portal Entonces veo lista con estado, origen, destino, ETA

CA-002: Ver tracking en mapa

Dado que un envio esta en transito Cuando lo selecciono Entonces veo posicion en mapa con ruta

CA-003: Ver timeline de eventos

Dado que quiero saber que ha pasado Cuando consulto un envio Entonces veo timeline de eventos (carga, transito, etc.)

CA-004: Descargar POD

Dado que el envio fue entregado Cuando busco documentos Entonces puedo ver y descargar el POD

CA-005: Descargar factura y Carta Porte

Dado que el envio fue facturado Cuando consulto documentos Entonces descargo factura PDF/XML y Carta Porte


Mockup / UI

Dashboard Principal

+----------------------------------------------------------+
| PORTAL CLIENTE - Liverpool SA de CV                      |
+----------------------------------------------------------+
| [Dashboard] [Mis Envios] [Crear OT] [Reclamaciones]     |
+----------------------------------------------------------+
|                                                          |
|  Buenos dias, Maria Gonzalez                            |
|                                                          |
|  +-------------+  +-------------+  +-------------+       |
|  |     3       |  |     2       |  |    12       |       |
|  | En transito |  |  Entregados |  |   Este mes  |       |
|  +-------------+  +-------------+  +-------------+       |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  ENVIOS ACTIVOS                                         |
|                                                          |
|  | Ref.     | Origen    | Destino   | Estado    | ETA  ||
|  |----------|-----------|-----------|-----------|------||
|  | PO-12345 | CDMX      | Monterrey | En transi.| 14:30||
|  | PO-12346 | CDMX      | Guadalaj. | Cargando  | 18:00||
|  | PO-12347 | CDMX      | Queretaro | Asignado  | Manana|
|                                                          |
|  [Ver todos mis envios]                                 |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  ENTREGAS RECIENTES                                     |
|                                                          |
|  | Ref.     | Destino   | Entrega   | POD  | Factura  ||
|  |----------|-----------|-----------|------|----------||
|  | PO-12340 | Leon      | 26-ene    | [Ver]| [Descar.]||
|  | PO-12338 | Tijuana   | 25-ene    | [Ver]| [Descar.]||
|                                                          |
+----------------------------------------------------------+

Tracking en Mapa

+----------------------------------------------------------+
| TRACKING - PO-12345                                   X  |
+----------------------------------------------------------+
|                                                          |
|  Origen: CEDIS CDMX                                     |
|  Destino: CEDIS Monterrey                               |
|  Estado: EN TRANSITO                                    |
|  ETA: Hoy 14:30 (en 2h 15m)                            |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  [MAPA]                                                 |
|                                                          |
|     * CDMX (Origen - Salio 06:00)                       |
|     |                                                   |
|     |  ---- Ruta 57D ----                              |
|     |                                                   |
|     o  Ubicacion actual: San Luis Potosi              |
|     |  Ultima actualizacion: hace 5 min               |
|     |                                                   |
|     |  ---- 280 km restantes ----                     |
|     |                                                   |
|     * Monterrey (Destino - ETA 14:30)                  |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  TIMELINE DE EVENTOS                                    |
|                                                          |
|  12:15  En transito - San Luis Potosi                  |
|  09:45  Salida de caseta Queretaro                     |
|  08:30  Inicio de viaje                                |
|  07:15  Carga completada                               |
|  06:00  Arribo a origen                                |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  DATOS DEL ENVIO                                        |
|                                                          |
|  Referencia: PO-12345                                  |
|  Unidad: T-1025                                        |
|  Operador: Juan Perez G.                               |
|  Peso: 18,500 kg                                        |
|  Ventana entrega: 14:00 - 16:00                        |
|                                                          |
|  [Descargar tracking PDF]                              |
|                                                          |
+----------------------------------------------------------+

Documentos

+----------------------------------------------------------+
| DOCUMENTOS - PO-12340                                 X  |
+----------------------------------------------------------+
|                                                          |
|  Envio: PO-12340 | CDMX -> Leon                        |
|  Entregado: 26-ene-2026 10:45                          |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  DOCUMENTOS DISPONIBLES                                 |
|                                                          |
|  | Documento         | Fecha      | Acciones         | |
|  |-------------------|------------|------------------| |
|  | POD               | 26-ene     | [Ver] [Descargar]| |
|  | Factura (PDF)     | 27-ene     | [Ver] [Descargar]| |
|  | Factura (XML)     | 27-ene     | [Descargar]      | |
|  | Carta Porte (PDF) | 27-ene     | [Ver] [Descargar]| |
|  | Carta Porte (XML) | 27-ene     | [Descargar]      | |
|                                                          |
|  [Descargar todo (ZIP)]                                |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  VISTA PREVIA - POD                                     |
|                                                          |
|  +------------------------------------------------+    |
|  |                                                 |    |
|  |  [Foto de POD firmado]                         |    |
|  |                                                 |    |
|  |  Receptor: Carlos Mendez                       |    |
|  |  Fecha/hora: 26-ene-2026 10:45                |    |
|  |  Firma: [imagen de firma]                      |    |
|  |                                                 |    |
|  +------------------------------------------------+    |
|                                                          |
+----------------------------------------------------------+

Notas Tecnicas

  • Frontend: React SPA separada
  • Auth: JWT con refresh tokens
  • API: Mismos endpoints, filtrado por tenant/cliente
  • Mapa: Google Maps o Mapbox
  • Documentos: S3 presigned URLs

Definicion de Done

  • Login de usuarios cliente
  • Dashboard con envios activos
  • Lista filtrable de envios
  • Tracking en mapa con ruta
  • Timeline de eventos
  • Vista y descarga de POD
  • Descarga de facturas y Carta Porte
  • Responsive (movil)
  • Tests de consulta y descarga