erp-transportistas-v2/docs/02-definicion-modulos/MAI-008-incidencias/historias-usuario/US-MAI008-001.md
Adrian Flores Cortes ec43d9c6cd docs: Add Phase 3 secondary modules specifications (P1/P2/P3)
Modules documented:
- MAI-003 (OT): README, REQUERIMIENTOS, RESUMEN-EPICA, 10 US
- MAI-006 (Tracking): README, REQUERIMIENTOS, RESUMEN-EPICA
- MAI-008 (Incidencias): 3 US (18 SP)
- MAI-011 (Flota): README, REQUERIMIENTOS, RESUMEN-EPICA
- MAI-012 (Combustible): 3 US (18 SP)
- MAI-013 (Mantenimiento): 3 US (18 SP)
- MAI-014 (Carriers): 3 US (18 SP)
- MAI-015 (Portal): 3 US (18 SP)
- MAE-016 (Carta Porte): 10 US
- MAE-017 (HOS): 3 US (16 SP)
- MAE-018 (Reportes): 3 US (18 SP)

Phase 2+3 complete: 13 modules, 50+ User Stories

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-27 02:24:35 -06:00

125 lines
4.9 KiB
Markdown

# US-MAI008-001: Registrar incidencia con evidencias
**ID:** US-MAI008-001
**Modulo:** MAI-008 (Incidencias)
**Prioridad:** Alta
**Story Points:** 5
---
## Historia de Usuario
**Como** operador o supervisor
**Quiero** registrar una incidencia con toda la informacion y evidencias necesarias
**Para** documentar eventos anomalos de forma completa y trazable
---
## Criterios de Aceptacion
### CA-001: Seleccionar tipo de incidencia
**Dado** que ocurrio un evento anomalo
**Cuando** inicio el registro de incidencia
**Entonces** selecciono el tipo (retraso, dano, robo, faltante, etc.)
### CA-002: Asociar a viaje
**Dado** que la incidencia esta relacionada a un viaje
**Cuando** la registro
**Entonces** se vincula al viaje con sus datos (OT, operador, unidad, cliente)
### CA-003: Capturar evidencias
**Dado** que necesito documentar la incidencia
**Cuando** adjunto evidencias
**Entonces** puedo agregar fotos, documentos y declaraciones
### CA-004: Campos obligatorios por tipo
**Dado** que cada tipo tiene requisitos especificos
**Cuando** registro una incidencia tipo DANO
**Entonces** debo capturar fotos y descripcion del dano obligatoriamente
### CA-005: Registro offline
**Dado** que el operador puede estar sin conexion
**Cuando** registra una incidencia en campo
**Entonces** se guarda localmente y sincroniza al tener red
---
## Mockup / UI
```
+----------------------------------------------------------+
| REGISTRAR INCIDENCIA X |
+----------------------------------------------------------+
| |
| Viaje: VJE-0125 | CDMX -> Monterrey |
| Operador: Juan Perez Garcia |
| Cliente: CEMEX S.A. |
| |
| ------------------------------------------------------ |
| |
| TIPO DE INCIDENCIA |
| |
| [Dano a mercancia v] |
| |
| Severidad: [CRITICA] (segun tipo) |
| |
| ------------------------------------------------------ |
| |
| DESCRIPCION |
| |
| [Caja de producto X danada durante descarga. ]|
| [Se cayo de la tarima al mover con montacargas. ]|
| |
| ------------------------------------------------------ |
| |
| EVIDENCIAS * |
| |
| [+ Agregar foto] [+ Agregar documento] |
| |
| [IMG] dano_caja_1.jpg (2.3 MB) [X] |
| [IMG] dano_caja_2.jpg (1.8 MB) [X] |
| [DOC] acta_recepcion.pdf (450 KB) [X] |
| |
| * Minimo 1 foto requerida para tipo DANO |
| |
| ------------------------------------------------------ |
| |
| DATOS ADICIONALES |
| |
| Responsable aparente: |
| ( ) Operador |
| (o) Almacen destino |
| ( ) Tercero |
| ( ) No determinado |
| |
| Valor estimado del dano: [$4,500.00] |
| |
| ------------------------------------------------------ |
| |
| [Cancelar] [Registrar Incidencia] |
| |
+----------------------------------------------------------+
```
---
## Notas Tecnicas
- Tabla: `tracking.incidencias`
- Tabla: `tracking.evidencias_incidencia`
- Fotos se comprimen antes de subir (max 2MB)
- Evidencias a S3 con metadatos (geo, timestamp)
- Validar campos obligatorios segun tipo
---
## Definicion de Done
- [ ] Catalogo de tipos de incidencia
- [ ] Formulario de registro con campos dinamicos
- [ ] Carga de multiples evidencias
- [ ] Validacion de campos obligatorios por tipo
- [ ] Soporte offline con sincronizacion
- [ ] Asociacion automatica a viaje activo
- [ ] Tests de registro y evidencias