workspace/projects/gamilit/docs/00-vision-general/VISION.md

Visión del Producto - GAMILIT Platform

Versión: 1.2 (Overview Executive Summary) Fecha: 2025-11-29 Última Actualización: Clarificación alcance MVP vs Backlog Audiencia: Stakeholders, nuevos desarrolladores, business team

Documento completo: Ver docs/01-requerimientos/proyecto/VISION-PRODUCTO.md para especificaciones técnicas detalladas.

---

🎯 ALCANCE MVP DEFINIDO

Componente	MVP ✅	Backlog ⏳
Módulos Educativos	M1-M3 (15 ejercicios)	M4-M5 (8 ejercicios)
Épicas	EXT-001 a EXT-006 (100%)	EXT-007 a EXT-011 (30-50%)
Portal Student	10 páginas funcionales	-
Portal Teacher	10 páginas funcionales	-
Portal Admin	7 páginas (P0+P1)	2 páginas (P2)
Tipos de Ejercicios	15 mecánicas	10 mecánicas

Ver documentación completa del backlog en Fase 4: Backlog

---

1. ¿Qué es GAMILIT Platform?

GAMILIT Platform (Gamilit) es una plataforma educativa gamificada que revoluciona el aprendizaje de comprensión lectora mediante:

• Contenido especializado sobre Marie Curie (vida, descubrimientos, legado científico)
• Gamificación cultural con sistema de rangos inspirado en la civilización Maya
• 23 tipos de ejercicios implementados (Módulos 1-3), 8 adicionales en backlog (M4-M5)
• Arquitectura multi-tenant preparada para escalar a 100+ escuelas

Mercado objetivo: Estudiantes de nivel medio superior (preparatoria, 15-18 años)

Modelo de negocio: B2B2C - Instituciones educativas suscriben a sus estudiantes

---

2. Visión y Propuesta de Valor

Declaración de Visión

"Transformar el aprendizaje de comprensión lectora en una experiencia gamificada culturalmente relevante, donde cada estudiante progresa a través de rangos inspirados en la civilización Maya mientras descubre el legado científico de Marie Curie."

Objetivos Estratégicos

1. Mejorar Comprensión Lectora

   • Desarrollar las 5 dimensiones de comprensión (literal, inferencial, crítica, digital, producción)
   • Personalizar rutas de aprendizaje según nivel
   • Medir progreso de forma objetiva y continua

2. Aumentar Engagement Estudiantil

   • Retención objetivo: >70% a 30 días (vs. 40% plataformas tradicionales)
   • Sesiones por semana: 2.5x más frecuentes
   • Tiempo promedio de sesión: >15 minutos

3. Escalar a Múltiples Instituciones

   • Soporte para 100+ escuelas simultáneas (multi-tenant)
   • Capacidad para 10,000+ usuarios concurrentes
   • Dashboard para profesores e instituciones

4. Innovar en Pedagogía Digital

   • Integración con IA para feedback personalizado
   • Mecánicas modernas (TikTok UI, debates digitales, fact-checking)
   • Contenido cultural relevante para LATAM

---

3. Estado Actual del Producto

Calificación Global: 7.5/10 - BETA+

✅ Fortalezas (85% base técnica sólida)

• 23 tipos de ejercicios implementados (M1-M3) ✅

  • Módulo 1 (Literal): 5 ejercicios ✅
  • Módulo 2 (Inferencial): 5 ejercicios ✅
  • Módulo 3 (Crítica): 5 ejercicios ✅
  • Módulo 4 (Digital): 5 ejercicios ⚠️ BACKLOG
  • Módulo 5 (Producción): 3 ejercicios ⚠️ BACKLOG

  Nota: M4-M5 diseñados pero no implementados. Requieren evaluación con IA o revisión manual. Ver docs/04-fase-backlog/

• Sistema de gamificación 78% completo

  • Rangos Maya (5 niveles) ✅
  • ML Coins (economía virtual) ✅
  • Achievements (parcial, 2 activos)
  • Misiones (daily/weekly) ✅

• Infraestructura robusta

  • 150+ endpoints backend funcionales
  • 50+ componentes React 19
  • Base de datos PostgreSQL bien diseñada (42 tablas, 11 schemas, 208 índices)

⚠️ Áreas de Mejora (Sprint 0-3, estimado 5-6 semanas)

• Seguridad: Vulnerabilidades críticas (SQL injection, XSS) - P0
• Funcionalidad: Bugs en autenticación y progreso - P0
• Performance: Tiempo de carga 5.5s (objetivo <2s) - P1
• Testing: Coverage insuficiente (objetivo 70%) - P1

---

4. Modelo Educativo

