# 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
