erp-mecanicas-diesel/docs/02-definicion-modulos/MMD-005-vehiculos/historias-usuario/US-MMD005-008-importar-vehiculos.md

2.7 KiB

US-MMD005-008: Importar Vehiculos desde Excel

Metadata

Campo Valor
ID US-MMD005-008
Epica EPIC-MMD-005 - Vehiculos y Flotas
Modulo vehiculos
Prioridad P2
Story Points 3
Sprint Sprint 6
Estado Backlog

Historia de Usuario

Como administrador, quiero importar vehiculos masivamente desde Excel, para migrar datos de flotas grandes sin captura manual.

Descripcion Detallada

Cuando un cliente nuevo tiene muchos vehiculos, la captura manual es ineficiente. El sistema debe permitir importar desde Excel con validacion de datos.


Criterios de Aceptacion

Escenario 1: Descargar plantilla

DADO que quiero importar vehiculos
CUANDO descargo plantilla
ENTONCES obtengo Excel con columnas:
  | VIN | Placas | Marca | Modelo | Anio |
  | Motor | Serie motor | Kilometraje | Propietario |

Escenario 2: Validar archivo

DADO que subo archivo Excel
CUANDO el sistema valida
ENTONCES muestra preview:
  | Fila | VIN | Estado | Error |
  | 1 | 1XP... | OK | - |
  | 2 | ABC | Error | VIN invalido |
  | 3 | 2XP... | OK | - |

Escenario 3: Importar registros validos

DADO que hay registros validos
CUANDO confirmo importacion
ENTONCES importa solo los validos
Y genera reporte:
  | Importados | 48 |
  | Con error | 2 |
  | Total | 50 |

Escenario 4: Actualizar existentes

DADO que un VIN ya existe
CUANDO importo con opcion "actualizar"
ENTONCES actualiza kilometraje
Y otros campos modificados

Escenario 5: Vincular a flota

DADO que importo para flota especifica
CUANDO selecciono "Transportes Norte"
ENTONCES todos los vehiculos
Se vinculan a esa flota

Formato de Plantilla

Columna Obligatorio Validacion
VIN Si 17 caracteres
Placas Si Formato valido
Marca Si Lista catalogo
Modelo Si Texto
Anio Si 1990-2026
Motor No Lista catalogo
Serie motor No Alfanumerico
Kilometraje No Numerico
Propietario No Cliente existente

Tareas Tecnicas

Backend:

  • BE-208: Generador de plantilla Excel
  • BE-209: Parser de archivo
  • BE-210: Validador de registros
  • BE-211: Importador con transaccion

Frontend:

  • FE-204: Crear ImportVehicles wizard
  • FE-205: Crear ValidationPreview
  • FE-206: Crear ImportResults

Definition of Done (DoD)

  • Descargar plantilla
  • Validar archivo
  • Preview con errores
  • Importar validos
  • Actualizar existentes
  • Vincular a flota
  • Tests pasando

Creada por: Requirements-Analyst Fecha: 2025-12-06