inq-roi-simulador-web/docs/COVERAGE_STATE.md

# Estado de cobertura — fin de Sprint 1.5

> Generado: Etapa 10, 18 mayo 2026.
> Base: 526 tests unitarios (33 archivos), suite E2E Playwright.
> Propósito: baseline de partida para Sprint 2.

---

## Resultado de la suite al cierre del sprint

### Tests unitarios (Vitest)

| Métrica | Valor |
|---|---|
| Total tests | 526 |
| Verdes | 526 |
| Rojos | 0 |
| Skip | 0 |
| Archivos de test | 33 |
| Duración | ~7 segundos |

### Tests E2E (Playwright)

| Métrica | Valor |
|---|---|
| Total tests | 38 |
| Verdes | 34 |
| Rojos | 4 (ver Regresiones documentadas) |
| Skip | 0 |
| Duración | ~75 segundos |

### Build / Typecheck / Lint

| Check | Estado | Nota |
|---|---|---|
| `npm run build` | ✅ Limpio | 2865 módulos, ~1 segundo |
| `npm run typecheck` | ✅ Sin errores | TypeScript strict |
| `npm run lint` | ⚠️ 3 errores, 92 warnings | Errores = `no-irregular-whitespace` en tests preexistentes; warnings = `@typescript-eslint/no-explicit-any` esperados en interfaces jsPDF |

---

## Regresiones documentadas (sin acción correctiva)

### RE-01 — `etapa-4-pdfs.spec.ts` (3 tests)

**Tipo:** test obsoleto, no regresión de producción.

**Síntoma:** los tests esperan 3 páginas en Actual/Automatizado y 4 en ROI.
El producto ahora genera 4 y 5 páginas respectivamente (cambios de Etapas 5-8).

**Causa:** el archivo fue escrito para el baseline de Etapa 4 y no se actualizó
cuando Etapas 5, 7 y 8 cambiaron la estructura de páginas.

**Impacto:** ninguno en producción. Los PDFs son correctos.

**Acción Sprint 2:** actualizar las aserciones de página en `etapa-4-pdfs.spec.ts`
o archivarlo en `tests/e2e/archive/` como registro histórico.

### RE-02 — `prod-smoke.spec.ts` (1 test)

**Tipo:** test obsoleto, no regresión de producción.

**Síntoma:** el test verifica `page.title` con `/Process Cost Platform/`
pero el título actual es `"InQ ROI — Cuantificá tus procesos"`.

**Causa:** la migración de marca se hizo en Etapa 2 del Sprint 1.5. El smoke test
no se actualizó al momento del cambio.

**Impacto:** ninguno en producción.

**Acción Sprint 2:** actualizar el selector del smoke test a `/InQ ROI/`.

---

## Áreas con cobertura sólida (unitarios + E2E)

### Motor de simulación BPMN

- `tests/domain/` — simulación determinística, gateways XOR/AND, probabilidades
- `tests/integration/bpmn-parser.test.ts` — parsing de procesos reales
- `tests/integration/bpmn-collaboration.test.ts` — colaboración
- **Evaluación:** muy sólida. El motor es el corazón del producto y está bien cubierto.

### Cálculo de ROI

- `tests/domain/roi.test.ts` — casos edge (inversión cero, ahorro negativo, payback infinito)
- `tests/lib/format-payback.test.ts` — 12 casos del formateador
- **Evaluación:** sólida. Cálculos puros con edge cases cubiertos.

### Exportación PDF — 3 generadores

- `tests/lib/export/pdf-orientation.test.ts` — orientaciones portrait/landscape
- `tests/lib/export/pdf-roi-page1.test.ts` — página 1 del ROI (gradiente, Top3, grid)
- `tests/lib/export/pdf-roi-pages2-5.test.ts` — tablas, análisis, metodología, gráfico SVG
- `tests/lib/export/pdf-scenario-page1.test.ts` — página 1 Actual/Automatizado
- `tests/lib/export/pdf-sections-shared.test.ts` — header/footer compartidos
- E2E: Etapas 4-8 validan PDFs reales con pdfjs-dist
- **Evaluación:** la más completa del sprint. Cobertura unitaria + E2E de los 3 PDFs.

### Helpers de formato

