91 lines
3.4 KiB
Markdown
91 lines
3.4 KiB
Markdown
# Caso de estudio: InQ ROI Sprint 1.5
|
|
|
|
> Primer caso completo del método aplicado en producción.
|
|
>
|
|
> **Período:** Mayo 2026
|
|
> **Producto:** InQ ROI — herramienta de cálculo de costos y ROI para procesos BPMN
|
|
> **Equipo:** 1 director técnico + Claude Code como agente de implementación
|
|
> **Duración real:** ~ [completar al cierre]
|
|
> **Sprint objetivo:** rediseño visual completo del producto con manual de marca InQ
|
|
|
|
---
|
|
|
|
## Acceso al material
|
|
|
|
Todos los artefactos del sprint están versionados en el repo del producto:
|
|
|
|
- **Brief del sprint:** `sprints/sprint-1-5/BRIEF.md`
|
|
- **Prompts por etapa:** `sprints/sprint-1-5/ETAPA_X_PROMPT.md`
|
|
- **Reportes por etapa:** `sprints/sprint-1-5/ETAPA_X_REPORT.md` (cuando se capturen)
|
|
- **Audits:** `sprints/sprint-1-5/etapa-X-audit.md`
|
|
- **Screenshots:** `tests/screenshots/etapa-X/`
|
|
- **PDFs generados:** `tests/e2e/__output__/`
|
|
|
|
---
|
|
|
|
## Estructura del sprint
|
|
|
|
11 etapas en orden:
|
|
|
|
| # | Etapa | Estado | Patrón principal aplicado |
|
|
|---|---|---|---|
|
|
| 1 | Setup del sistema de diseño | ✅ Cerrada | A.1, B.4 |
|
|
| 2 | Helper formatPayback + aplicación | ✅ Cerrada | C.3, E.1 |
|
|
| 3 | Rediseño web app con identidad InQ | 🔄 En curso | C.1, C.4 |
|
|
| 4 | PDF: header y footer compartidos | ⏳ Pendiente | |
|
|
| 5 | PDF: layout híbrido portrait + landscape | ⏳ Pendiente | |
|
|
| 6 | PDF: rediseño página 1 ROI | ⏳ Pendiente | |
|
|
| 7 | PDF: páginas 3 y 4 ROI | ⏳ Pendiente | |
|
|
| 8 | PDFs de Actual y Automatizado | ⏳ Pendiente | |
|
|
| 9 | Badge ⚡ en BpmnCanvas | ⏳ Pendiente | |
|
|
| 10 | Validación E2E final | ⏳ Pendiente | |
|
|
| 11 | Documentación + Deploy | ⏳ Pendiente | |
|
|
|
|
---
|
|
|
|
## Lecciones documentadas
|
|
|
|
### Patrones validados durante este caso
|
|
|
|
[Se completa al cierre del sprint con la lista de patrones que se validaron en práctica]
|
|
|
|
### Anti-patrones cazados durante este caso
|
|
|
|
- **AP.1 — Tests verdes como aprobación final**: caso del PDF de heatmap embebido en blanco (origen en MVP previo al sprint)
|
|
- **AP.2 — Pasamanos invertido**: notado por el director en Etapa 5, llevó a discusión meta sobre el método
|
|
- **AP.3 — Racionalización de output anómalo**: PDF de 36 KB con 4 páginas (Etapa 4 inicial)
|
|
- **AP.6 — Brief grande pegado en chat**: corregido a estructura `sprints/sprint-N/`
|
|
|
|
### Decisiones arquitectónicas memorables
|
|
|
|
- Heatmap saturado en lugar de pastel (decisión consciente vs propuesta inicial)
|
|
- Layout híbrido portrait + landscape en PDFs (resolución del problema "diagramas BPMN no entran en A4 vertical")
|
|
- font-weight 700 en CTAs para remediación WCAG parcial
|
|
- Carátula del PDF eliminada — info integrada en header de página 1
|
|
|
|
### Decisiones de producto memorables
|
|
|
|
- Posicionamiento como herramienta interna de InQuality (no producto independiente)
|
|
- Identidad propia (naranja) diferenciada de CONCILIA (morado) manteniendo familia visual
|
|
- Regla de marca no negociable: "InQ" siempre I-n-Q
|
|
- Detector de ROI inusual (>1000%) como feature de transparencia
|
|
|
|
---
|
|
|
|
## Métricas finales del sprint
|
|
|
|
[Completar al cierre]
|
|
|
|
- Cantidad de tests al inicio del sprint: 440
|
|
- Cantidad de tests al cierre: [N]
|
|
- Tamaño promedio de PDF inicial: [KB]
|
|
- Tamaño promedio de PDF final: [KB]
|
|
- Cantidad de screenshots de validación capturados: [N]
|
|
- Cantidad de iteraciones de mockup: [N]
|
|
|
|
---
|
|
|
|
## Reflexión final
|
|
|
|
[Completar al cierre del sprint con observaciones del director sobre qué funcionó, qué no, y qué cambiaríamos para el próximo proyecto]
|