Cinco Dimensiones de Comprensión Lectora

Módulo	Dimensión	Objetivo Pedagógico	Estado
M1	Comprensión Literal	Identificar información explícita	✅ Implementado
M2	Comprensión Inferencial	Deducir información implícita	✅ Implementado
M3	Comprensión Crítica	Evaluar y argumentar	✅ Implementado
M4	Lectura Digital	Navegar medios digitales, fact-checking	⚠️ Backlog
M5	Producción de Textos	Crear contenido multimedia propio	⚠️ Backlog

M4-M5 en Backlog: Requieren tecnologías avanzadas (IA, análisis multimedia) no disponibles actualmente. Ver 04-fase-backlog/ para detalles.

Sistema de Progresión

Flujo de aprendizaje:

1. Estudiante accede a módulo desbloqueado por su rango
2. Selecciona y completa ejercicio con mecánica específica
3. Recibe feedback inmediato y scoring
4. Gana ML Coins, XP y actualiza progreso
5. Al completar módulo, puede ascender de rango

Requisitos:

• Score mínimo de 70% para avanzar
• Intentos ilimitados (configurable)
• Sistema de hints con costo en ML Coins

---

5. Modelo de Gamificación

Sistema de Rangos Maya

Progresión inspirada en la jerarquía de la civilización Maya:

Rango	Requisito	Multiplicador	ML Coins Bonus	Significado
Ajaw (Señor)	1 módulo completo	1.0x	50	Iniciado en el conocimiento
Nacom (Capitán de Guerra)	2 módulos	1.25x	75	Explorador emergente
Ah K'in (Sacerdote del Sol)	3 módulos	1.5x	100	Analítico distinguido
Halach Uinic (Hombre Verdadero)	4 módulos	1.75x	125	Crítico y líder
K'uk'ulkan (Serpiente Emplumada)	5 módulos	2.0x	150	Maestro supremo

Economía ML Coins

ML Coins = Machine Learning Coins (moneda virtual de la plataforma)

Formas de ganar:

• Completar ejercicio: 15 coins base
• Score perfecto (100%): +6 a +12 coins
• Primer intento exitoso: +15 coins
• Streak diario: +2 coins × días consecutivos
• Completar módulo: +50 coins
• Achievement desbloqueado: +25 a +200 coins
• Daily login: +10 coins
• Promoción de rango: +50 a +150 coins

Formas de gastar:

• Power-up "Pistas": 15 coins
• Power-up "Visión Lectora": 25 coins
• Power-up "Segunda Oportunidad": 40 coins

Multiplicadores: Todos los earnings se multiplican por el multiplicador del rango actual.

Ejemplo: Estudiante en rango Nacom (1.25x) completa ejercicio perfecto: 27 coins × 1.25 = 33 coins

Achievements y Misiones

Achievements (6 categorías):

• Progress, Streak, Completion, Mastery, Exploration, Special
• Rareza: Common (25 coins) → Legendary (200 coins)

Misiones:

• Daily: 3 misiones, expiran en 24h
• Weekly: 5 misiones, expiran en 7 días
• Special: Sin expiración, eventos especiales

---

6. Arquitectura y Stack Tecnológico

Stack Principal

Frontend:

• React 19 + TypeScript 5.9
• Vite (build tool)
• Tailwind CSS 4 (estilos)
• Framer Motion 12 (animaciones)
• Zustand (estado global)
• Zod 4 (validación)

Backend:

• Node.js + Express.js + TypeScript
• PostgreSQL 15+ (base de datos)
• JWT (autenticación)
• WebSockets (real-time)

Infraestructura:

• API RESTful (150+ endpoints)
• PostgreSQL: 42 tablas, 11 schemas, 208 índices
• Multi-tenant architecture (tenant_id en todas las tablas)

Capacidad y Escalabilidad

Capacidad actual:

• 500 usuarios concurrentes
• Tiempo de carga: 5.5 segundos
• Bundle frontend: 855 KB

Capacidad objetivo (con optimizaciones Sprint 2-3):

• 5,000+ usuarios concurrentes
• Tiempo de carga: <2 segundos
• Bundle frontend: <300 KB

Optimizaciones planificadas:

• Redis cache
• Code splitting frontend
• Índices DB adicionales
• CDN para assets estáticos

---

7. Roles de Usuario

Estudiante (Rol Principal)

• Completar ejercicios de comprensión lectora
• Ganar ML Coins y XP
• Progresar a través de Rangos Maya
• Desbloquear achievements y misiones
• Competir en leaderboards
• Comprar power-ups

Profesor

