Adrian Flores Cortes 7f45eb6383 docs(modulos): MAI-007 POD y Cierre - Especificacion completa

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>

2026-01-27 01:33:03 -06:00

3.3 KiB

Raw Blame History

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

3.3 KiB Raw Blame History