# REQUERIMIENTOS - MAI-015: Portal de Cliente

**Modulo:** MAI-015
**Fuente:** REQ-GIRO-TRANSPORTISTA.md - Seccion 4.13
**Version:** 1.0.0

---

## Requerimientos Funcionales

### RF-4.13.1: Tracking

**Descripcion:** Proporcionar visibilidad de envios al cliente.

**Funcionalidades:**
| Funcion | Descripcion |
|---------|-------------|
| Mapa | Posicion actual en mapa |
| Estado | Estado del viaje (etapa) |
| Eventos | Timeline de eventos |
| ETA | Hora estimada de llegada |
| Historial | Viajes anteriores |

**Vista de mapa:**
- Posicion actual del vehiculo
- Ruta planeada
- Origen y destino marcados
- Actualizacion cada 5 minutos

**Filtros:**
- Por fecha
- Por estado (activos, entregados, todos)
- Por referencia (PO, OT)

**Tablas DDL:**
- `tracking.eventos_tracking`
- `transport.viajes`

---

### RF-4.13.2: Documentos

**Descripcion:** Acceso a documentos relacionados con envios.

**Documentos disponibles:**
| Documento | Momento | Formato |
|-----------|---------|---------|
| POD | Post-entrega | PDF/Fotos |
| Factura | Post-facturacion | PDF/XML |
| Carta Porte | Con factura | PDF/XML |
| Orden de viaje | Pre-carga | PDF |

**Funcionalidades:**
- Vista previa
- Descarga individual
- Descarga masiva (ZIP)
- Busqueda por referencia

**Tablas DDL:**
- `tracking.evidencias_entrega`
- `billing.facturas`
- `compliance.cartas_porte`

---

### RF-4.13.3: Creacion de OT

**Descripcion:** Permitir al cliente crear ordenes de transporte.

**Metodos de creacion:**
1. **Formulario manual**
   - Origen/destino
   - Fechas/ventanas
   - Tipo de carga
   - Referencias

2. **Plantillas**
   - Rutas frecuentes guardadas
   - Un clic para crear

3. **Carga masiva**
   - Excel con multiples OTs
   - Validacion de datos

**Validaciones:**
- Direcciones validas
- Ventanas de tiempo logicas
- Peso/volumen dentro de limites
- Cliente con credito disponible

**Tablas DDL:**
- `transport.ordenes_transporte`
- `transport.plantillas_ot_cliente`

---

### RF-4.13.4: Reclamaciones

**Descripcion:** Apertura y seguimiento de incidencias.

**Flujo:**
```
Cliente abre reclamacion → Sube evidencias →
Asignacion interna → Investigacion →
Cliente ve avances → Resolucion → Cierre
```

**Datos de apertura:**
- Viaje relacionado
- Tipo de reclamacion
- Descripcion
- Evidencias (fotos, docs)

**Seguimiento:**
- Estado actual
- Comentarios del equipo
- Resolucion propuesta
- Aceptar/rechazar

**Tablas DDL:**
- `tracking.incidencias`
- `tracking.bitacora_incidencia`

---

## Requerimientos Adicionales

### Gestion de Usuarios

**Roles del cliente:**
| Rol | Permisos |
|-----|----------|
| Viewer | Solo consulta |
| Creator | Consulta + crear OT |
| Admin | Todo + gestionar usuarios |

**Funcionalidades:**
- Invitar usuarios
- Asignar roles
- Desactivar usuarios

### Notificaciones

**Canales:**
- Email (resumen diario, alertas)
- Portal (en tiempo real)
- WhatsApp (opcional)

**Eventos notificables:**
- Carga completada
- En transito
- Entregado
- Incidencia

### Reportes

**Reportes disponibles:**
- Mis envios por periodo
- KPIs (OTIF, tiempos)
- Facturacion
- Incidencias

---

## Requerimientos No Funcionales

### RNF-001: Seguridad
- Login con email/password
- MFA opcional
- Sesion expira en 8 horas
- Solo ve datos de su empresa

### RNF-002: Disponibilidad
- 99.5% uptime
- Responsive (movil/desktop)

### RNF-003: Performance
- Carga inicial < 3 segundos
- Tracking actualiza cada 5 min

---

## Matriz de Trazabilidad

| RF | Tablas DDL | Endpoints | Historias |
|----|------------|-----------|-----------|
| RF-4.13.1 | eventos_tracking | GET /tracking | US-MAI015-001 |
| RF-4.13.2 | evidencias, facturas | GET /docs | US-MAI015-001 |
| RF-4.13.3 | ordenes_transporte | POST /ot | US-MAI015-002 |
| RF-4.13.4 | incidencias | POST /claims | US-MAI015-003 |

---

*REQUERIMIENTOS MAI-015 - ERP Transportistas v1.0.0*