Sprint 2 Etapas 1-2: modelo recursos utilizationMinutes+units, Dexie v3, ActivityPanel wow

cowork/InQ ROI - Simulador de procesos/CLAUDE.md

@@ -0,0 +1,115 @@
+# 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:** 2 (en curso)
+**Fase:** 1 — ROI y escenarios de automatización
+**Deploy activo:** https://process-cost-platform.pages.dev
+**Usuario objetivo actual:** equipo de InQuality — uso interno en talleres y pre-venta
+
+**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.
+
+---
+
+## Eje de Sprint 2
+
+**Feature central:** completar y mejorar el modelo de recursos con costo por hora (ya parcialmente implementado desde el MVP). Ver `simulador-web/sprints/sprint-2/BRIEF.md` para scope completo.
+
+**Hallazgo relevante:** el modelo de recursos existe en el código (`Resource`, `ActivityResourceAssignment`, `ResourcesPanel`, lógica de simulación). Sprint 2 migra el modelo de `utilizationPercent` → `utilizationMinutes + units` y construye la experiencia "wow" encima.
+
+**Etapas definidas:**
+
+| Etapa | Contenido |
+|---|---|
+| 1 | Migración modelo: `utilizationPercent` → `utilizationMinutes + units`. Dexie v3. Tests. |
+| 2 | ActivityPanel "wow": inputs de minutos/unidades, cálculo en tiempo real, helper contextual |
+| 3 | Reporte web: desglose de recursos por actividad, CumulativeSavingsChart -inversión, fixes TECH_DEBT |
+| 4 | UX rápidos: edición inline proceso/cliente |
+| 5 | PDF: tabla de recursos + verificación truncamiento |
+| 6 | E2E tests + validación visual del director |
+
+---
+
+## 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: colores saturados `#10B981 / #F59E0B / #EF4444` (revisar Sprint 3-4)
+
+---
+
+## 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 |
+| `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.