# 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