workspace-v1/projects/erp-mecanicas-diesel/docs/02-definicion-modulos/MMD-006-cotizaciones/historias-usuario/US-MMD006-005-generar-pdf.md
rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4
Sistema NEXUS v3.4 migrado con:

Estructura principal:
- core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles)
- core/catalog: Catalogo de funcionalidades reutilizables
- shared/knowledge-base: Base de conocimiento compartida
- devtools/scripts: Herramientas de desarrollo
- control-plane/registries: Control de servicios y CI/CD
- orchestration/: Configuracion de orquestacion de agentes

Proyectos incluidos (11):
- gamilit (submodule -> GitHub)
- trading-platform (OrbiquanTIA)
- erp-suite con 5 verticales:
  - erp-core, construccion, vidrio-templado
  - mecanicas-diesel, retail, clinicas
- betting-analytics
- inmobiliaria-analytics
- platform_marketing_content
- pos-micro, erp-basico

Configuracion:
- .gitignore completo para Node.js/Python/Docker
- gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git)
- Sistema de puertos estandarizado (3005-3199)

Generated with NEXUS v3.4 Migration System
EPIC-010: Configuracion Git y Repositorios
2026-01-04 03:37:42 -06:00

6.1 KiB

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

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

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

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

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