# CLAUDE.md — InQ ROI · Contexto estratégico del asesor > Este archivo es leído por el asesor técnico-estratégico en sesiones de Cowork. > Contiene estado del proyecto, decisiones activas y referencias operativas. > Las reglas de implementación (stack, código, marca en código) están en `simulador-web/CLAUDE.md`. > El rol del asesor y el método de trabajo están en las instrucciones del proyecto (system prompt). --- ## Estado actual del proyecto **Sprint:** 5 (en curso — BRIEF listo en `sprints/sprint-5/BRIEF.md`) **Fase:** 1 — ROI y escenarios de automatización **Deploy activo:** https://inq-roi.inqualityhq.com (Dokploy) · https://process-cost-platform.pages.dev **Usuario objetivo actual:** equipo de InQuality — uso interno en talleres y con clientes en curso **Sprint 4 cerrado el 2026-06-18.** Entregó: auth Supabase + Google Workspace OAuth, migración IndexedDB→PostgreSQL, RLS con `is_platform_admin()`, catálogo global de recursos (sin `processId`), identidad en UI (avatar/dropdown AppHeader, "Actualizado por"), ResourceCatalogPage + ResourceFormSheet, fix Web Locks API deadlock (`processLock`), fix `.maybeSingle()` en simulation-repo, fix `formatCostPerHour()` precisión dinámica, fix Google OAuth `prompt: 'select_account'`, catálogo con contexto de proceso (banner + query param `fromProcess`), batería E2E Sprint 4 + `docs/CHECKLIST_ENTREGA.md`. ~550+ tests. **Sprint 3 cerrado el 2026-05-27.** Entregó: biblioteca de procesos con grupos/tags/búsqueda (Dexie v4), indicador stale de simulación, zoom BPMN fit-viewport, recursos TO-BE en escenario automatizado (motor + UI + reporte + PDF), branding InQ ROI en todas las páginas (AppHeader + favicon + logos), kit de socialización del equipo (guía de usuario, guía de pre-venta, presentación PPTX). 561 tests. **Sprint 2 cerrado el 2026-05-20.** Entregó: modelo de recursos `utilizationMinutes + units` (migración Dexie v3), ActivityPanel "wow" con cálculo en tiempo real, reporte web con filas expandibles de desglose de recursos, edición inline de proceso/cliente, tabla de recursos en PDF (página condicional), 548 tests. Ver case study: `simulador-web/methodology/CASE_STUDIES/inq-roi-sprint-2.md`. **Sprint 1.5 cerrado el 2026-05-18.** Entregó: identidad visual completa, PDFs de clase profesional (3 documentos), badge ⚡ en canvas BPMN, ROI con 5 KPIs, sistema de componentes establecido. --- ## Sprint 5 — dirección estratégica UX polish + quick wins. Retorno al rebalanceo normal (60-70% web). Sin features de gran escala. - **Fix crítico:** workspace loading — se queda cargando sin refresh - **Fix + mejora:** zoom BPMN centering + controles zoom-in/zoom-out - **Heatmap:** gradiente continuo (percentil default, toggle min-max) - **Catálogo:** procesos por recurso + campo empresa en perfil - **Reporte:** columna eficiencia de automatización en ComparisonTable - **Deuda técnica:** E2E Dexie→Supabase + flakiness "Guardar" Ver `sprints/sprint-5/BRIEF.md` para scope completo. ## Sprint 4 — dirección estratégica (cerrado) Refactorización arquitectural completa. Sin features de producto nuevas. Ver `sprints/sprint-4/BRIEF.md`. --- ## Decisiones estratégicas activas (no reabrir) ### Identidad visual — estable hasta Sprint 4+ Paleta naranja `#F59845`, gradiente `→ #ED3E8F`, system-ui stack, componentes establecidos. No reabrir. ### Rebalanceo web/PDF — Sprint 2+ 60-70% web, 15-25% PDF, 10-15% infraestructura, 5-10% docs. Origen: cierre Sprint 1.5. ### Criterio de wow — obligatorio Cada etapa con feature nueva incluye versión mínima + versión wow. Default: wow si costo extra < 40%. ### Modelo de recursos — decisiones de Sprint 2 - **Scope:** por proceso (catálogo global en Sprint 3 con feedback real) - **Costo fijo:** convive con recursos. Costo total = fijo + recursos. - **Escenario automatizado:** recursos solo en AS-IS. TO-BE sigue con `automatedCostFixed`. - **Modelo:** `utilizationMinutes + units` reemplaza `utilizationPercent`. ### Modelo de escenarios — diferido Modelo B (dos BPMNs AS-IS / TO-BE) diferido a Sprint 3. Sprint 2 mantiene Modelo A. ### Múltiples simulaciones — diferido Historial de simulaciones y comparación de escenarios diferido a Sprint 3. --- ## Decisiones de producto pendientes de input externo - **Posicionamiento:** ¿herramienta interna InQuality o venta a otras consultoras? Post-Sprint 2. - **Nombre comercial:** "InQ ROI" es nombre de trabajo. Revisar Sprint 3-4. - **Métricas de éxito:** a definir con datos reales de uso interno. - **Manual de marca formal:** cuando exista, incorporar. Assets disponibles en `assets/`. --- ## Definiciones estables — no reabrir hasta nuevo aviso - Stack tecnológico (React + Vite + TypeScript + stack definido en `simulador-web/CLAUDE.md`) - Modelo de escenarios: Modelo A (un BPMN, dos pares de campos por actividad) - ROI: cálculos nominales simples sin VPN ni Monte Carlo - Heatmap: gradiente continuo 4 stops (#10b981→#f59e0b→#f97316→#ef4444), percentil default, toggle min-max (Sprint 5 Etapa 3) --- ## Referencias de archivos clave | Archivo | Propósito | |---|---| | `simulador-web/CLAUDE.md` | Reglas de implementación para Claude Code | | `simulador-web/sprints/sprint-2/BRIEF.md` | Scope completo de Sprint 2 (cerrado) | | `simulador-web/methodology/CASE_STUDIES/inq-roi-sprint-2.md` | Case study Sprint 2 | | `simulador-web/BACKLOG.md` | Features pendientes de asignación | | `simulador-web/TECH_DEBT.md` | Deuda técnica activa | | `simulador-web/STRATEGIC_DIRECTION.md` | Decisiones estratégicas históricas | | `simulador-web/OBSERVATIONS.md` | Hallazgos del sprint en curso | | `simulador-web/methodology/` | Patrones y anti-patrones del método | | `simulador-web/assets/` | Logos PNG + manual de marca PDF | | `simulador-web/cowork/InQ ROI - Simulador de procesos/ARCHITECTURE.md` | Arquitectura del sistema | --- ## Herramientas externas configuradas - **ClickUp:** workspace InQuality — backlog operativo, tareas del sprint, observaciones - **Google Drive:** workspace InQuality — assets de marca, documentos compartidos - Consultar estas fuentes antes de asumir que la información está en archivos locales --- ## Reglas del método (resumen operativo) Detalle completo en `simulador-web/methodology/`. Resumen: - **Validación visual mandatoria:** tests verdes ≠ OK formal. Todo artefacto visual requiere validación humana del director. - **Brief como contrato:** ninguna etapa arranca sin `ETAPA_X_PROMPT.md` aprobado. - **Iniciativa agéntica clasificada:** Nivel 1 (trivial) → ejecutar. Nivel 2 (visible) → ejecutar y reportar. Nivel 3 (marca/arquitectura/datos) → consultar antes. - **Auditoría adversarial:** buscar lo que está mal, no confirmar lo que está bien. - **Anti-patrón AP.8:** si un reporte parece "más limpio de lo esperado", sospechar adelanto silencioso.