# 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