workspace/projects/gamilit/orchestration/roadmap/ROADMAP-MODULOS-4-5.md

# ROADMAP: MÓDULOS 4-5 (FASE 2)

**Estado:** DRAFT
**Fecha:** 2025-11-23
**Responsable:** Product Owner
**Aprobación requerida:** Product Owner, Tech Lead
**Versión:** 1.0

---

## 📍 ESTADO ACTUAL (2025-11-23)

### Módulo 4: Lectura Digital y Multimodal

**Estado Base de Datos:**
- `status='published'`, `is_published=true`
- **5 ejercicios con placeholders:** `is_active=false`
- Seeds creados: `apps/database/seeds/prod/educational_content/05-exercises-module4.sql`

**Estado UX/UI:**
- ✅ Visible en navegación principal
- ✅ Componente `UnderConstructionExercise` implementado
- ✅ Mensaje "En Construcción" al clickear

**Estado Diseño:**
- ✅ Documentado completo en DocumentoDeDiseño v6.4 (líneas 791-1063)
- ✅ Mecánicas definidas con detalle
- ✅ Validaciones especificadas

**Ejercicios definidos:**

| ID | Código | Título | Objetivo |
|----|--------|--------|----------|
| 4.1 | `verificador_fake_news` | Verificador de Fake News | Evaluar veracidad de titulares sobre Marie Curie |
| 4.2 | `infografia_interactiva` | Creación de Infografía Interactiva | Diseñar infografía digital sobre logros de Curie |
| 4.3 | `quiz_tiktok` | Quiz Estilo TikTok | 10 preguntas rápidas en formato vertical (60s) |
| 4.4 | `navegacion_hipertextual` | Navegación Hipertextual | Navegar artículo con enlaces (decisiones) |
| 4.5 | `analisis_memes` | Análisis de Memes Educativos | Evaluar contenido educativo vs superficial |

**XP y Recompensas:**
- XP por ejercicio: 100 XP
- XP total módulo: 500 XP
- Rango obtenido: **HALACH UINIC**
- ML Coins por módulo: 50 ML base + 30 ML bonus sin comodines

---

### Módulo 5: Producción y Expresión Lectora

**Estado Base de Datos:**
- `status='published'`, `is_published=true`
- **3 ejercicios con placeholders:** `is_active=false`
- Seeds creados: `apps/database/seeds/prod/educational_content/06-exercises-module5.sql`

**Estado UX/UI:**
- ✅ Visible en navegación principal
- ✅ Componente `UnderConstructionExercise` implementado
- ✅ Mensaje "En Construcción" al clickear

**Estado Diseño:**
- ✅ Documentado completo en DocumentoDeDiseño v6.4 (líneas 1066-1314)
- ✅ Mecánicas definidas con detalle
- ✅ Templates, prompts y rúbricas especificadas

**Opciones definidas (estudiante elige 1 de 3):**

| ID | Código | Título | Duración | Formato |
|----|--------|--------|----------|---------|
| 5A | `diario_multimedia` | Diario Interactivo de Marie | 8-10 páginas | Texto + imagen + audio |
| 5B | `comic_digital` | Resumen Visual Progresivo / Cómic Digital | 6-8 viñetas | Cómic digital |
| 5C | `video_carta` | Cápsula del Tiempo Digital | 3 minutos | Video |

**XP y Recompensas:**
- XP por ejercicio: 500 XP (uno solo elegido)
- XP total módulo: 500 XP
- Rango obtenido: **K'UK'ULKAN** (certificación final)
- ML Coins: Bonus de rango +1,000 ML (Halach Uinic → K'uk'ulkan)

---

## 🎯 ALCANCE FASE 2

### Objetivos Principales

1. **Implementar funcionalidad completa de 8 ejercicios**
   - 5 ejercicios Módulo 4
   - 3 opciones Módulo 5

2. **Activar ejercicios en producción**
   - Cambiar `is_active=false` → `is_active=true` tras implementación
   - Remover componente `UnderConstructionExercise`

3. **Completar progresión educativa**
   - Alcanzar 100% del sistema educativo diseñado
   - Permitir certificación final K'UK'ULKAN

