# 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**
```gherkin
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**
```gherkin
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**
```gherkin
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**
```gherkin
DADO que un VIN ya existe
CUANDO importo con opcion "actualizar"
ENTONCES actualiza kilometraje
Y otros campos modificados
```

**Escenario 5: Vincular a flota**
```gherkin
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
