erp-mecanicas-diesel/docs/02-definicion-modulos/MMD-006-cotizaciones/historias-usuario/US-MMD006-007-historial-cotizaciones.md

125 lines
2.8 KiB
Markdown

# US-MMD006-007: Ver Historial de Cotizaciones
## Metadata
| Campo | Valor |
|-------|-------|
| **ID** | US-MMD006-007 |
| **Epica** | EPIC-MMD-006 - Cotizaciones y Presupuestos |
| **Modulo** | cotizaciones |
| **Prioridad** | P1 |
| **Story Points** | 3 |
| **Sprint** | Sprint 7 |
| **Estado** | Backlog |
---
## Historia de Usuario
**Como** administrador,
**quiero** ver el historial y estadisticas de cotizaciones,
**para** analizar tasas de conversion y mejorar estrategias de venta.
## Descripcion Detallada
El historial de cotizaciones permite analizar el embudo de ventas: cuantas se generan, cuantas se aprueban, valor promedio, y tiempo de decision del cliente.
---
## Criterios de Aceptacion
**Escenario 1: Listar cotizaciones**
```gherkin
DADO que accedo al historial
CUANDO veo lista de cotizaciones
ENTONCES muestra:
| Folio | Cliente | Vehiculo | Total | Estado | Fecha |
| COT-001 | Transp Norte | T680 | $15,000 | Aprobada | Nov-20 |
| COT-002 | Fletes Sur | Cascadia | $8,500 | Pendiente | Nov-22 |
```
**Escenario 2: Filtrar por estado**
```gherkin
DADO que tengo muchas cotizaciones
CUANDO filtro por "Pendientes"
ENTONCES solo muestra cotizaciones sin respuesta
```
**Escenario 3: Dashboard de conversion**
```gherkin
DADO que veo estadisticas
CUANDO accedo al dashboard
ENTONCES muestra:
| Metrica | Valor |
| Cotizaciones mes | 45 |
| Aprobadas | 32 (71%) |
| Rechazadas | 8 (18%) |
| Pendientes | 5 (11%) |
| Valor promedio | $12,500 |
```
**Escenario 4: Tiempo de respuesta**
```gherkin
DADO que analizo tiempos
CUANDO veo "Tiempo de decision"
ENTONCES muestra:
| Rango | Cantidad |
| Mismo dia | 15 |
| 1-3 dias | 12 |
| 4-7 dias | 5 |
| > 7 dias | 3 |
```
**Escenario 5: Cotizaciones vencidas**
```gherkin
DADO que cotizaciones tienen vigencia 15 dias
CUANDO pasan 15 dias sin respuesta
ENTONCES se marcan como "Vencida"
Y se notifica para seguimiento
```
**Escenario 6: Seguimiento de cotizacion**
```gherkin
DADO que tengo cotizacion pendiente
CUANDO registro seguimiento:
| Fecha | Accion |
| Nov-23 | Llamada, cliente revisando |
| Nov-25 | Email recordatorio |
ENTONCES queda registro de gestiones
```
---
## Tareas Tecnicas
**Database:**
- [ ] DB-113: Vista `vw_quote_stats`
- [ ] DB-114: Tabla `quote_followups`
**Backend:**
- [ ] BE-226: Endpoint de estadisticas
- [ ] BE-227: Calculo de conversion
- [ ] BE-228: Job de vencimiento
- [ ] BE-229: CRUD seguimientos
**Frontend:**
- [ ] FE-221: Crear QuotesDashboard
- [ ] FE-222: Crear ConversionChart
- [ ] FE-223: Crear FollowupLog
---
## Definition of Done (DoD)
- [ ] Listar cotizaciones con filtros
- [ ] Dashboard de conversion
- [ ] Tiempo de respuesta
- [ ] Marcar vencidas
- [ ] Registro de seguimiento
- [ ] Tests pasando
---
**Creada por:** Requirements-Analyst
**Fecha:** 2025-12-06