- `tests/lib/format.test.ts` — currency, minutes, timestamp
- `tests/lib/format-payback.test.ts` — payback en todos los rangos
- `tests/lib/colors.test.ts` — tokens de color del heatmap
- **Evaluación:** sólida. Funciones puras con muchos casos.

### Design tokens

- `tests/design-system/tokens.test.ts` — paleta InQ, colores CONCILIA excluidos
- **Evaluación:** básica pero suficiente para validar el sistema de identidad.

### Badge de automatización en BpmnCanvas

- `tests/features/workspace/BpmnCanvas.test.tsx` — lifecycle overlay, posición, HTML
- `tests/features/workspace/BpmnCanvas-badge.test.ts` — propiedades CSS del badge
- E2E: `etapa-9-badge.spec.ts` — aparece/desaparece/reaparece, screenshots
- **Evaluación:** sólida tras Etapa 9.

### Invalidación del store de simulación

- `tests/store/simulation-store-invalidation.test.ts` — 7 casos de invalidación
- **Evaluación:** sólida para los escenarios cubiertos.

---

## Áreas con cobertura parcial

### Componentes React del reporte

- `tests/features/report/` existe con tests de `CumulativeSavingsChart`, `ComparisonTable`, `RoiKpiBar`
- **Gap:** los tests son snapshots. No validan comportamiento interactivo ni edge cases de renderizado.
- **Riesgo:** bajo a corto plazo, medio cuando se agreguen features.

### Persistencia (Dexie/IndexedDB)

- Cobertura: indirecta vía store tests
- **Gap:** no hay tests directos de la capa de persistencia (migraciones, lectura/escritura de procesos complejos)
- **Riesgo:** medio. Las migraciones son el punto más frágil — un error ahí destruye datos del usuario.

### ActivityPanel

- **Gap:** sin tests unitarios ni E2E específicos del panel de actividades
- El comportamiento se verifica indirectamente en tests E2E de generación de PDF
- **Riesgo:** medio. El panel es la interfaz principal de configuración.

---

## Áreas sin cobertura

### Flujo completo de importación BPMN

- No hay test E2E que valide el flujo completo: archivo BPMN inválido → error legible
- No hay test para BPMNs con pools/lanes (collaboration.test.ts cubre el parser, no el UX)
- **Riesgo:** medio. Los usuarios importan archivos de herramientas externas con formatos variables.

### Exportación CSV

- `tests/e2e/` tiene `export-pdf.spec.ts` y `export-roi.spec.ts` pero los CSV no se validan con el mismo rigor
- **Riesgo:** bajo por ahora.

### Regresión visual de PDFs (golden files)

- No hay comparación pixel-a-pixel de PDFs entre versiones
- **Riesgo:** medio-alto. Un cambio visual inadvertido en `pdf-sections.ts` puede pasar los tests actuales sin ser detectado.

### Edge cases del simulador con procesos grandes

- Tests del motor cubren procesos de 3-10 actividades
- **Gap:** procesos de 20+ actividades, gateways OR inclusivos, subprocesos anidados
- **Riesgo:** bajo a corto plazo.

### Gateway OR inclusivo

- El motor simula OR como XOR (documentado). No hay test que valide que la advertencia aparece.
- **Riesgo:** bajo hasta que se implemente OR real.

---

## Gaps priorizados para Sprint 2

### Alta prioridad

1. **Regresión visual PDF (golden files):** implementar comparación de PDF contra baseline usando `pdfjs-dist`. Guarda página como PNG y compara con imagen de referencia. Detecta cambios involuntarios.
2. **Tests de migración Dexie:** validar que cada versión del schema se migra correctamente sin pérdida de datos.
3. **Smoke test E2E con BPMN inválido:** verificar mensaje de error apropiado cuando el archivo no es BPMN válido.

### Media prioridad

4. **Tests del ActivityPanel:** verificar que el formulario de configuración de actividad persiste correctamente a IndexedDB.
5. **Actualizar tests obsoletos:** `etapa-4-pdfs.spec.ts` y `prod-smoke.spec.ts` (ver RE-01, RE-02).
6. **Tests de flujo completo negativo:** ¿qué pasa si se simula sin configurar ningún costo?

### Baja prioridad

7. **Tests de stress del simulador:** proceso con 30+ actividades y gateways anidados.
8. **Tests de exportación CSV:** validar contenido y estructura de los archivos CSV generados.