# 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