4. **Habilitar XP total del sistema**
   - XP actual alcanzable: 1,500 XP (Módulos 1-3)
   - XP objetivo: 2,500 XP (Módulos 1-5)
   - Aumento: +1,000 XP (+66%)

### Impacto Esperado

**Para Usuarios:**
- ✅ Completar progresión educativa completa (5 módulos)
- ✅ Alcanzar rango máximo K'UK'ULKAN
- ✅ Obtener certificación final
- ✅ Experiencia educativa completa (100% contenido)

**Para Producto:**
- ✅ MVP educativo completo según DocumentoDeDiseño v6.4
- ✅ Diferenciación competitiva (lectura digital y producción creativa)
- ✅ Cumplimiento de promesa a stakeholders

**Para Negocio:**
- ✅ Producto comercializable al 100%
- ✅ Argumento de venta completo
- ✅ Capacidad de certificación formal

---

## 📅 TIMELINE PROPUESTO

### Q1 2026: Diseño Detallado (3 meses)

**Mes 1 - Enero 2026:**
- [ ] Diseño UX/UI Módulo 4 (ejercicios 4.1-4.3)
- [ ] Wireframes de Verificador Fake News
- [ ] Wireframes de Infografía Interactiva
- [ ] Wireframes de Quiz TikTok
- [ ] Prototipos interactivos de baja fidelidad

**Mes 2 - Febrero 2026:**
- [ ] Diseño UX/UI Módulo 4 (ejercicios 4.4-4.5)
- [ ] Diseño UX/UI Módulo 5 (3 opciones completas)
- [ ] Prototipos interactivos de alta fidelidad
- [ ] Sistema de componentes reutilizables

**Mes 3 - Marzo 2026:**
- [ ] Validación con usuarios (5-10 estudiantes)
- [ ] Iteración de diseños según feedback
- [ ] Especificación técnica detallada
- [ ] Definición de assets (imágenes, iconos, videos)

**Entregables Q1:**
- 📐 Diseños finales Figma (8 ejercicios)
- 📝 Especificación técnica completa
- 🎨 Biblioteca de componentes UI
- 📊 Reporte de validación con usuarios

---

### Q2 2026: Desarrollo Backend (3 meses)

**Mes 4 - Abril 2026:**
- [ ] Backend ejercicios 4.1-4.3
  - [ ] Validadores Verificador Fake News
  - [ ] Lógica Infografía Interactiva
  - [ ] Timer y scoring Quiz TikTok
- [ ] Tests unitarios (coverage ≥ 88%)
- [ ] Documentación API

**Mes 5 - Mayo 2026:**
- [ ] Backend ejercicios 4.4-4.5
  - [ ] Validadores Navegación Hipertextual
  - [ ] Sistema scoring Análisis Memes
- [ ] Backend ejercicio 5A (Diario Multimedia)
  - [ ] Upload de archivos multimedia
  - [ ] Sistema de rúbricas automáticas
- [ ] Tests unitarios (coverage ≥ 88%)

**Mes 6 - Junio 2026:**
- [ ] Backend ejercicios 5B-5C
  - [ ] Sistema de cómic digital
  - [ ] Upload y procesamiento de video
  - [ ] Validación de rúbricas
- [ ] Integración completa gamificación
  - [ ] Cálculo XP final (2,500 XP)
  - [ ] Otorgamiento rango K'UK'ULKAN
  - [ ] Generación de certificación
- [ ] Tests de integración E2E

**Entregables Q2:**
- ⚙️ Backend completo 8 ejercicios
- ✅ Tests coverage ≥ 88%
- 📚 Documentación API completa
- 🔌 Endpoints REST funcionales

---

### Q3 2026: Desarrollo Frontend + Testing (3 meses)

**Mes 7 - Julio 2026:**
- [ ] Frontend ejercicios 4.1-4.3
  - [ ] Componentes React de mecánicas
  - [ ] Integración con backend
  - [ ] Animaciones y efectos
- [ ] Tests unitarios frontend (coverage ≥ 88%)

**Mes 8 - Agosto 2026:**
- [ ] Frontend ejercicios 4.4-4.5 + 5A-5C
  - [ ] Componentes avanzados (upload, video, cómic)
  - [ ] Sistema de preview
  - [ ] Feedback visual en tiempo real
- [ ] Tests E2E completos (Cypress)
- [ ] Validación pedagógica con expertos

