# US-MMD006-005: Generar PDF de Cotizacion

## Metadata

| Campo | Valor |
|-------|-------|
| **ID** | US-MMD006-005 |
| **Epica** | EPIC-MMD-006 - Cotizaciones |
| **Modulo** | cotizaciones |
| **Prioridad** | P0 |
| **Story Points** | 5 |
| **Sprint** | Sprint 5 |
| **Estado** | Backlog |

---

## Historia de Usuario

**Como** recepcionista,
**quiero** generar un PDF profesional de la cotizacion,
**para** enviarlo al cliente por email o WhatsApp.

## Descripcion Detallada

El PDF debe tener formato profesional con logo del taller, datos del cliente y vehiculo, desglose de servicios y refacciones, totales, y espacio para firma de aprobacion.

---

## Criterios de Aceptacion

**Escenario 1: Generar PDF**
```gherkin
DADO que tengo una cotizacion completa
CUANDO hago clic en "Generar PDF"
ENTONCES se genera PDF con formato profesional
Y se puede descargar o ver en navegador
```

**Escenario 2: Contenido del PDF**
```gherkin
DADO que genero el PDF
CUANDO reviso el contenido
ENTONCES incluye:
  - Logo y datos del taller
  - Folio y fecha de cotizacion
  - Datos del cliente
  - Datos del vehiculo
  - Desglose de servicios
  - Desglose de refacciones
  - Subtotales, IVA y total
  - Vigencia de la cotizacion
  - Espacio para firma
```

**Escenario 3: Enviar por email**
```gherkin
DADO que genero el PDF
CUANDO hago clic en "Enviar por email"
ENTONCES se abre dialogo con email del cliente precargado
Y puedo personalizar el mensaje
Y se envia con PDF adjunto
```

**Escenario 4: Compartir por WhatsApp**
```gherkin
DADO que genero el PDF
CUANDO hago clic en "Enviar por WhatsApp"
ENTONCES se abre WhatsApp Web
Y se adjunta el PDF
Y se precarga mensaje con resumen
```

---

## Template del PDF

```
┌─────────────────────────────────────────────────┐
│  [LOGO]           TALLER DIESEL EXPRESS         │
│                   RFC: DME850101ABC             │
│                   Av. Principal 123, Monterrey  │
│                   Tel: 555-0100                 │
├─────────────────────────────────────────────────┤
│  COTIZACION: COT-2025-0001                      │
│  Fecha: 06/12/2025    Vigencia: 21/12/2025      │
├─────────────────────────────────────────────────┤
│  CLIENTE                                        │
│  Transportes del Norte SA de CV                 │
│  RFC: TNO920101XXX                              │
│  Tel: 555-0200                                  │
├─────────────────────────────────────────────────┤
│  VEHICULO                                       │
│  Kenworth T680 2020 - Placas: ABC-123           │
│  Motor: Cummins ISX15 - Serie: XXXXX            │
│  Km actual: 125,000                             │
├─────────────────────────────────────────────────┤
│  SERVICIOS                                      │
│  ─────────────────────────────────────────────  │
│  Cant  Descripcion                    Importe   │
│  1     Diagnostico computarizado      $500.00   │
│  5 hrs Reparacion bomba inyeccion   $2,250.00   │
│                                                 │
│  REFACCIONES                                    │
│  ─────────────────────────────────────────────  │
│  Cant  Descripcion                    Importe   │
│  1     Kit reparacion bomba         $3,500.00   │
│  2     Filtro diesel                  $450.00   │
│  20L   Aceite motor 15W40           $1,800.00   │
├─────────────────────────────────────────────────┤
│                       Subtotal:     $8,500.00   │
│                       IVA 16%:      $1,360.00   │
│                       TOTAL:        $9,860.00   │
├─────────────────────────────────────────────────┤
│  NOTAS:                                         │
│  - Tiempo estimado: 2 dias habiles              │
│  - Garantia: 30 dias en mano de obra            │
│  - Cotizacion valida por 15 dias                │
├─────────────────────────────────────────────────┤
│  AUTORIZACION                                   │
│                                                 │
│  ☐ APROBADO   ☐ RECHAZADO                       │
│                                                 │
│  Firma: ____________________  Fecha: ________   │
│  Nombre: _______________________________________│
└─────────────────────────────────────────────────┘
```

---

## Tareas Tecnicas

**Backend:**
- [ ] BE-104: Endpoint GET /api/quotes/:id/pdf
- [ ] BE-105: Template PDF con pdfkit o puppeteer
- [ ] BE-106: Endpoint POST /api/quotes/:id/send-email
- [ ] BE-107: Integracion con servicio de email

**Frontend:**
- [ ] FE-104: Boton "Generar PDF" en cotizacion
- [ ] FE-105: Vista previa de PDF
- [ ] FE-106: Dialogo de envio por email
- [ ] FE-107: Boton compartir WhatsApp

---

## Dependencias

**Depende de:**
- [ ] US-MMD006-001: Cotizacion creada
- [ ] US-MMD001-001: Datos del taller (logo, RFC)

---

## Definition of Done (DoD)

- [ ] Generar PDF con formato profesional
- [ ] Vista previa antes de descargar
- [ ] Envio por email
- [ ] Compartir por WhatsApp
- [ ] Tests pasando

---

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