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.0 KiB

Raw Blame History

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

3.0 KiB Raw Blame History