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

4.9 KiB

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