**Mes 9 - Septiembre 2026:**
- [ ] Beta testing con usuarios reales (20-30 estudiantes)
- [ ] Ajustes basados en feedback
- [ ] Performance optimization
- [ ] Accessibility audit (WCAG 2.1 AA)
- [ ] Preparación para release

**Entregables Q3:**
- 💻 Frontend completo 8 ejercicios
- ✅ Tests E2E completos
- 📊 Reporte validación pedagógica
- 🐛 Bugs críticos resueltos
- 🎯 Sistema listo para producción

---

### Q4 2026: Release y Optimización (3 meses)

**Mes 10 - Octubre 2026:**
- [ ] Ajustes post-beta testing
- [ ] Documentación de usuario final
- [ ] Materiales de marketing
- [ ] Capacitación a equipo de soporte

**Mes 11 - Noviembre 2026:**
- [ ] **Release a producción (Módulos 4-5)**
- [ ] Cambio `is_active=false` → `is_active=true`
- [ ] Monitoreo intensivo primera semana
- [ ] Soporte 24/7 durante lanzamiento

**Mes 12 - Diciembre 2026:**
- [ ] Análisis de métricas de adopción
- [ ] Optimización basada en uso real
- [ ] Iteración de contenido si necesario
- [ ] Planificación contenido adicional (expansiones)

**Entregables Q4:**
- 🚀 Módulos 4-5 en producción
- 📊 Dashboard de métricas
- 📈 Reporte de adopción Q4
- 🎓 Sistema educativo 100% completo

---

## 💰 PRESUPUESTO ESTIMADO

**⚠️ A DEFINIR POR PRODUCT OWNER**

### Estimación Preliminar

| Fase | Rol | Meses | Costo Estimado |
|------|-----|-------|----------------|
| **Q1: Diseño** | | | |
| UX/UI Designer | 3 meses dedicación | [TBD] |
| Pedagogo Consultor | 1 mes consultoría | [TBD] |
| **Q2: Desarrollo Backend** | | | |
| Backend Developer | 3 meses dedicación | [TBD] |
| QA Engineer | 1 mes testing | [TBD] |
| **Q3: Desarrollo Frontend** | | | |
| Frontend Developer | 3 meses dedicación | [TBD] |
| QA Engineer | 2 meses E2E testing | [TBD] |
| Beta Testers | 30 estudiantes | [TBD] |
| **Q4: Release** | | | |
| DevOps Engineer | 1 mes | [TBD] |
| Tech Lead (supervisión) | 0.5 meses | [TBD] |
| **TOTAL ESTIMADO** | **12 meses** | **[TBD]** |

### Consideraciones Adicionales

- Infraestructura: Almacenamiento video/multimedia (+storage)
- Licencias: Herramientas de diseño (Figma, Adobe)
- Contingencia: 15-20% del presupuesto total
- Marketing: Materiales de lanzamiento

---

## 📊 DEPENDENCIAS

### Dependencias Técnicas

**✅ Ya Resueltas:**
- Seeds placeholder creados (05-exercises-module4.sql, 06-exercises-module5.sql)
- Frontend `UnderConstructionExercise` implementado
- Sistema de detección `is_active` funcionando
- Estructura de base de datos lista

**⏳ Por Implementar:**
- Validadores específicos M4/M5 (backend)
- Componentes React M4/M5 (frontend)
- Sistema de upload multimedia (backend + frontend)
- Sistema de rúbricas automáticas (backend)
- Componente de video player (frontend)
- Componente de editor de cómic (frontend)

### Dependencias de Recursos

**Requeridos:**
- [ ] Frontend Developer (6 meses dedicación) - Q2-Q3
- [ ] Backend Developer (4 meses dedicación) - Q2-Q3
- [ ] UX Designer (3 meses dedicación) - Q1
- [ ] QA Engineer (3 meses dedicación) - Q2-Q4
- [ ] Pedagogo validador (1 mes consultoría) - Q1
- [ ] DevOps Engineer (1 mes dedicación) - Q4

**Opcionales:**
- [ ] Motion Designer (animaciones complejas)
- [ ] Content Creator (videos de ejemplo)
- [ ] Ilustrador (cómics de muestra)

### Dependencias de Stakeholders