• Ver dashboard de progreso de alumnos
• Asignar ejercicios y módulos
• Revisar intentos y calificaciones
• Generar reportes de clase
• Identificar estudiantes con dificultades

Administrador

• Gestionar usuarios y roles
• Configurar contenido educativo
• Monitorear estadísticas de plataforma
• Gestionar tenants (escuelas)

---

8. Métricas de Éxito

KPIs Técnicos (Post Sprint 0-3)

• Uptime: >99.5%
• Load time: <2s (p95)
• Error rate: <0.5%
• Security incidents: 0 críticos
• Usuarios concurrentes: 2,000-5,000

KPIs de Negocio (Primeros 3 meses)

• Usuarios registrados: 2,000
• Retention (30 días): >70%
• Churn mensual: <10%
• NPS: >50

KPIs Educativos

• Módulos completados promedio: >2 por estudiante
• Score promedio: >75%
• Tiempo de sesión: >15 minutos
• Ejercicios completados/semana: >5

---

9. Ventajas Competitivas

Diferenciadores vs. Competencia

1. Gamificación Cultural Única

   • Rangos Maya con significado histórico real
   • Narrativa cultural relevante para LATAM

2. Contenido Especializado

   • Marie Curie como hilo conductor (único en el mercado)
   • Narrativa coherente a través de 5 módulos

3. Mecánicas Innovadoras

   • Quiz estilo TikTok (UI moderna)
   • Debates con IA en tiempo real
   • Verificador de fake news
   • Análisis de memes educativos

4. Precio Competitivo

   • $18 USD/usuario/año (40% más económico que Classcraft $120/aula)
   • Modelo B2B2C escalable

5. Multi-tenant Architecture

   • Una sola plataforma para múltiples escuelas
   • Economías de escala

Comparación Rápida

Plataforma	Precio/año	Gamificación	Contenido Especializado
GLIT	$18	★★★★★	★★★★★ (Marie Curie)
Duolingo	$80	★★★★	★★★ (idiomas)
Khan Academy	Gratis	★★	★★★★ (matemáticas)
Classcraft	$120/aula	★★★★★	★★ (genérico)
Quizizz	$50/teacher	★★★	★★ (genérico)

---

10. Alcance del Proyecto

Incluido en v1.0

• 33 mecánicas educativas completas ✅
• Sistema de gamificación (Rangos Maya, ML Coins, misiones)
• Autenticación (JWT, roles, sesiones)
• Dashboard de progreso para estudiantes
• Backend completo (150+ endpoints)
• Frontend React completo (50+ componentes)

Fuera de Alcance v1.0 (Futuras versiones)

• OAuth/Social login (Google, Facebook)
• Mobile apps nativas (iOS/Android)
• Teacher Portal UI completo
• Analytics ML-based avanzado
• Sistema de video conferencia
• Gamificación de prestigio avanzada
• Guilds y sistema de amigos completo

---

11. Próximos Pasos

Sprint 0-3 (5-6 semanas) - Correcciones Críticas

P0 (Crítico):

1. Corregir vulnerabilidades de seguridad (SQL injection, XSS)
2. Resolver bugs en autenticación y progreso
3. Completar sistema de achievements
4. Testing completo (coverage >70%)

P1 (Alto): 5. Optimizar performance (tiempo de carga <2s) 6. Implementar Redis cache 7. Code splitting frontend 8. Completar dashboard de profesor

Post-Launch (3-6 meses)

• Onboarding de primeras 5 escuelas piloto
• Iteración basada en feedback de usuarios
• Expansión de contenido (más temas educativos)
• Features sociales avanzados (guilds, competencias)

---

📚 Documentación Relacionada

Para profundizar:

• VISION-PRODUCTO.md completo - Especificaciones técnicas detalladas
• ESTRATEGIA-NEGOCIO.md - Modelo de negocio y financials
• ONBOARDING.md - Guía de setup para nuevos desarrolladores
• ARQUITECTURA-ALTO-NIVEL.md - Diagrama de arquitectura del sistema (⏳ Planeado - ver docs/02-especificaciones-tecnicas/arquitectura/)

Para desarrollo:

• docs/03-desarrollo/ - Guías técnicas de desarrollo
• apps/backend/_MAP.md - Estructura del backend
• apps/frontend/_MAP.md - Estructura del frontend

Para requerimientos detallados:

• Casos de Uso - Estudiante - UC-STU-001 a UC-STU-003
• Sistema de Gamificación - Rangos Maya, ML Coins, Achievements
• Módulos Educativos - 5 módulos, 31 mecánicas

---

Documento preparado por: Tech Lead Fecha: 2025-11-07 Versión: 1.0 (Executive Summary) Clasificación: Interno

Última actualización: 2025-11-07