125 lines
2.7 KiB
Markdown
125 lines
2.7 KiB
Markdown
# 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
|