erp-transportistas-v2/docs/02-definicion-modulos/MAI-007-pod-cierre/historias-usuario/US-MAI007-003.md
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

97 lines
3.0 KiB
Markdown

# 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