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>
This commit is contained in:
Adrian Flores Cortes
parent
1845cfcaec
commit
7f45eb6383
219
docs/02-definicion-modulos/MAI-007-pod-cierre/README.md
Normal file
219
docs/02-definicion-modulos/MAI-007-pod-cierre/README.md
Normal file
@ -0,0 +1,219 @@
|
|||||||
|
# MAI-007: POD y Cierre Operativo
|
||||||
|
|
||||||
|
**Version:** 1.0.0
|
||||||
|
**Fecha:** 2026-01-27
|
||||||
|
**Estado:** Diseño
|
||||||
|
**Prioridad:** P0 (Critico - Bloquea facturacion)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Descripcion General
|
||||||
|
|
||||||
|
El modulo POD (Proof of Delivery) y Cierre Operativo es responsable de capturar la evidencia de entrega, registrar tiempos reales y cerrar operativamente los viajes para permitir su facturacion.
|
||||||
|
|
||||||
|
**Problema que resuelve:**
|
||||||
|
- Sin POD no se puede facturar al cliente
|
||||||
|
- Sin registro de tiempos reales no se pueden calcular recargos por demoras
|
||||||
|
- El cierre operativo es prerequisito para liquidacion de operadores
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Objetivos del Modulo
|
||||||
|
|
||||||
|
1. **Captura de POD:** Registrar firma, nombre del receptor, fotos y documentos que comprueban la entrega
|
||||||
|
2. **Registro de tiempos:** Documentar llegada, inicio/fin de descarga, salida con precision
|
||||||
|
3. **Validaciones:** Asegurar que no se cierre un viaje sin evidencia completa o justificacion
|
||||||
|
4. **Cierre contable:** Congelar costos del viaje para calculo de rentabilidad
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Alcance Funcional
|
||||||
|
|
||||||
|
### Incluido
|
||||||
|
|
||||||
|
- Captura de POD desde app movil (online/offline)
|
||||||
|
- Firma digital del receptor
|
||||||
|
- Captura fotografica de evidencia
|
||||||
|
- Escaneo de documentos firmados
|
||||||
|
- Registro de tiempos reales por parada
|
||||||
|
- Calculo automatico de detention time
|
||||||
|
- Validaciones de cierre
|
||||||
|
- Notificacion a cliente de entrega
|
||||||
|
- Integracion con facturacion
|
||||||
|
|
||||||
|
### Excluido
|
||||||
|
|
||||||
|
- Gestion de incidencias (MAI-008)
|
||||||
|
- Generacion de facturas (MAI-009)
|
||||||
|
- Liquidacion de operadores (MAI-010)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Actores
|
||||||
|
|
||||||
|
| Actor | Rol en el modulo |
|
||||||
|
|-------|------------------|
|
||||||
|
| Operador | Captura POD, registra tiempos, toma evidencias |
|
||||||
|
| Despachador | Valida POD, aprueba cierres con excepciones |
|
||||||
|
| Cliente | Recibe notificacion de entrega |
|
||||||
|
| Facturacion | Consulta POD para emitir factura |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Flujo Principal
|
||||||
|
|
||||||
|
```
|
||||||
|
VIAJE EN DESTINO
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌─────────────────┐
|
||||||
|
│ Registro Arribo │ ← Automatico por geocerca o manual
|
||||||
|
└────────┬────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌─────────────────┐
|
||||||
|
│ Inicio Descarga │ ← Timestamp + evidencias
|
||||||
|
└────────┬────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌─────────────────┐
|
||||||
|
│ Fin Descarga │ ← Timestamp
|
||||||
|
└────────┬────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌─────────────────────────┐
|
||||||
|
│ Captura POD │
|
||||||
|
│ - Firma digital │
|
||||||
|
│ - Nombre receptor │
|
||||||
|
│ - Fotos (opcional) │
|
||||||
|
│ - Documento escaneado │
|
||||||
|
└────────┬────────────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌─────────────────┐
|
||||||
|
│ Validaciones │ ← POD completo? Tiempos OK?
|
||||||
|
└────────┬────────┘
|
||||||
|
│
|
||||||
|
┌────┴────┐
|
||||||
|
│ │
|
||||||
|
▼ ▼
|
||||||
|
[APROBADO] [EXCEPCION]
|
||||||
|
│ │
|
||||||
|
│ ▼
|
||||||
|
│ ┌──────────────┐
|
||||||
|
│ │ Justificacion │
|
||||||
|
│ │ + Aprobacion │
|
||||||
|
│ └──────┬───────┘
|
||||||
|
│ │
|
||||||
|
▼ ▼
|
||||||
|
┌─────────────────┐
|
||||||
|
│ VIAJE CERRADO │
|
||||||
|
└────────┬────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
[Listo para facturar]
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Datos del Modulo
|
||||||
|
|
||||||
|
### Entidades Principales
|
||||||
|
|
||||||
|
| Entidad | Descripcion | Estado |
|
||||||
|
|---------|-------------|--------|
|
||||||
|
| POD | Prueba de entrega | NO IMPLEMENTADA |
|
||||||
|
| FirmaDigital | Firma capturada | NO IMPLEMENTADA |
|
||||||
|
| FotoEntrega | Evidencia fotografica | NO IMPLEMENTADA |
|
||||||
|
| TiempoReal | Tiempos registrados | NO IMPLEMENTADA |
|
||||||
|
| CierreViaje | Registro de cierre | NO IMPLEMENTADA |
|
||||||
|
|
||||||
|
### Campos Clave POD
|
||||||
|
|
||||||
|
| Campo | Tipo | Obligatorio | Descripcion |
|
||||||
|
|-------|------|-------------|-------------|
|
||||||
|
| viaje_id | UUID | Si | Referencia al viaje |
|
||||||
|
| parada_id | UUID | Si | Parada de entrega |
|
||||||
|
| receptor_nombre | VARCHAR(150) | Si | Nombre de quien recibe |
|
||||||
|
| receptor_identificacion | VARCHAR(50) | No | ID del receptor |
|
||||||
|
| firma_digital_id | UUID | Si | Referencia a firma |
|
||||||
|
| fecha_entrega | TIMESTAMP | Si | Fecha/hora de entrega |
|
||||||
|
| status | ENUM | Si | PENDIENTE, COMPLETO, EXCEPCION |
|
||||||
|
| notas | TEXT | No | Observaciones |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Requerimientos Funcionales
|
||||||
|
|
||||||
|
Ver archivo: [REQUERIMIENTOS.md](./REQUERIMIENTOS.md)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Metricas del Modulo
|
||||||
|
|
||||||
|
| KPI | Formula | Meta |
|
||||||
|
|-----|---------|------|
|
||||||
|
| POD Capturados | % viajes con POD | >98% |
|
||||||
|
| Tiempo promedio captura | Avg(fin_descarga - arribo) | <60 min |
|
||||||
|
| Detention rate | % viajes con detention | <15% |
|
||||||
|
| POD con excepciones | % POD con justificacion | <5% |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Dependencias
|
||||||
|
|
||||||
|
### Este modulo depende de:
|
||||||
|
- MAI-005 (Despacho): Viaje debe estar despachado
|
||||||
|
- MAI-006 (Tracking): Eventos de arribo por geocerca
|
||||||
|
- MAI-011 (Gestion Flota): Datos de operador
|
||||||
|
|
||||||
|
### Otros modulos dependen de este:
|
||||||
|
- MAI-009 (Facturacion): No puede facturar sin POD
|
||||||
|
- MAI-010 (Liquidaciones): Cierre para liquidar operador
|
||||||
|
- MAE-016 (Carta Porte): Expediente fiscal del viaje
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Consideraciones Tecnicas
|
||||||
|
|
||||||
|
### App Movil
|
||||||
|
- Debe funcionar offline con sincronizacion posterior
|
||||||
|
- Compresion de fotos antes de subir
|
||||||
|
- Captura de firma mediante canvas
|
||||||
|
- Almacenamiento temporal seguro
|
||||||
|
|
||||||
|
### Validaciones
|
||||||
|
- Coordenadas GPS dentro de geocerca del destino
|
||||||
|
- Timestamp coherente con eventos previos
|
||||||
|
- Archivo de firma no vacio
|
||||||
|
|
||||||
|
### Integraciones
|
||||||
|
- Notificacion a cliente via WhatsApp/Email
|
||||||
|
- Webhook a sistema de facturacion
|
||||||
|
- Sincronizacion con ERP contable
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Historias de Usuario
|
||||||
|
|
||||||
|
Ver carpeta: [historias-usuario/](./historias-usuario/)
|
||||||
|
|
||||||
|
| US | Titulo | Prioridad |
|
||||||
|
|----|--------|-----------|
|
||||||
|
| US-MAI007-001 | Capturar firma digital en entrega | Alta |
|
||||||
|
| US-MAI007-002 | Registrar tiempos reales de operacion | Alta |
|
||||||
|
| US-MAI007-003 | Adjuntar fotos de evidencia | Alta |
|
||||||
|
| US-MAI007-004 | Validar POD antes de cierre | Alta |
|
||||||
|
| US-MAI007-005 | Cerrar viaje con excepcion justificada | Media |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Referencias
|
||||||
|
|
||||||
|
- REQ-GIRO-TRANSPORTISTA.md - Seccion 4.7
|
||||||
|
- MATRIZ-COHERENCIA-DDL-BACKEND.yml
|
||||||
|
- MAPEO-RF-GIRO-A-MODULOS.yml
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*Modulo MAI-007 - ERP Transportistas - Sistema SIMCO v4.0.0*
|
||||||
176
docs/02-definicion-modulos/MAI-007-pod-cierre/REQUERIMIENTOS.md
Normal file
176
docs/02-definicion-modulos/MAI-007-pod-cierre/REQUERIMIENTOS.md
Normal file
@ -0,0 +1,176 @@
|
|||||||
|
# REQUERIMIENTOS.md - MAI-007: POD y Cierre Operativo
|
||||||
|
|
||||||
|
**Version:** 1.0.0
|
||||||
|
**Fecha:** 2026-01-27
|
||||||
|
**Fuente:** REQ-GIRO-TRANSPORTISTA.md - Seccion 4.7
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Requerimientos Funcionales
|
||||||
|
|
||||||
|
### RF-4.7.1: Captura POD
|
||||||
|
|
||||||
|
**Descripcion:**
|
||||||
|
El sistema debe permitir capturar la prueba de entrega (Proof of Delivery) incluyendo firma digital, nombre/ID del receptor, sello, fotos y documento escaneado.
|
||||||
|
|
||||||
|
**Criterios de Aceptacion:**
|
||||||
|
1. El operador puede capturar firma digital en pantalla tactil
|
||||||
|
2. El sistema registra nombre y opcionalmente ID del receptor
|
||||||
|
3. El operador puede adjuntar 1-5 fotos de evidencia
|
||||||
|
4. El operador puede escanear documento firmado (carta de porte, remision)
|
||||||
|
5. La captura funciona en modo offline con sincronizacion posterior
|
||||||
|
6. El sistema valida que la firma no este vacia
|
||||||
|
7. El sistema registra coordenadas GPS de la captura
|
||||||
|
|
||||||
|
**Mapeo a DDL:**
|
||||||
|
- Tabla: `pod`
|
||||||
|
- Campos: receptor_nombre, receptor_identificacion, firma_digital_id, foto_ids, documento_url, coordenadas, fecha_captura
|
||||||
|
|
||||||
|
**Endpoints Requeridos:**
|
||||||
|
- `POST /api/v1/pod` - Crear POD
|
||||||
|
- `PUT /api/v1/pod/:id` - Actualizar POD
|
||||||
|
- `POST /api/v1/pod/:id/firma` - Subir firma digital
|
||||||
|
- `POST /api/v1/pod/:id/fotos` - Subir fotos
|
||||||
|
- `POST /api/v1/pod/:id/documento` - Subir documento escaneado
|
||||||
|
|
||||||
|
**Prioridad:** Alta
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### RF-4.7.2: Validaciones POD
|
||||||
|
|
||||||
|
**Descripcion:**
|
||||||
|
El sistema no debe permitir "cerrar" un viaje sin POD o sin justificacion aprobada por un supervisor.
|
||||||
|
|
||||||
|
**Criterios de Aceptacion:**
|
||||||
|
1. El boton "Cerrar Viaje" esta deshabilitado si no hay POD capturado
|
||||||
|
2. Si no hay POD, el sistema muestra opcion "Cerrar con Excepcion"
|
||||||
|
3. Cerrar con excepcion requiere:
|
||||||
|
- Motivo de excepcion (catalogo + texto libre)
|
||||||
|
- Aprobacion de supervisor (puede ser posterior)
|
||||||
|
4. El sistema notifica al supervisor cuando hay excepciones pendientes
|
||||||
|
5. Las excepciones se registran en bitacora de auditoria
|
||||||
|
|
||||||
|
**Mapeo a DDL:**
|
||||||
|
- Tabla: `pod` campo `status` (COMPLETO, EXCEPCION_PENDIENTE, EXCEPCION_APROBADA)
|
||||||
|
- Tabla: `excepciones_pod` (viaje_id, motivo, justificacion, aprobador_id, fecha_aprobacion)
|
||||||
|
|
||||||
|
**Endpoints Requeridos:**
|
||||||
|
- `POST /api/v1/viajes/:id/cierre-excepcion` - Solicitar cierre con excepcion
|
||||||
|
- `PUT /api/v1/excepciones/:id/aprobar` - Aprobar excepcion
|
||||||
|
- `PUT /api/v1/excepciones/:id/rechazar` - Rechazar excepcion
|
||||||
|
|
||||||
|
**Prioridad:** Alta
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### RF-4.7.3: Tiempos Reales
|
||||||
|
|
||||||
|
**Descripcion:**
|
||||||
|
El sistema debe registrar tiempos de llegada, inicio/fin de descarga y salida para metricas de detention y SLA.
|
||||||
|
|
||||||
|
**Criterios de Aceptacion:**
|
||||||
|
1. El operador puede registrar:
|
||||||
|
- Hora de arribo al destino
|
||||||
|
- Hora de inicio de descarga
|
||||||
|
- Hora de fin de descarga
|
||||||
|
- Hora de salida del destino
|
||||||
|
2. Los eventos pueden capturarse automaticamente por geocerca
|
||||||
|
3. El sistema calcula automaticamente:
|
||||||
|
- Tiempo de espera (arribo a inicio descarga)
|
||||||
|
- Tiempo de descarga (inicio a fin)
|
||||||
|
- Tiempo total en destino
|
||||||
|
4. El sistema compara vs tolerancia del SLA del cliente
|
||||||
|
5. Si se excede tolerancia, genera flag de "detention"
|
||||||
|
6. Los tiempos alimentan calculo de recargos en facturacion
|
||||||
|
|
||||||
|
**Mapeo a DDL:**
|
||||||
|
- Tabla: `tiempos_reales`
|
||||||
|
- Campos: viaje_id, parada_id, hora_arribo, hora_inicio_descarga, hora_fin_descarga, hora_salida, detention_minutos, excede_sla
|
||||||
|
|
||||||
|
**Endpoints Requeridos:**
|
||||||
|
- `POST /api/v1/tiempos-reales` - Registrar tiempo
|
||||||
|
- `GET /api/v1/viajes/:id/tiempos` - Consultar tiempos del viaje
|
||||||
|
- `GET /api/v1/viajes/:id/detention` - Consultar detention calculado
|
||||||
|
|
||||||
|
**Prioridad:** Alta
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### RF-4.7.4: Cierre Contable Operativo
|
||||||
|
|
||||||
|
**Descripcion:**
|
||||||
|
Al cerrar el viaje, el sistema debe congelar los costos (combustible, peajes, viaticos) y calcular rentabilidad preliminar.
|
||||||
|
|
||||||
|
**Criterios de Aceptacion:**
|
||||||
|
1. Al cerrar viaje, el sistema:
|
||||||
|
- Marca costos como "cerrados" (no editables)
|
||||||
|
- Suma total de costos del viaje
|
||||||
|
- Calcula margen vs precio cotizado
|
||||||
|
- Genera registro de cierre con snapshot de valores
|
||||||
|
2. El cierre puede revertirse solo con autorizacion especial
|
||||||
|
3. El sistema genera alerta si margen es negativo
|
||||||
|
4. El viaje cerrado pasa a estado "LISTO_FACTURAR"
|
||||||
|
5. El sistema notifica a facturacion que hay viaje listo
|
||||||
|
|
||||||
|
**Mapeo a DDL:**
|
||||||
|
- Tabla: `cierres_viaje`
|
||||||
|
- Campos: viaje_id, fecha_cierre, usuario_cierre, total_costos, total_ingresos, margen, status
|
||||||
|
|
||||||
|
**Endpoints Requeridos:**
|
||||||
|
- `POST /api/v1/viajes/:id/cerrar` - Cerrar viaje
|
||||||
|
- `POST /api/v1/viajes/:id/reabrir` - Reabrir viaje (admin)
|
||||||
|
- `GET /api/v1/viajes/:id/rentabilidad` - Consultar rentabilidad
|
||||||
|
|
||||||
|
**Prioridad:** Alta
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Requerimientos No Funcionales
|
||||||
|
|
||||||
|
### RNF-001: Performance App Movil
|
||||||
|
|
||||||
|
La captura de POD debe completarse en menos de 30 segundos incluyendo firma y fotos.
|
||||||
|
|
||||||
|
### RNF-002: Disponibilidad Offline
|
||||||
|
|
||||||
|
El modulo debe funcionar sin conexion, almacenando datos localmente hasta 72 horas.
|
||||||
|
|
||||||
|
### RNF-003: Compresion de Imagenes
|
||||||
|
|
||||||
|
Las fotos deben comprimirse a max 500KB antes de sincronizar.
|
||||||
|
|
||||||
|
### RNF-004: Seguridad
|
||||||
|
|
||||||
|
La firma digital debe almacenarse cifrada y ser verificable contra el registro de entrega.
|
||||||
|
|
||||||
|
### RNF-005: Auditoria
|
||||||
|
|
||||||
|
Todos los eventos de POD deben registrarse en log de auditoria con usuario, timestamp y coordenadas.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Validaciones de Negocio
|
||||||
|
|
||||||
|
| Validacion | Descripcion | Accion si falla |
|
||||||
|
|------------|-------------|-----------------|
|
||||||
|
| POD_001 | Firma no puede estar vacia | Rechazar POD |
|
||||||
|
| POD_002 | Receptor nombre obligatorio | Rechazar POD |
|
||||||
|
| POD_003 | GPS dentro de geocerca destino | Warning, permitir con nota |
|
||||||
|
| POD_004 | Tiempos en secuencia logica | Rechazar si arribo > descarga |
|
||||||
|
| POD_005 | Viaje en estado EN_DESTINO | No permitir captura |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Matriz de Trazabilidad
|
||||||
|
|
||||||
|
| RF | Tabla DDL | Entity | Endpoint | US |
|
||||||
|
|----|-----------|--------|----------|---|
|
||||||
|
| RF-4.7.1 | pod | POD | POST /api/v1/pod | US-MAI007-001, US-MAI007-003 |
|
||||||
|
| RF-4.7.2 | excepciones_pod | ExcepcionPOD | POST /viajes/:id/cierre-excepcion | US-MAI007-005 |
|
||||||
|
| RF-4.7.3 | tiempos_reales | TiempoReal | POST /api/v1/tiempos-reales | US-MAI007-002 |
|
||||||
|
| RF-4.7.4 | cierres_viaje | CierreViaje | POST /viajes/:id/cerrar | US-MAI007-004 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*MAI-007 REQUERIMIENTOS - ERP Transportistas - Sistema SIMCO v4.0.0*
|
||||||
190
docs/02-definicion-modulos/MAI-007-pod-cierre/RESUMEN-EPICA.md
Normal file
190
docs/02-definicion-modulos/MAI-007-pod-cierre/RESUMEN-EPICA.md
Normal file
@ -0,0 +1,190 @@
|
|||||||
|
# RESUMEN-EPICA.md - MAI-007: POD y Cierre Operativo
|
||||||
|
|
||||||
|
**Codigo:** MAI-007
|
||||||
|
**Nombre:** POD y Cierre Operativo
|
||||||
|
**Version:** 1.0.0
|
||||||
|
**Fecha:** 2026-01-27
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Valor de Negocio
|
||||||
|
|
||||||
|
### Problema
|
||||||
|
|
||||||
|
Actualmente las empresas transportistas enfrentan:
|
||||||
|
- Disputas con clientes por falta de evidencia de entrega
|
||||||
|
- Retrasos en facturacion por documentacion incompleta
|
||||||
|
- Perdida de ingresos por no documentar detention time
|
||||||
|
- Imposibilidad de calcular rentabilidad real por viaje
|
||||||
|
|
||||||
|
### Solucion
|
||||||
|
|
||||||
|
Un sistema robusto de captura de POD que:
|
||||||
|
- Provee evidencia digital irrefutable de entrega
|
||||||
|
- Automatiza el registro de tiempos para recargos
|
||||||
|
- Cierra operativamente el viaje para facturacion inmediata
|
||||||
|
- Calcula rentabilidad preliminar al cerrar
|
||||||
|
|
||||||
|
### Beneficios Esperados
|
||||||
|
|
||||||
|
| Beneficio | Metrica | Impacto |
|
||||||
|
|-----------|---------|---------|
|
||||||
|
| Reduccion disputas | -80% reclamos sin evidencia | Ahorro legal |
|
||||||
|
| Facturacion rapida | -3 dias ciclo facturacion | Flujo de caja |
|
||||||
|
| Recargos detention | +15% captura detention | Ingresos |
|
||||||
|
| Visibilidad costos | 100% viajes con rentabilidad | Decisiones |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Actores y Stakeholders
|
||||||
|
|
||||||
|
### Usuarios Primarios
|
||||||
|
|
||||||
|
| Actor | Responsabilidad | Frecuencia |
|
||||||
|
|-------|-----------------|------------|
|
||||||
|
| Operador | Captura POD, registra tiempos | Cada entrega |
|
||||||
|
| Despachador | Valida POD, aprueba excepciones | Continuo |
|
||||||
|
| Supervisor | Autoriza cierres especiales | Bajo demanda |
|
||||||
|
|
||||||
|
### Usuarios Secundarios
|
||||||
|
|
||||||
|
| Actor | Interes |
|
||||||
|
|-------|---------|
|
||||||
|
| Facturacion | Usa POD para emitir facturas |
|
||||||
|
| Atencion Cliente | Consulta POD para responder dudas |
|
||||||
|
| Gerencia | Revisa metricas de entrega |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Flujo Principal
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────────────────────────────┐
|
||||||
|
│ VIAJE EN DESTINO │
|
||||||
|
└─────────────────────────────────────────────────────────────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌─────────────────────────────────────────────────────────────────┐
|
||||||
|
│ 1. REGISTRO ARRIBO │
|
||||||
|
│ - Automatico: Geocerca detecta unidad en destino │
|
||||||
|
│ - Manual: Operador registra en app │
|
||||||
|
│ - Sistema: Timestamp + coordenadas │
|
||||||
|
└─────────────────────────────────────────────────────────────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌─────────────────────────────────────────────────────────────────┐
|
||||||
|
│ 2. DESCARGA │
|
||||||
|
│ - Operador marca inicio descarga │
|
||||||
|
│ - Operador marca fin descarga │
|
||||||
|
│ - Sistema: Calcula duracion, compara vs SLA │
|
||||||
|
└─────────────────────────────────────────────────────────────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌─────────────────────────────────────────────────────────────────┐
|
||||||
|
│ 3. CAPTURA POD │
|
||||||
|
│ - Operador captura firma digital en pantalla │
|
||||||
|
│ - Operador ingresa nombre receptor │
|
||||||
|
│ - Operador toma fotos (opcional) │
|
||||||
|
│ - Operador escanea documento firmado (opcional) │
|
||||||
|
│ - Sistema: Valida datos minimos │
|
||||||
|
└─────────────────────────────────────────────────────────────────┘
|
||||||
|
│
|
||||||
|
┌─────────┴─────────┐
|
||||||
|
│ │
|
||||||
|
▼ ▼
|
||||||
|
┌──────────────────┐ ┌──────────────────┐
|
||||||
|
│ POD COMPLETO │ │ POD INCOMPLETO │
|
||||||
|
│ │ │ │
|
||||||
|
│ Firma OK │ │ Falta firma o │
|
||||||
|
│ Receptor OK │ │ receptor │
|
||||||
|
└────────┬─────────┘ └────────┬─────────┘
|
||||||
|
│ │
|
||||||
|
│ ▼
|
||||||
|
│ ┌──────────────────┐
|
||||||
|
│ │ EXCEPCION │
|
||||||
|
│ │ │
|
||||||
|
│ │ Motivo + Notas │
|
||||||
|
│ │ Enviar a aprobar │
|
||||||
|
│ └────────┬─────────┘
|
||||||
|
│ │
|
||||||
|
▼ ▼
|
||||||
|
┌─────────────────────────────────────────────────────────────────┐
|
||||||
|
│ 4. CIERRE VIAJE │
|
||||||
|
│ - Sistema: Congela costos │
|
||||||
|
│ - Sistema: Calcula rentabilidad │
|
||||||
|
│ - Sistema: Cambia estado a CERRADO │
|
||||||
|
│ - Sistema: Notifica a facturacion │
|
||||||
|
└─────────────────────────────────────────────────────────────────┘
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌─────────────────────────────────────────────────────────────────┐
|
||||||
|
│ LISTO PARA FACTURAR │
|
||||||
|
└─────────────────────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Criterios de Exito
|
||||||
|
|
||||||
|
### Funcionales
|
||||||
|
|
||||||
|
- [ ] Operador puede capturar POD completo en <2 minutos
|
||||||
|
- [ ] Sistema funciona offline y sincroniza al reconectar
|
||||||
|
- [ ] Excepciones requieren aprobacion de supervisor
|
||||||
|
- [ ] Cierre calcula rentabilidad automaticamente
|
||||||
|
|
||||||
|
### Tecnicos
|
||||||
|
|
||||||
|
- [ ] Fotos comprimidas a <500KB
|
||||||
|
- [ ] Firma almacenada como imagen PNG
|
||||||
|
- [ ] Sincronizacion en <30 segundos con conexion
|
||||||
|
- [ ] Logs de auditoria completos
|
||||||
|
|
||||||
|
### Negocio
|
||||||
|
|
||||||
|
- [ ] 98% de viajes con POD capturado
|
||||||
|
- [ ] <5% de POD con excepciones
|
||||||
|
- [ ] Facturacion dentro de 24h del cierre
|
||||||
|
- [ ] 100% viajes con rentabilidad calculada
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Riesgos y Mitigaciones
|
||||||
|
|
||||||
|
| Riesgo | Probabilidad | Impacto | Mitigacion |
|
||||||
|
|--------|--------------|---------|------------|
|
||||||
|
| Operador sin conectividad | Alta | Alto | Modo offline robusto |
|
||||||
|
| Fotos muy pesadas | Media | Medio | Compresion automatica |
|
||||||
|
| Firma ilegible | Media | Medio | Validacion de trazos minimos |
|
||||||
|
| Rechazo de cierre sin POD | Baja | Alto | Flujo de excepciones |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Dependencias
|
||||||
|
|
||||||
|
### Prerequisitos
|
||||||
|
- MAI-005 (Despacho): Viaje despachado
|
||||||
|
- MAI-006 (Tracking): Geocercas configuradas
|
||||||
|
- MAI-011 (Flota): Operador asignado
|
||||||
|
|
||||||
|
### Habilita
|
||||||
|
- MAI-009 (Facturacion): Requiere POD para facturar
|
||||||
|
- MAI-010 (Liquidaciones): Requiere cierre para liquidar
|
||||||
|
- MAE-016 (Carta Porte): Expediente completo
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Story Points Estimados
|
||||||
|
|
||||||
|
| Historia | Complejidad | SP |
|
||||||
|
|----------|-------------|---|
|
||||||
|
| US-MAI007-001 | Alta | 8 |
|
||||||
|
| US-MAI007-002 | Media | 5 |
|
||||||
|
| US-MAI007-003 | Media | 5 |
|
||||||
|
| US-MAI007-004 | Alta | 8 |
|
||||||
|
| US-MAI007-005 | Media | 5 |
|
||||||
|
| **Total** | | **31** |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*Epica MAI-007 - ERP Transportistas - Sistema SIMCO v4.0.0*
|
||||||
@ -0,0 +1,90 @@
|
|||||||
|
# US-MAI007-001: Capturar firma digital en entrega
|
||||||
|
|
||||||
|
**ID:** US-MAI007-001
|
||||||
|
**Modulo:** MAI-007 (POD y Cierre)
|
||||||
|
**Prioridad:** Alta
|
||||||
|
**Story Points:** 8
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Historia de Usuario
|
||||||
|
|
||||||
|
**Como** operador de transporte
|
||||||
|
**Quiero** capturar la firma digital del receptor en mi dispositivo movil
|
||||||
|
**Para** tener evidencia irrefutable de que la mercancia fue entregada
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Criterios de Aceptacion
|
||||||
|
|
||||||
|
### CA-001: Captura de firma
|
||||||
|
**Dado** que estoy en la pantalla de captura POD
|
||||||
|
**Cuando** el receptor firma con su dedo en el area de firma
|
||||||
|
**Entonces** el sistema captura la firma como imagen y la muestra en preview
|
||||||
|
|
||||||
|
### CA-002: Validacion de firma
|
||||||
|
**Dado** que intento guardar el POD sin firma
|
||||||
|
**Cuando** presiono el boton guardar
|
||||||
|
**Entonces** el sistema muestra error "Firma requerida" y no permite continuar
|
||||||
|
|
||||||
|
### CA-003: Datos del receptor
|
||||||
|
**Dado** que capturo la firma
|
||||||
|
**Cuando** completo los datos del receptor (nombre obligatorio, ID opcional)
|
||||||
|
**Entonces** el sistema asocia estos datos a la firma capturada
|
||||||
|
|
||||||
|
### CA-004: Limpiar y reintentar
|
||||||
|
**Dado** que la firma capturada no es satisfactoria
|
||||||
|
**Cuando** presiono el boton "Limpiar firma"
|
||||||
|
**Entonces** el area de firma se limpia y puedo capturar nuevamente
|
||||||
|
|
||||||
|
### CA-005: Modo offline
|
||||||
|
**Dado** que no tengo conexion a internet
|
||||||
|
**Cuando** capturo una firma
|
||||||
|
**Entonces** el sistema la almacena localmente y sincroniza cuando haya conexion
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Mockup / UI
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────┐
|
||||||
|
│ POD - Entrega #12345 │
|
||||||
|
├─────────────────────────────────────────┤
|
||||||
|
│ │
|
||||||
|
│ Nombre receptor: [________________] │
|
||||||
|
│ ID receptor: [________________] │
|
||||||
|
│ (opcional) │
|
||||||
|
│ │
|
||||||
|
│ ┌─────────────────────────────────┐ │
|
||||||
|
│ │ │ │
|
||||||
|
│ │ │ │
|
||||||
|
│ │ [AREA DE FIRMA] │ │
|
||||||
|
│ │ │ │
|
||||||
|
│ │ │ │
|
||||||
|
│ └─────────────────────────────────┘ │
|
||||||
|
│ │
|
||||||
|
│ [Limpiar] [Continuar →] │
|
||||||
|
│ │
|
||||||
|
└─────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Notas Tecnicas
|
||||||
|
|
||||||
|
- La firma se almacena como PNG base64 en SQLite local
|
||||||
|
- Resolucion minima: 300x150 px
|
||||||
|
- Validar que haya al menos 50 puntos de trazo
|
||||||
|
- Coordenadas GPS se capturan automaticamente
|
||||||
|
- Sincronizacion via endpoint POST /api/v1/pod/:id/firma
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Definicion de Done
|
||||||
|
|
||||||
|
- [ ] Codigo implementado y revisado
|
||||||
|
- [ ] Tests unitarios (cobertura >80%)
|
||||||
|
- [ ] Tests de integracion con backend
|
||||||
|
- [ ] Funciona en modo offline
|
||||||
|
- [ ] Documentacion de API actualizada
|
||||||
|
- [ ] Demo aprobada por Product Owner
|
||||||
@ -0,0 +1,106 @@
|
|||||||
|
# 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
|
||||||
@ -0,0 +1,96 @@
|
|||||||
|
# US-MAI007-003: Adjuntar fotos de evidencia
|
||||||
|
|
||||||
|
**ID:** US-MAI007-003
|
||||||
|
**Modulo:** MAI-007 (POD y Cierre)
|
||||||
|
**Prioridad:** Alta
|
||||||
|
**Story Points:** 5
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Historia de Usuario
|
||||||
|
|
||||||
|
**Como** operador de transporte
|
||||||
|
**Quiero** adjuntar fotos de la entrega como evidencia
|
||||||
|
**Para** documentar el estado de la mercancia al momento de entrega
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Criterios de Aceptacion
|
||||||
|
|
||||||
|
### CA-001: Captura de foto
|
||||||
|
**Dado** que estoy en la pantalla de POD
|
||||||
|
**Cuando** presiono "Tomar foto"
|
||||||
|
**Entonces** se abre la camara y puedo capturar una imagen
|
||||||
|
|
||||||
|
### CA-002: Seleccion de galeria
|
||||||
|
**Dado** que ya tome fotos previamente
|
||||||
|
**Cuando** presiono "Seleccionar de galeria"
|
||||||
|
**Entonces** puedo elegir fotos existentes del dispositivo
|
||||||
|
|
||||||
|
### CA-003: Limite de fotos
|
||||||
|
**Dado** que ya tengo 5 fotos adjuntas
|
||||||
|
**Cuando** intento agregar otra
|
||||||
|
**Entonces** el sistema muestra "Maximo 5 fotos por POD"
|
||||||
|
|
||||||
|
### CA-004: Compresion automatica
|
||||||
|
**Dado** que tomo una foto de alta resolucion
|
||||||
|
**Cuando** la adjunto al POD
|
||||||
|
**Entonces** el sistema la comprime a max 500KB automaticamente
|
||||||
|
|
||||||
|
### CA-005: Preview y eliminacion
|
||||||
|
**Dado** que tengo fotos adjuntas
|
||||||
|
**Cuando** toco una foto en la lista
|
||||||
|
**Entonces** puedo verla en pantalla completa y eliminarla si es necesario
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Mockup / UI
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────┐
|
||||||
|
│ Fotos de Evidencia │
|
||||||
|
├─────────────────────────────────────────┤
|
||||||
|
│ │
|
||||||
|
│ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ │
|
||||||
|
│ │ img │ │ img │ │ img │ │ + │ │
|
||||||
|
│ │ 1 │ │ 2 │ │ 3 │ │ │ │
|
||||||
|
│ └─────┘ └─────┘ └─────┘ └─────┘ │
|
||||||
|
│ │
|
||||||
|
│ 3 de 5 fotos │
|
||||||
|
│ │
|
||||||
|
│ [📷 Tomar foto] [🖼 Galeria] │
|
||||||
|
│ │
|
||||||
|
└─────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Tipos de Evidencia Sugeridos
|
||||||
|
|
||||||
|
| Tipo | Descripcion |
|
||||||
|
|------|-------------|
|
||||||
|
| Estado mercancia | Foto de cajas/pallets al entregar |
|
||||||
|
| Documento firmado | Foto de remision con firma |
|
||||||
|
| Area descarga | Foto del area de descarga |
|
||||||
|
| Sello roto | Evidencia si se rompe sello |
|
||||||
|
| Dano | Documentar cualquier dano visible |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Notas Tecnicas
|
||||||
|
|
||||||
|
- Fotos se almacenan en cache local hasta sincronizar
|
||||||
|
- Compresion JPEG calidad 70%
|
||||||
|
- Metadata EXIF preservada (fecha, GPS si disponible)
|
||||||
|
- Endpoint: POST /api/v1/pod/:id/fotos (multipart)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Definicion de Done
|
||||||
|
|
||||||
|
- [ ] Captura desde camara
|
||||||
|
- [ ] Seleccion desde galeria
|
||||||
|
- [ ] Compresion automatica
|
||||||
|
- [ ] Preview de fotos
|
||||||
|
- [ ] Eliminacion de fotos
|
||||||
|
- [ ] Funciona offline
|
||||||
@ -0,0 +1,119 @@
|
|||||||
|
# US-MAI007-004: Validar POD antes de cierre
|
||||||
|
|
||||||
|
**ID:** US-MAI007-004
|
||||||
|
**Modulo:** MAI-007 (POD y Cierre)
|
||||||
|
**Prioridad:** Alta
|
||||||
|
**Story Points:** 8
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Historia de Usuario
|
||||||
|
|
||||||
|
**Como** despachador
|
||||||
|
**Quiero** que el sistema valide automaticamente que el POD este completo antes de cerrar
|
||||||
|
**Para** asegurar que tenemos toda la documentacion necesaria para facturar
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Criterios de Aceptacion
|
||||||
|
|
||||||
|
### CA-001: Validacion de firma
|
||||||
|
**Dado** que intento cerrar un viaje
|
||||||
|
**Cuando** el POD no tiene firma capturada
|
||||||
|
**Entonces** el sistema bloquea el cierre y muestra "POD sin firma"
|
||||||
|
|
||||||
|
### CA-002: Validacion de receptor
|
||||||
|
**Dado** que intento cerrar un viaje
|
||||||
|
**Cuando** el POD no tiene nombre de receptor
|
||||||
|
**Entonces** el sistema bloquea el cierre y muestra "Receptor no identificado"
|
||||||
|
|
||||||
|
### CA-003: Validacion de tiempos
|
||||||
|
**Dado** que intento cerrar un viaje
|
||||||
|
**Cuando** no se han registrado todos los tiempos requeridos
|
||||||
|
**Entonces** el sistema muestra advertencia pero permite continuar
|
||||||
|
|
||||||
|
### CA-004: Cierre exitoso
|
||||||
|
**Dado** que el POD cumple todas las validaciones
|
||||||
|
**Cuando** confirmo el cierre
|
||||||
|
**Entonces** el sistema:
|
||||||
|
- Cambia estado del viaje a CERRADO
|
||||||
|
- Congela costos del viaje
|
||||||
|
- Calcula rentabilidad preliminar
|
||||||
|
- Notifica a facturacion
|
||||||
|
|
||||||
|
### CA-005: Resumen de cierre
|
||||||
|
**Dado** que cierro un viaje exitosamente
|
||||||
|
**Cuando** se completa el proceso
|
||||||
|
**Entonces** veo un resumen con: costos, ingresos estimados, margen
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Mockup / UI
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────┐
|
||||||
|
│ Cerrar Viaje #12345 │
|
||||||
|
├─────────────────────────────────────────┤
|
||||||
|
│ │
|
||||||
|
│ Validaciones: │
|
||||||
|
│ ✓ POD con firma │
|
||||||
|
│ ✓ Receptor identificado │
|
||||||
|
│ ✓ Tiempos registrados │
|
||||||
|
│ ⚠ Sin fotos adjuntas (opcional) │
|
||||||
|
│ │
|
||||||
|
│ ───────────────────────────────────── │
|
||||||
|
│ │
|
||||||
|
│ Resumen financiero: │
|
||||||
|
│ Ingresos: $15,000.00 │
|
||||||
|
│ Costos: $11,200.00 │
|
||||||
|
│ - Combustible $5,500.00 │
|
||||||
|
│ - Peajes $1,200.00 │
|
||||||
|
│ - Viaticos $800.00 │
|
||||||
|
│ - Otros $3,700.00 │
|
||||||
|
│ ───────────────────────────────────── │
|
||||||
|
│ Margen: $3,800.00 (25.3%) │
|
||||||
|
│ │
|
||||||
|
│ [Cancelar] [Confirmar Cierre ✓] │
|
||||||
|
│ │
|
||||||
|
└─────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Reglas de Validacion
|
||||||
|
|
||||||
|
| Validacion | Tipo | Bloquea cierre |
|
||||||
|
|------------|------|----------------|
|
||||||
|
| Firma presente | Requerido | Si |
|
||||||
|
| Nombre receptor | Requerido | Si |
|
||||||
|
| Tiempos completos | Recomendado | No |
|
||||||
|
| Fotos adjuntas | Opcional | No |
|
||||||
|
| GPS en geocerca | Recomendado | No |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Estados del Viaje
|
||||||
|
|
||||||
|
```
|
||||||
|
EN_TRANSITO → EN_DESTINO → ENTREGADO → CERRADO → FACTURADO
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Notas Tecnicas
|
||||||
|
|
||||||
|
- Al cerrar se crea snapshot de costos en `cierres_viaje`
|
||||||
|
- Calculo de margen: (tarifa_cliente - sum(costos)) / tarifa_cliente
|
||||||
|
- Notificacion a facturacion via evento/webhook
|
||||||
|
- El cierre es irreversible sin rol de admin
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Definicion de Done
|
||||||
|
|
||||||
|
- [ ] Validaciones automaticas implementadas
|
||||||
|
- [ ] Calculo de rentabilidad correcto
|
||||||
|
- [ ] Notificacion a facturacion
|
||||||
|
- [ ] Snapshot de costos inmutable
|
||||||
|
- [ ] UI de confirmacion clara
|
||||||
|
- [ ] Tests de integracion
|
||||||
@ -0,0 +1,138 @@
|
|||||||
|
# US-MAI007-005: Cerrar viaje con excepcion justificada
|
||||||
|
|
||||||
|
**ID:** US-MAI007-005
|
||||||
|
**Modulo:** MAI-007 (POD y Cierre)
|
||||||
|
**Prioridad:** Media
|
||||||
|
**Story Points:** 5
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Historia de Usuario
|
||||||
|
|
||||||
|
**Como** despachador
|
||||||
|
**Quiero** poder cerrar un viaje sin POD completo con una justificacion
|
||||||
|
**Para** no bloquear el proceso cuando hay situaciones excepcionales
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Criterios de Aceptacion
|
||||||
|
|
||||||
|
### CA-001: Opcion de excepcion
|
||||||
|
**Dado** que el POD no cumple validaciones
|
||||||
|
**Cuando** intento cerrar el viaje
|
||||||
|
**Entonces** el sistema ofrece la opcion "Cerrar con excepcion"
|
||||||
|
|
||||||
|
### CA-002: Motivo obligatorio
|
||||||
|
**Dado** que selecciono cerrar con excepcion
|
||||||
|
**Cuando** no selecciono un motivo del catalogo
|
||||||
|
**Entonces** el sistema no permite continuar
|
||||||
|
|
||||||
|
### CA-003: Justificacion detallada
|
||||||
|
**Dado** que selecciono un motivo de excepcion
|
||||||
|
**Cuando** escribo la justificacion detallada (min 20 caracteres)
|
||||||
|
**Entonces** puedo proceder con la solicitud de excepcion
|
||||||
|
|
||||||
|
### CA-004: Aprobacion pendiente
|
||||||
|
**Dado** que solicito cierre con excepcion
|
||||||
|
**Cuando** completo el formulario
|
||||||
|
**Entonces** el viaje queda en estado "EXCEPCION_PENDIENTE" hasta aprobacion
|
||||||
|
|
||||||
|
### CA-005: Notificacion a supervisor
|
||||||
|
**Dado** que hay una excepcion pendiente
|
||||||
|
**Cuando** se crea la solicitud
|
||||||
|
**Entonces** el supervisor recibe notificacion para aprobar/rechazar
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Catalogo de Motivos
|
||||||
|
|
||||||
|
| Codigo | Motivo | Descripcion |
|
||||||
|
|--------|--------|-------------|
|
||||||
|
| EXC-001 | Rechazo en destino | Cliente rechazo la mercancia |
|
||||||
|
| EXC-002 | Entrega parcial | Solo se entrego parte de la carga |
|
||||||
|
| EXC-003 | Falla dispositivo | No se pudo capturar firma/fotos |
|
||||||
|
| EXC-004 | Emergencia | Accidente, robo, desastre natural |
|
||||||
|
| EXC-005 | Cambio destino | Cliente solicito entregar en otro lugar |
|
||||||
|
| EXC-006 | Otro | Especificar en justificacion |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Mockup / UI
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────┐
|
||||||
|
│ Cierre con Excepcion - Viaje #12345 │
|
||||||
|
├─────────────────────────────────────────┤
|
||||||
|
│ │
|
||||||
|
│ ⚠ El POD no cumple validaciones: │
|
||||||
|
│ ✗ Sin firma capturada │
|
||||||
|
│ │
|
||||||
|
│ ───────────────────────────────────── │
|
||||||
|
│ │
|
||||||
|
│ Motivo de excepcion: * │
|
||||||
|
│ ┌─────────────────────────────────┐ │
|
||||||
|
│ │ Rechazo en destino ▼ │ │
|
||||||
|
│ └─────────────────────────────────┘ │
|
||||||
|
│ │
|
||||||
|
│ Justificacion detallada: * │
|
||||||
|
│ ┌─────────────────────────────────┐ │
|
||||||
|
│ │ El cliente rechazo la carga │ │
|
||||||
|
│ │ por dano visible en 3 cajas. │ │
|
||||||
|
│ │ Se levanto acta con fotos. │ │
|
||||||
|
│ │ Contacto: Juan Perez, almacen │ │
|
||||||
|
│ └─────────────────────────────────┘ │
|
||||||
|
│ │
|
||||||
|
│ Evidencia adicional: │
|
||||||
|
│ [+ Adjuntar foto/documento] │
|
||||||
|
│ │
|
||||||
|
│ ───────────────────────────────────── │
|
||||||
|
│ ℹ Esta solicitud sera enviada a │
|
||||||
|
│ supervisor para aprobacion. │
|
||||||
|
│ │
|
||||||
|
│ [Cancelar] [Enviar Solicitud] │
|
||||||
|
│ │
|
||||||
|
└─────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Flujo de Aprobacion
|
||||||
|
|
||||||
|
```
|
||||||
|
SOLICITUD CREADA
|
||||||
|
│
|
||||||
|
▼
|
||||||
|
┌────────────────┐
|
||||||
|
│ SUPERVISOR │
|
||||||
|
│ revisa │
|
||||||
|
└───────┬────────┘
|
||||||
|
│
|
||||||
|
┌────┴────┐
|
||||||
|
│ │
|
||||||
|
▼ ▼
|
||||||
|
APROBADA RECHAZADA
|
||||||
|
│ │
|
||||||
|
▼ ▼
|
||||||
|
CERRADO PENDIENTE
|
||||||
|
(regresar a operador)
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Notas Tecnicas
|
||||||
|
|
||||||
|
- Excepciones se registran en tabla `excepciones_pod`
|
||||||
|
- Notificacion via push notification y email
|
||||||
|
- Timeout de aprobacion: 24 horas (escalamiento automatico)
|
||||||
|
- Auditoria completa de quien aprobo/rechazo y cuando
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Definicion de Done
|
||||||
|
|
||||||
|
- [ ] Formulario de excepcion implementado
|
||||||
|
- [ ] Catalogo de motivos configurable
|
||||||
|
- [ ] Flujo de aprobacion funcional
|
||||||
|
- [ ] Notificaciones a supervisor
|
||||||
|
- [ ] Auditoria completa
|
||||||
|
- [ ] Tests de flujo completo
|
||||||
Loading…
Reference in New Issue
Block a user