feat: MVP Fase 0 — Process Cost Platform v0.1.0

Plataforma completa de análisis de costos operativos basada en BPMN 2.0. Funcionalidades incluidas: - Import de archivos BPMN 2.0 por drag & drop + 3 procesos de ejemplo - Visualización read-only del diagrama (bpmn-js) - Configuración de actividades (costo, tiempo, recursos asignados) - CRUD de recursos (rol, persona, sistema, equipo, insumo) - Configuración global (moneda, overhead %, nombre, cliente) - Motor de simulación determinístico agregado con propagación de gateways XOR/AND - Reporte visual con mapa de calor en dos modos (relativo/absoluto) - Gráficos: KPIs, top actividades, composición, costo por recurso - Export PDF (jsPDF + html2canvas) y CSV (papaparse) - Persistencia en IndexedDB (Dexie) - 268 tests unitarios/integración + 6 E2E con Playwright - Deploy: https://process-cost-platform.pages.dev Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-14 01:58:40 -03:00
commit bed161c92a
97 changed files with 19638 additions and 0 deletions
--- a/tests/lib/export/csv-export.test.ts
+++ b/tests/lib/export/csv-export.test.ts
@@ -0,0 +1,220 @@
+import { describe, it, expect } from 'vitest'
+import { generateCsvContent } from '@/lib/export/csv-export'
+import type { Process, Simulation, Resource, SimulationResult } from '@/domain/types'
+
+// ─── Fixtures ─────────────────────────────────────────────────────────────────
+
+function makeProcess(currency: string, extras: Partial<Process> = {}): Process {
+  return {
+    id: 'p1', name: 'Proceso de Ventas', clientName: 'Empresa ABC',
+    bpmnXml: '', currency, overheadPercentage: 0.2,
+    createdAt: 0, updatedAt: 0, ...extras,
+  }
+}
+
+function makeSimulation(perActivity: SimulationResult['perActivity'] = []): Simulation {
+  const totalDirect = perActivity.reduce((s, a) => s + a.expectedDirectCost, 0)
+  const totalIndirect = perActivity.reduce((s, a) => s + a.expectedIndirectCost, 0)
+  return {
+    id: 'sim1', processId: 'p1',
+    executedAt: new Date('2026-05-13T10:00:00Z').getTime(),
+    result: {
+      totalCost: totalDirect + totalIndirect,
+      totalDirectCost: totalDirect,
+      totalIndirectCost: totalIndirect,
+      totalTimeMinutes: 90,
+      perActivity,
+      perResource: [],
+      warnings: [],
+    },
+  }
+}
+
+const mockActivities: SimulationResult['perActivity'] = [
+  {
+    activityId: 'a1', bpmnElementId: 'task1', activityName: 'Recibir solicitud',
+    expectedDirectCost: 500, expectedIndirectCost: 100, expectedTotalCost: 600,
+    percentOfTotal: 60, executionProbability: 1.0, expectedExecutions: 1.0,
+    executionTimeMinutes: 30, resourceCostBreakdown: [],
+  },
+  {
+    activityId: 'a2', bpmnElementId: 'task2', activityName: 'Análisis de crédito',
+    expectedDirectCost: 250, expectedIndirectCost: 50, expectedTotalCost: 300,
+    percentOfTotal: 30, executionProbability: 0.8, expectedExecutions: 0.8,
+    executionTimeMinutes: 60, resourceCostBreakdown: [],
+  },
+  {
+    activityId: 'a3', bpmnElementId: 'task3', activityName: 'Notificación al cliente',
+    expectedDirectCost: 83.33, expectedIndirectCost: 16.67, expectedTotalCost: 100,
+    percentOfTotal: 10, executionProbability: 0.5, expectedExecutions: 0.5,
+    executionTimeMinutes: 15, resourceCostBreakdown: [],
+  },
+]
+
+const resources: Resource[] = []
+
+// ─── BOM UTF-8 ────────────────────────────────────────────────────────────────
+describe('CSV — BOM UTF-8', () => {
+  it('comienza con BOM UTF-8 (\\uFEFF)', () => {
+    const csv = generateCsvContent({ process: makeProcess('USD'), simulation: makeSimulation(mockActivities), resources })
+    expect(csv.charCodeAt(0)).toBe(0xFEFF)
+  })
+
+  it('BOM está presente para PYG también', () => {
+    const csv = generateCsvContent({ process: makeProcess('PYG'), simulation: makeSimulation(mockActivities), resources })
+    expect(csv.charCodeAt(0)).toBe(0xFEFF)
+  })
+})
+
+// ─── Separadores ──────────────────────────────────────────────────────────────
+describe('CSV — separadores', () => {
+  it('USD: separador de columnas es coma ","', () => {
+    const csv = generateCsvContent({ process: makeProcess('USD'), simulation: makeSimulation(mockActivities), resources })
+    // Los headers deben estar separados por coma
+    const headerLine = csv.split('\r\n').find((l) => l.includes('Actividad'))!
+    expect(headerLine).toContain(',')
+    expect(headerLine).not.toContain(';')
+  })
+
+  it('PYG: separador de columnas es punto y coma ";"', () => {
+    const csv = generateCsvContent({ process: makeProcess('PYG'), simulation: makeSimulation(mockActivities), resources })
+    const headerLine = csv.split('\r\n').find((l) => l.includes('Actividad'))!
+    expect(headerLine).toContain(';')
+    expect(headerLine).not.toContain(',"Actividad"')
+  })
+
+  it('BRL: separador es punto y coma', () => {
+    const csv = generateCsvContent({ process: makeProcess('BRL'), simulation: makeSimulation(mockActivities), resources })
+    const headerLine = csv.split('\r\n').find((l) => l.includes('Actividad'))!
+    expect(headerLine).toContain(';')
+  })
+
+  it('EUR: separador es punto y coma', () => {
+    const csv = generateCsvContent({ process: makeProcess('EUR'), simulation: makeSimulation(mockActivities), resources })
+    const headerLine = csv.split('\r\n').find((l) => l.includes('Actividad'))!
+    expect(headerLine).toContain(';')
+  })
+})
+
+// ─── Separadores decimales ─────────────────────────────────────────────────────
+describe('CSV — separadores decimales', () => {
+  it('USD: decimal es punto "." → "500.00"', () => {
+    const csv = generateCsvContent({ process: makeProcess('USD'), simulation: makeSimulation(mockActivities), resources })
+    expect(csv).toContain('500.00')
+  })
+
+  it('PYG: decimal es coma "," → "500,00"', () => {
+    const csv = generateCsvContent({ process: makeProcess('PYG'), simulation: makeSimulation(mockActivities), resources })
+    expect(csv).toContain('500,00')
+  })
+
+  it('BRL: decimal es coma', () => {
+    const csv = generateCsvContent({ process: makeProcess('BRL'), simulation: makeSimulation(mockActivities), resources })
+    expect(csv).toContain('500,00')
+  })
+})
+
+// ─── Headers ──────────────────────────────────────────────────────────────────
+describe('CSV — headers', () => {
+  it('contiene "Actividad" en los headers', () => {
+    const csv = generateCsvContent({ process: makeProcess('USD'), simulation: makeSimulation(mockActivities), resources })
+    expect(csv).toContain('Actividad')
+  })
+
+  it('header de costo incluye la moneda: "Costo total (USD)"', () => {
+    const csv = generateCsvContent({ process: makeProcess('USD'), simulation: makeSimulation(mockActivities), resources })
+    expect(csv).toContain('Costo total (USD)')
+  })
+
+  it('header de costo incluye la moneda: "Costo total (PYG)"', () => {
+    const csv = generateCsvContent({ process: makeProcess('PYG'), simulation: makeSimulation(mockActivities), resources })
+    expect(csv).toContain('Costo total (PYG)')
+  })
+
+  it('contiene todos los headers requeridos', () => {
+    const csv = generateCsvContent({ process: makeProcess('USD'), simulation: makeSimulation(mockActivities), resources })
+    expect(csv).toContain('ID BPMN')
+    expect(csv).toContain('Tiempo (min)')
+    expect(csv).toContain('% del total')
+    expect(csv).toContain('Ejecuciones esperadas')
+    expect(csv).toContain('Recursos asignados')
+  })
+})
+
+// ─── Cantidad de filas ────────────────────────────────────────────────────────
+describe('CSV — cantidad de filas', () => {
+  it('tiene exactamente N filas de datos + header + metadata', () => {
+    const csv = generateCsvContent({ process: makeProcess('USD'), simulation: makeSimulation(mockActivities), resources })
+    // Quitar BOM antes de procesar para no confundir el filtro de comentarios
+    const csvNoBom = csv.startsWith('') ? csv.slice(1) : csv
+    const lines = csvNoBom.split('\r\n').filter((l) => l.trim() && !l.startsWith('#'))
+    // 1 header + N actividades
+    expect(lines).toHaveLength(mockActivities.length + 1)
+  })
+
+  it('0 actividades → solo header', () => {
+    const csv = generateCsvContent({ process: makeProcess('USD'), simulation: makeSimulation([]), resources })
+    const csvNoBom = csv.startsWith('') ? csv.slice(1) : csv
+    const lines = csvNoBom.split('\r\n').filter((l) => l.trim() && !l.startsWith('#'))
+    expect(lines).toHaveLength(1) // solo el header
+  })
+})
+
+// ─── Metadata de cabecera ─────────────────────────────────────────────────────
+describe('CSV — metadata', () => {
+  it('la metadata comienza con "# Proceso:"', () => {
+    const csv = generateCsvContent({ process: makeProcess('USD'), simulation: makeSimulation(mockActivities), resources })
+    expect(csv).toContain('# Proceso: Proceso de Ventas')
+  })
+
+  it('la metadata contiene el nombre del cliente', () => {
+    const csv = generateCsvContent({ process: makeProcess('USD'), simulation: makeSimulation(mockActivities), resources })
+    expect(csv).toContain('# Cliente: Empresa ABC')
+  })
+
+  it('la metadata contiene el costo total', () => {
+    const csv = generateCsvContent({ process: makeProcess('USD'), simulation: makeSimulation(mockActivities), resources })
+    expect(csv).toContain('# Costo total (USD)')
+  })
+})
+
+// ─── Caracteres especiales / UTF-8 ───────────────────────────────────────────
+describe('CSV — UTF-8 y caracteres especiales', () => {
+  it('nombres con acentos se preservan correctamente', () => {
+    const activitiesWithAccents: SimulationResult['perActivity'] = [{
+      activityId: 'a1', bpmnElementId: 't1',
+      activityName: 'Revisión y Análisis Crítico',
+      expectedDirectCost: 100, expectedIndirectCost: 20, expectedTotalCost: 120,
+      percentOfTotal: 100, executionProbability: 1, expectedExecutions: 1,
+      executionTimeMinutes: 30, resourceCostBreakdown: [],
+    }]
+    const csv = generateCsvContent({ process: makeProcess('USD'), simulation: makeSimulation(activitiesWithAccents), resources })
+    expect(csv).toContain('Revisión y Análisis Crítico')
+  })
+
+  it('nombre del proceso con ñ se preserva', () => {
+    const process = makeProcess('USD', { name: 'Gestión de la Compañía' })
+    const csv = generateCsvContent({ process, simulation: makeSimulation([]), resources })
+    expect(csv).toContain('Gestión de la Compañía')
+  })
+
+  it('actividad con nombre en blanco no rompe el CSV', () => {
+    const activitiesBlank: SimulationResult['perActivity'] = [{
+      activityId: 'a1', bpmnElementId: 't1', activityName: '',
+      expectedDirectCost: 0, expectedIndirectCost: 0, expectedTotalCost: 0,
+      percentOfTotal: 0, executionProbability: 1, expectedExecutions: 1,
+      executionTimeMinutes: 0, resourceCostBreakdown: [],
+    }]
+    expect(() => generateCsvContent({ process: makeProcess('USD'), simulation: makeSimulation(activitiesBlank), resources })).not.toThrow()
+  })
+})
+
+// ─── Recursos vacíos ──────────────────────────────────────────────────────────
+describe('CSV — recursos vacíos', () => {
+  it('actividad sin recursos → celda de recursos vacía (no rompe)', () => {
+    const csv = generateCsvContent({ process: makeProcess('USD'), simulation: makeSimulation(mockActivities), resources: [] })
+    // No debe crashear y el contenido es válido
+    expect(csv.length).toBeGreaterThan(0)
+    expect(csv).toContain('Recibir solicitud')
+  })
+})
--- a/tests/lib/export/measure-sizes.test.ts
+++ b/tests/lib/export/measure-sizes.test.ts
@@ -0,0 +1,88 @@
+/**
+ * Medición de tamaños de CSV para los 3 sample BPMNs.
+ * Este test calcula el tamaño en bytes del CSV generado para cada BPMN.
+ */
+import { describe, it } from 'vitest'
+import { readFileSync } from 'fs'
+import { resolve } from 'path'
+import { v4 as uuidv4 } from 'uuid'
+import { parseBpmnXml, extractActivityElements, extractGatewayElements } from '@/domain/bpmn-parser'
+import { runSimulation } from '@/domain/simulation'
+import { generateCsvContent } from '@/lib/export/csv-export'
+import { bpmnTypeToGatewayType } from '@/domain/types'
+import type { Activity, GatewayConfig, SimulationInput, Process, Simulation } from '@/domain/types'
+
+function loadBpmn(name: string): string {
+  return readFileSync(resolve(__dirname, '../../../public/sample-processes', name), 'utf-8')
+}
+
+function buildInput(xml: string, directCost: number): SimulationInput {
+  const graph = parseBpmnXml(xml)
+  const actEls = extractActivityElements(graph)
+  const gwEls = extractGatewayElements(graph)
+  const processId = 'measure-proc'
+
+  const activities = new Map<string, Activity>(
+    actEls.map((el) => [el.bpmnElementId, {
+      id: uuidv4(), processId, bpmnElementId: el.bpmnElementId, name: el.name,
+      type: el.type, directCostFixed: directCost, executionTimeMinutes: 30, assignedResources: [],
+    }])
+  )
+
+  const gateways = new Map<string, GatewayConfig>(
+    gwEls.map((el) => {
+      const gwType = bpmnTypeToGatewayType(el.gatewayType as any)
+      return [el.bpmnElementId, {
+        id: uuidv4(), processId, bpmnElementId: el.bpmnElementId, gatewayType: gwType,
+        branches: el.outgoing.map((flowId) => ({
+          flowId, targetElementId: graph.flows.get(flowId)?.targetRef ?? '',
+          probability: gwType === 'parallel' ? 1.0 : 1 / el.outgoing.length,
+        })),
+      }]
+    })
+  )
+
+  return {
+    processXml: xml, activities, gateways, resources: new Map(),
+    globalSettings: { currency: 'USD', overheadPercentage: 0.2 },
+  }
+}
+
+describe('Medición de tamaños de CSV — 3 sample BPMNs', () => {
+  const BPMNS = [
+    { file: 'simple-linear.bpmn', name: 'Proceso Lineal Simple', client: 'Demo' },
+    { file: 'medium-with-gateways.bpmn', name: 'Aprobación de Crédito', client: 'Banco ABC' },
+    { file: 'complex-with-loop.bpmn', name: 'Control de Calidad', client: 'Empresa XYZ' },
+  ]
+
+  for (const bpmn of BPMNS) {
+    it(`${bpmn.file}: mide tamaño del CSV`, () => {
+      const xml = loadBpmn(bpmn.file)
+      const result = runSimulation(buildInput(xml, 1000))
+
+      const process: Process = {
+        id: 'p1', name: bpmn.name, clientName: bpmn.client,
+        bpmnXml: xml, currency: 'USD', overheadPercentage: 0.2,
+        createdAt: 0, updatedAt: 0,
+      }
+
+      const simulation: Simulation = {
+        id: 's1', processId: 'p1',
+        executedAt: new Date('2026-05-13T12:00:00Z').getTime(),
+        result,
+      }
+
+      const csv = generateCsvContent({ process, simulation, resources: [] })
+      const bytes = new TextEncoder().encode(csv).length
+
+      console.log(`\n📊 ${bpmn.file}`)
+      console.log(`   Actividades: ${result.perActivity.length}`)
+      console.log(`   CSV size: ${bytes} bytes (${(bytes / 1024).toFixed(1)} KB)`)
+      console.log(`   CSV líneas de datos: ${result.perActivity.length} + 1 header + 7 meta`)
+      console.log(`   Costo total: $${result.totalCost.toFixed(2)}`)
+
+      // El CSV no debe ser vacío
+      expect(bytes).toBeGreaterThan(100)
+    })
+  }
+})
--- a/tests/lib/export/pdf-export.test.ts
+++ b/tests/lib/export/pdf-export.test.ts
@@ -0,0 +1,166 @@
+/**
+ * Smoke tests del export PDF.
+ * jsPDF + autotable se mockean porque requieren canvas/DOM completo.
+ * Se verifica: llamadas al builder, metadata, nombre de archivo, no-throw.
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+
+// ─── Mock de jsPDF ────────────────────────────────────────────────────────────
+const mockDoc = {
+  setProperties: vi.fn(),
+  setFont: vi.fn(),
+  setFontSize: vi.fn(),
+  setTextColor: vi.fn(),
+  setFillColor: vi.fn(),
+  setDrawColor: vi.fn(),
+  setLineWidth: vi.fn(),
+  text: vi.fn(),
+  rect: vi.fn(),
+  roundedRect: vi.fn(),
+  line: vi.fn(),
+  addImage: vi.fn(),
+  addPage: vi.fn(),
+  setPage: vi.fn(),
+  save: vi.fn(),
+  splitTextToSize: vi.fn().mockImplementation((text: string) => [text]),
+  internal: { getNumberOfPages: vi.fn().mockReturnValue(3) },
+}
+
+// Arrow functions no pueden ser constructoras — usar function() regular
+vi.mock('jspdf', () => {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  function MockJsPDF(this: any) { return mockDoc }
+  return { jsPDF: MockJsPDF }
+})
+
+vi.mock('jspdf-autotable', () => ({
+  default: vi.fn(),
+}))
+
+// ─── Fixtures ─────────────────────────────────────────────────────────────────
+
+import type { Process, Simulation } from '@/domain/types'
+
+const mockProcess: Process = {
+  id: 'p1', name: 'Proceso de Aprobación de Crédito',
+  clientName: 'Banco XYZ',
+  bpmnXml: '', currency: 'USD',
+  overheadPercentage: 0.2,
+  createdAt: 0, updatedAt: 0,
+}
+
+const mockSimulation: Simulation = {
+  id: 'sim1', processId: 'p1',
+  executedAt: new Date('2026-05-13T10:00:00Z').getTime(),
+  result: {
+    totalCost: 1200,
+    totalDirectCost: 1000,
+    totalIndirectCost: 200,
+    totalTimeMinutes: 90,
+    perActivity: [
+      {
+        activityId: 'a1', bpmnElementId: 'task1', activityName: 'Recibir solicitud',
+        expectedDirectCost: 600, expectedIndirectCost: 120, expectedTotalCost: 720,
+        percentOfTotal: 60, executionProbability: 1.0, expectedExecutions: 1.0,
+        executionTimeMinutes: 30, resourceCostBreakdown: [],
+      },
+      {
+        activityId: 'a2', bpmnElementId: 'task2', activityName: 'Procesar',
+        expectedDirectCost: 400, expectedIndirectCost: 80, expectedTotalCost: 480,
+        percentOfTotal: 40, executionProbability: 0.8, expectedExecutions: 0.8,
+        executionTimeMinutes: 60, resourceCostBreakdown: [],
+      },
+    ],
+    perResource: [],
+    warnings: [],
+  },
+}
+
+// ─── Tests ────────────────────────────────────────────────────────────────────
+
+describe('exportToPdf — smoke tests', () => {
+  beforeEach(() => { vi.clearAllMocks() })
+
+  it('no lanza error con parámetros válidos y heatmap null', async () => {
+    const { exportToPdf } = await import('@/lib/export/pdf-export')
+    await expect(exportToPdf({
+      process: mockProcess,
+      simulation: mockSimulation,
+      resources: [],
+      heatmapImageData: null,
+    })).resolves.not.toThrow()
+  })
+
+  it('llama a doc.addPage al menos una vez (estructura multi-página)', async () => {
+    const { exportToPdf } = await import('@/lib/export/pdf-export')
+    await exportToPdf({ process: mockProcess, simulation: mockSimulation, resources: [], heatmapImageData: null })
+    // El PDF tiene al menos 2 páginas (análisis + tabla)
+    expect(mockDoc.addPage).toHaveBeenCalled()
+  })
+
+  it('llama a setProperties con metadata correcta', async () => {
+    const { exportToPdf } = await import('@/lib/export/pdf-export')
+    await exportToPdf({ process: mockProcess, simulation: mockSimulation, resources: [], heatmapImageData: null })
+    expect(mockDoc.setProperties).toHaveBeenCalledWith(expect.objectContaining({
+      title: expect.stringContaining('Proceso de Aprobación de Crédito'),
+      author: 'Banco XYZ',
+      subject: 'Simulación de proceso BPMN',
+    }))
+  })
+
+  it('llama a doc.save con nombre de archivo correcto', async () => {
+    const { exportToPdf } = await import('@/lib/export/pdf-export')
+    await exportToPdf({ process: mockProcess, simulation: mockSimulation, resources: [], heatmapImageData: null })
+    const saveCall = mockDoc.save.mock.calls[0][0] as string
+    expect(saveCall).toMatch(/proceso-de-aprobacion-de-credito/)
+    expect(saveCall).toMatch(/banco-xyz/)
+    expect(saveCall).toMatch(/\.pdf$/)
+  })
+
+  it('NO llama a addImage cuando heatmapImageData es null', async () => {
+    const { exportToPdf } = await import('@/lib/export/pdf-export')
+    await exportToPdf({ process: mockProcess, simulation: mockSimulation, resources: [], heatmapImageData: null })
+    expect(mockDoc.addImage).not.toHaveBeenCalled()
+  })
+
+  it('llama a addImage cuando heatmapImageData está disponible', async () => {
+    const { exportToPdf } = await import('@/lib/export/pdf-export')
+    const fakeDataUrl = 'data:image/jpeg;base64,/9j/fake'
+    await exportToPdf({ process: mockProcess, simulation: mockSimulation, resources: [], heatmapImageData: fakeDataUrl })
+    expect(mockDoc.addImage).toHaveBeenCalledWith(fakeDataUrl, 'JPEG', expect.any(Number), expect.any(Number), expect.any(Number), expect.any(Number))
+  })
+
+  it('llama a addPageNumbers (setPage para el footer)', async () => {
+    const { exportToPdf } = await import('@/lib/export/pdf-export')
+    await exportToPdf({ process: mockProcess, simulation: mockSimulation, resources: [], heatmapImageData: null })
+    // addPageNumbers itera setPage para cada página
+    expect(mockDoc.setPage).toHaveBeenCalled()
+  })
+
+  it('llama a autoTable con head que contiene la moneda', async () => {
+    const autoTable = (await import('jspdf-autotable')).default as ReturnType<typeof vi.fn>
+    const { exportToPdf } = await import('@/lib/export/pdf-export')
+    await exportToPdf({ process: mockProcess, simulation: mockSimulation, resources: [], heatmapImageData: null })
+    expect(autoTable).toHaveBeenCalledWith(
+      expect.anything(),
+      expect.objectContaining({
+        head: expect.arrayContaining([
+          expect.arrayContaining([
+            expect.objectContaining({ content: expect.stringContaining('USD') }),
+          ]),
+        ]),
+      })
+    )
+  })
+
+  it('con warnings en el resultado: no lanza error', async () => {
+    const { exportToPdf } = await import('@/lib/export/pdf-export')
+    const simWithWarnings = {
+      ...mockSimulation,
+      result: { ...mockSimulation.result, warnings: ['Loop detectado en task1'] },
+    }
+    await expect(exportToPdf({
+      process: mockProcess, simulation: simWithWarnings, resources: [], heatmapImageData: null,
+    })).resolves.not.toThrow()
+  })
+})
--- a/tests/lib/export/slug.test.ts
+++ b/tests/lib/export/slug.test.ts
@@ -0,0 +1,83 @@
+import { describe, it, expect } from 'vitest'
+import { slugify, buildFileName } from '@/lib/export/slug'
+
+describe('slugify', () => {
+  it('"Proceso de Compras" → "proceso-de-compras"', () => {
+    expect(slugify('Proceso de Compras')).toBe('proceso-de-compras')
+  })
+
+  it('"Análisis Año 2025" → "analisis-ano-2025"', () => {
+    expect(slugify('Análisis Año 2025')).toBe('analisis-ano-2025')
+  })
+
+  it('elimina la ñ → n', () => {
+    expect(slugify('Gestión de Compañía')).toBe('gestion-de-compania')
+  })
+
+  it('elimina acentos (á é í ó ú ü)', () => {
+    expect(slugify('Ú ltimo Análisis Crítico')).toBe('u-ltimo-analisis-critico')
+  })
+
+  it('caracteres especiales → guiones', () => {
+    expect(slugify('Proceso #1 / Sub-proceso (test)')).toBe('proceso-1-sub-proceso-test')
+  })
+
+  it('múltiples espacios → un solo guión', () => {
+    expect(slugify('Proceso   de   ventas')).toBe('proceso-de-ventas')
+  })
+
+  it('string vacío → string vacío', () => {
+    expect(slugify('')).toBe('')
+  })
+
+  it('solo números → se mantienen', () => {
+    expect(slugify('2025')).toBe('2025')
+  })
+
+  it('ya en minúsculas sin acentos → sin cambios relevantes', () => {
+    expect(slugify('proceso-lineal')).toBe('proceso-lineal')
+  })
+
+  it('limita a 60 caracteres', () => {
+    const long = 'a'.repeat(100)
+    expect(slugify(long)).toHaveLength(60)
+  })
+})
+
+describe('buildFileName', () => {
+  // new Date(año, mes0, día) → fecha local sin ambigüedad de timezone
+  const date = new Date(2026, 4, 13) // 13 de mayo de 2026, local time
+
+  it('genera filename con proceso + cliente + fecha', () => {
+    const name = buildFileName('Proceso de Ventas', 'Banco ABC', date, 'pdf')
+    expect(name).toBe('proceso-de-ventas_banco-abc_20260513.pdf')
+  })
+
+  it('omite cliente si está vacío', () => {
+    const name = buildFileName('Proceso de Ventas', '', date, 'csv')
+    expect(name).toBe('proceso-de-ventas_20260513.csv')
+  })
+
+  it('omite cliente si es undefined', () => {
+    const name = buildFileName('Proceso', undefined, date, 'pdf')
+    expect(name).toBe('proceso_20260513.pdf')
+  })
+
+  it('extensión csv correcta', () => {
+    const name = buildFileName('test', 'cliente', date, 'csv')
+    expect(name).toMatch(/\.csv$/)
+  })
+
+  it('extensión pdf correcta', () => {
+    const name = buildFileName('test', 'cliente', date, 'pdf')
+    expect(name).toMatch(/\.pdf$/)
+  })
+
+  it('nombre con caracteres especiales queda limpio (sin #, paréntesis)', () => {
+    const name = buildFileName('Análisis #1', 'Empresa S.A.', date, 'csv')
+    // Verificar solo el slug (sin la extensión que tiene un punto legítimo)
+    const slug = name.replace(/\.\w+$/, '')
+    expect(slug).not.toMatch(/[#()]/)
+    expect(name).toMatch(/analisis/)
+  })
+})