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

Checklist de entrega — InQ ROI

Claude Code ejecuta este checklist ANTES de reportar una etapa como completada. El director ejecuta la sección "Validación visual" para el OK formal.

---

Tier 1 — Automatizado (bloquea entrega si falla)

Correr en este orden. Si cualquier comando falla, no entregar — corregir primero.

npm run build          # 0 errores TypeScript, bundle generado
npm run lint            # 0 errores ESLint
npm run test            # todos los tests Vitest verdes (reportar N/N)
npx playwright test     # todos los E2E verdes (reportar N/N)

Reportar en el mensaje de entrega:

• Build: ✅ limpio / ❌ N errores
• Lint: ✅ limpio / ❌ N warnings/errors
• Tests unitarios: ✅ N/N verdes
• Tests E2E: ✅ N/N verdes

Nota sobre E2E con auth: los specs que requieren sesión usan test.use({ storageState: 'tests/e2e/setup/auth-state.json' }). Ese archivo lo genera el globalSetup (tests/e2e/setup/auth-setup.ts) automáticamente al correr npx playwright test, usando el usuario de test (TEST_USER_EMAIL/TEST_USER_PASSWORD en .env.test, gitignored). Si .env.test no existe, el setup avisa por consola y los specs con auth fallan — no es necesario ningún paso manual previo más allá de tener .env.test configurado una vez.

---

Tier 2 — Deploy check (post-deploy en inq-roi.inqualityhq.com)

Abrir DevTools → Network tab. Realizar estas acciones y verificar:

Acción	Verificar
Cargar biblioteca (/)	Sin 500, sin 406 en simulations
Abrir cualquier proceso en workspace	Sin 500, activities y gateways con 200
Abrir catálogo de recursos (/recursos)	Sin 500, tabla carga con datos
Exportar PDF (cualquier proceso simulado)	Sin errores en consola, archivo descargado

---

Tier 3 — Validación visual (director)

Esta sección la completa el director. Claude Code NO puede aprobarla.

Siempre verificar

• Header muestra avatar del usuario logueado
• Ningún texto dice "Process Cost Platform" (nombre viejo)
• Marca "InQ" escrita correctamente (no INQ, no Inq)
• Botones primarios en naranja #F59845

Por área (verificar si la etapa tocó esa área)

Biblioteca

• Procesos cargan sin spinner infinito
• "Actualizado por [nombre]" visible en tarjetas
• Toggle Todos/Míos funciona

Workspace

• BPMN canvas renderiza el diagrama
• ActivityPanel abre al hacer click en una actividad
• ResourcesPanel muestra recursos usados en el proceso

Catálogo de recursos

• Tabla muestra recursos con badges de tipo coloreados
• Búsqueda por nombre funciona
• Filtro por tipo funciona
• Crear/editar recurso guarda en Supabase y aparece en la lista
• Recurso con costo 0.037 muestra $0.037 (no $0.04)

Auth

• Login muestra selector de cuentas de Google
• Logout redirige a /login
• Sin sesión, cualquier ruta protegida redirige a /login

PDF (si la etapa tocó PDF)

• Footer dice "Powered by InQuality"
• Sin caracteres rotos ni encodings incorrectos

---

Tier 4 — Integridad de datos (si la etapa tocó schema o repos)

Correr en Supabase Studio SQL Editor:

-- Sin procesos huérfanos (sin owner)
SELECT COUNT(*) FROM processes WHERE owner_id IS NULL;  -- debe ser 0

-- Sin actividades huérfanas
SELECT COUNT(*) FROM activities a
LEFT JOIN processes p ON p.id = a.process_id
WHERE p.id IS NULL;  -- debe ser 0

-- Sin recursos con tipo inválido
SELECT DISTINCT type FROM resources;
-- debe mostrar solo: person, role, system, equipment, supply

---

Nota sobre regresiones de PDF

Los tests E2E de PDFs (etapa-4-pdfs.spec.ts etc.) son la red de contención para regresiones de PDF. Si se tocó cualquier cosa de exportación o cálculos, correr específicamente:

npx playwright test tests/e2e/export-pdf.spec.ts tests/e2e/export-roi.spec.ts

---

Setup del usuario de test E2E (referencia, una sola vez por entorno)

1. Supabase Studio → Authentication → Add user (email/password, NO Google OAuth)
2. SQL Editor:

   insert into public.users (id, name, platform_role)
   values ('<uuid del usuario creado>', 'Nombre Test E2E', 'platform_admin');
   

3. Completar .env.test (gitignored, ver .env.example):

   TEST_USER_EMAIL=...
   TEST_USER_PASSWORD=...
   

4. npx playwright test genera tests/e2e/setup/auth-state.json automáticamente en cada corrida (también gitignored).