ec43d9c6cd
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>
195 lines
3.8 KiB
Markdown
195 lines
3.8 KiB
Markdown
# 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*
|