7f45eb6383
Nuevo modulo P0 critico especificado: - README.md: Vision general, alcance, actores, flujo - REQUERIMIENTOS.md: 4 RF (4.7.1-4.7.4), RNF, validaciones - RESUMEN-EPICA.md: Valor de negocio, criterios exito, 31 SP User Stories (5): - US-MAI007-001: Capturar firma digital (8 SP) - US-MAI007-002: Registrar tiempos reales (5 SP) - US-MAI007-003: Adjuntar fotos evidencia (5 SP) - US-MAI007-004: Validar POD antes de cierre (8 SP) - US-MAI007-005: Cerrar con excepcion (5 SP) Este modulo es bloqueante para: - MAI-009 (Facturacion) - MAI-010 (Liquidaciones) - MAE-016 (Carta Porte) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
107 lines
3.3 KiB
Markdown
107 lines
3.3 KiB
Markdown
# US-MAI007-002: Registrar tiempos reales de operacion
|
|
|
|
**ID:** US-MAI007-002
|
|
**Modulo:** MAI-007 (POD y Cierre)
|
|
**Prioridad:** Alta
|
|
**Story Points:** 5
|
|
|
|
---
|
|
|
|
## Historia de Usuario
|
|
|
|
**Como** operador de transporte
|
|
**Quiero** registrar los tiempos de arribo, descarga y salida
|
|
**Para** que el sistema calcule automaticamente si hubo detention time
|
|
|
|
---
|
|
|
|
## Criterios de Aceptacion
|
|
|
|
### CA-001: Registro de arribo
|
|
**Dado** que llego al destino
|
|
**Cuando** presiono "Registrar Arribo" o entro a geocerca
|
|
**Entonces** el sistema registra timestamp y coordenadas del arribo
|
|
|
|
### CA-002: Registro de inicio descarga
|
|
**Dado** que estoy en el destino y comienza la descarga
|
|
**Cuando** presiono "Iniciar Descarga"
|
|
**Entonces** el sistema registra el timestamp de inicio
|
|
|
|
### CA-003: Registro de fin descarga
|
|
**Dado** que la descarga ha terminado
|
|
**Cuando** presiono "Finalizar Descarga"
|
|
**Entonces** el sistema registra el timestamp de fin y calcula duracion
|
|
|
|
### CA-004: Calculo de detention
|
|
**Dado** que he registrado todos los tiempos
|
|
**Cuando** el tiempo de espera (arribo a inicio descarga) excede 2 horas
|
|
**Entonces** el sistema marca el evento como "detention" para facturacion
|
|
|
|
### CA-005: Validacion de secuencia
|
|
**Dado** que intento registrar fin descarga antes de inicio
|
|
**Cuando** presiono el boton
|
|
**Entonces** el sistema muestra error "Registre inicio de descarga primero"
|
|
|
|
---
|
|
|
|
## Flujo de Tiempos
|
|
|
|
```
|
|
ARRIBO (10:00)
|
|
│
|
|
├─── Tiempo de espera ───┐
|
|
│ │
|
|
▼ │
|
|
INICIO DESCARGA (11:30) │ 90 min (OK, < 2h)
|
|
│ │
|
|
├─── Tiempo descarga ────┤
|
|
│ │
|
|
▼ │
|
|
FIN DESCARGA (12:15) │ 45 min
|
|
│ │
|
|
└────────────────────────┘
|
|
Total: 2h 15min
|
|
```
|
|
|
|
---
|
|
|
|
## Mockup / UI
|
|
|
|
```
|
|
┌─────────────────────────────────────────┐
|
|
│ Tiempos - Viaje #12345 │
|
|
├─────────────────────────────────────────┤
|
|
│ │
|
|
│ Destino: Bodega Central CDMX │
|
|
│ │
|
|
│ ✓ Arribo: 10:00 hrs │
|
|
│ ✓ Inicio descarga: 11:30 hrs │
|
|
│ ○ Fin descarga: --:-- hrs │
|
|
│ │
|
|
│ Tiempo espera: 1h 30min ✓ │
|
|
│ (Tolerancia SLA: 2h) │
|
|
│ │
|
|
│ [ Finalizar Descarga ] │
|
|
│ │
|
|
└─────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## Notas Tecnicas
|
|
|
|
- Los tiempos se almacenan en UTC
|
|
- La geocerca puede disparar arribo automatico
|
|
- Tolerancia SLA viene del contrato del cliente
|
|
- Detention time se factura segun reglas configuradas
|
|
|
|
---
|
|
|
|
## Definicion de Done
|
|
|
|
- [ ] Registro de 4 eventos (arribo, inicio, fin, salida)
|
|
- [ ] Calculo automatico de detention
|
|
- [ ] Integracion con geocercas
|
|
- [ ] Tests unitarios
|
|
- [ ] Funciona offline
|