- **Product Owner:** Aprobación de diseños (Q1) y release (Q4)
- **Tech Lead:** Revisión arquitectura (Q2) y code review (Q2-Q3)
- **Pedagogo:** Validación pedagógica (Q1, Q3)
- **Marketing:** Materiales lanzamiento (Q4)

---

## 🎓 CRITERIOS DE ACEPTACIÓN

### Módulo 4: Lectura Digital y Multimodal

**Funcionalidad:**
- [ ] 5 ejercicios funcionales con validación completa
- [ ] Todos los ejercicios `is_active=true`
- [ ] Navegación fluida entre ejercicios
- [ ] Feedback inmediato en cada interacción

**Gamificación:**
- [ ] Integración con sistema de XP/ML Coins
- [ ] Otorgamiento correcto de rango HALACH UINIC
- [ ] Multiplicadores de XP aplicados
- [ ] Comodines funcionando correctamente

**Calidad:**
- [ ] Tests coverage ≥ 88% (backend + frontend)
- [ ] Zero bugs críticos en producción
- [ ] Performance: carga ejercicios < 2 segundos
- [ ] Accessibility: WCAG 2.1 AA

**Documentación:**
- [ ] Documentación técnica completa (API, componentes)
- [ ] Documentación de usuario (guías de uso)
- [ ] TRACEABILITY.yml actualizado
- [ ] ADR creado si cambios arquitectónicos

**Validación Pedagógica:**
- [ ] Aprobación de pedagogo experto
- [ ] Validación con usuarios reales (≥ 20 estudiantes)
- [ ] Satisfacción ≥ 4.0/5.0 en encuestas

---

### Módulo 5: Producción y Expresión Lectora

**Funcionalidad:**
- [ ] 3 opciones funcionales (5A, 5B, 5C)
- [ ] Sistema de selección de opción (estudiante elige 1)
- [ ] Templates completos para cada opción
- [ ] Sistema de rúbricas implementado
- [ ] Generación de certificación final K'UK'ULKAN

**Gamificación:**
- [ ] XP final: 2,500 XP alcanzable
- [ ] Rango K'UK'ULKAN otorgado correctamente
- [ ] Bonus de +1,000 ML al alcanzar K'UK'ULKAN
- [ ] Dashboard de progreso 100% completo

**Calidad:**
- [ ] Tests coverage ≥ 88% (backend + frontend)
- [ ] Zero bugs críticos en producción
- [ ] Performance: upload multimedia funcional
- [ ] Sistema de preview funcional

**Documentación:**
- [ ] Documentación técnica completa
- [ ] Documentación pedagógica (rúbricas, criterios)
- [ ] TRACEABILITY.yml actualizado
- [ ] Certificación final diseñada y generada

**Validación Pedagógica:**
- [ ] Aprobación de pedagogo experto
- [ ] Validación con usuarios reales (≥ 20 estudiantes)
- [ ] Satisfacción ≥ 4.5/5.0 (certificación final)

---

## 📈 MÉTRICAS DE ÉXITO

### Métricas de Adopción (Q4 2026)

- **Completion rate Módulo 4:** ≥ 70% de usuarios que inician lo completan
- **Completion rate Módulo 5:** ≥ 60% de usuarios que inician lo completan
- **Time on task M4:** Dentro de estimado DocumentoDeDiseño
- **Time on task M5:** Dentro de estimado DocumentoDeDiseño
- **Certificaciones K'UK'ULKAN:** ≥ 50% de usuarios completan progresión completa

### Métricas de Calidad

- **User satisfaction:** ≥ 4.0/5.0 en encuestas (M4), ≥ 4.5/5.0 (M5)
- **Bug rate:** < 5 bugs críticos en primer mes
- **Performance:** Carga ejercicios < 2 segundos (P95)
- **Uptime:** ≥ 99.5% disponibilidad

### Métricas de Negocio

- **Retención:** ≥ 80% usuarios activos después de 30 días
- **Engagement:** ≥ 3 sesiones/semana promedio
- **Recomendación:** NPS ≥ 50
- **Certificaciones emitidas:** ≥ 100 en Q4 2026

---

## 🔄 PROCESO DE REVISIÓN

### Frecuencia

- **Mensual:** Revisión de progreso vs timeline
- **Trimestral:** Revisión de presupuesto y recursos
- **Hitos:** Revisión al final de cada fase (Q1-Q4)

### Responsables

- **Product Owner:** Decisiones de alcance y prioridades
- **Tech Lead:** Decisiones técnicas y arquitectura
- **Pedagogo:** Validación de contenido educativo

### Documentar en

Este archivo (sección Changelog al final)

---

## ⚠️ RIESGOS Y MITIGACIONES

### Riesgos Identificados

| Riesgo | Probabilidad | Impacto | Mitigación |
|--------|--------------|---------|------------|
| **Retraso en diseño UX/UI** | Media | Alto | Buffer de 2 semanas en Q1 |
| **Complejidad upload multimedia** | Alta | Alto | Prototipo técnico en Q2 mes 1 |
| **Validación pedagógica negativa** | Baja | Alto | Consultas tempranas con pedagogo (Q1) |
| **Performance sistema video** | Media | Medio | Tests de carga en Q3 mes 2 |
| **Recursos insuficientes** | Media | Alto | Contratación anticipada (Q1 inicio) |
| **Cambios de alcance** | Alta | Alto | Change control board (Product Owner) |

### Plan de Contingencia

**Si se retrasa Q1 (Diseño):**
- Priorizar diseños Módulo 4 (más crítico)
- Diferir Módulo 5 a fase posterior

**Si se retrasa Q2-Q3 (Desarrollo):**
- Release incremental: Módulo 4 primero, luego Módulo 5
- Ajustar timeline a 15 meses (Q1 2027)

**Si validación pedagógica falla:**
- Iteración adicional de diseño (1 mes)
- Nueva validación con grupo diferente

---

## 📎 REFERENCIAS

### Documentación Diseño

- **DocumentoDeDiseño v6.4:** `docs/00-vision-general/DocumentoDeDiseño_Mecanicas_GAMILIT_v6_1.md` (líneas 791-1314)
- **ADR-010:** DocumentoDeDiseño como Fuente de Verdad

### Documentación Técnica

- **Seeds Módulo 4:** `apps/database/seeds/prod/educational_content/05-exercises-module4.sql`
- **Seeds Módulo 5:** `apps/database/seeds/prod/educational_content/06-exercises-module5.sql`
- **Componente UnderConstruction:** `apps/frontend/src/features/exercises/components/UnderConstructionExercise.tsx`

### Documentación de Estrategia

- **Estrategia actual:** `docs/00-vision-general/ESTRATEGIA-MODULOS-4-5-EN-CONSTRUCCION.md`
- **Propuesta correcciones:** `orchestration/agentes/architecture-analyst/validation/PROPUESTA-ACTUALIZACIONES-DOCUMENTACION-2025-11-23.md`

---

## 🔄 CHANGELOG

### [1.0] - 2025-11-23

**Creado por:** Architecture-Analyst

**Contenido inicial:**
- Estado actual Módulos 4-5 documentado
- Timeline propuesto (Q1-Q4 2026, 12 meses)
- Presupuesto preliminar (TBD por Product Owner)
- Dependencias técnicas y de recursos identificadas
- Criterios de aceptación definidos
- Métricas de éxito establecidas
- Riesgos identificados con mitigaciones

**Referencias:**
- DocumentoDeDiseño v6.4 (fuente de verdad)
- REPORTE-COHERENCIA-DOCUMENTACION-CODIGO-2025-11-23.md
- PROPUESTA-ACTUALIZACIONES-DOCUMENTACION-2025-11-23.md

**Estado:** DRAFT - Pendiente de aprobación por Product Owner

---

## ✅ PRÓXIMOS PASOS INMEDIATOS

1. **Product Owner:** Revisar y aprobar roadmap
2. **Product Owner:** Definir presupuesto ([TBD])
3. **Product Owner + Tech Lead:** Priorizar vs otros proyectos
4. **Tech Lead:** Asignar recursos iniciales (Q1 2026)
5. **Architecture-Analyst:** Actualizar estado a "APROBADO" tras confirmación

---

**Versión:** 1.0 DRAFT
**Próxima revisión:** Tras aprobación de Product Owner
**Aprobación pendiente:** Product Owner, Tech Lead

---

**FIN DEL ROADMAP**