rckrdmrd
ea1879f4ad
- Configure workspace Git repository with comprehensive .gitignore - Add Odoo as submodule for ERP reference code - Include documentation: SETUP.md, GIT-STRUCTURE.md - Add gitignore templates for projects (backend, frontend, database) - Structure supports independent repos per project/subproject level Workspace includes: - core/ - Reusable patterns, modules, orchestration system - projects/ - Active projects (erp-suite, gamilit, trading-platform, etc.) - knowledge-base/ - Reference code and patterns (includes Odoo submodule) - devtools/ - Development tools and templates - customers/ - Client implementations template 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
389 lines
13 KiB
Markdown
389 lines
13 KiB
Markdown
# 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](../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](../04-fase-backlog/README.md)
|
||
|
||
---
|
||
|
||
## 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/](../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/](../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](../01-requerimientos/proyecto/VISION-PRODUCTO.md) - Especificaciones técnicas detalladas
|
||
- [ESTRATEGIA-NEGOCIO.md](../01-requerimientos/proyecto/ESTRATEGIA-NEGOCIO.md) - Modelo de negocio y financials
|
||
- [ONBOARDING.md](./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/](../02-especificaciones-tecnicas/arquitectura/))
|
||
|
||
**Para desarrollo:**
|
||
- [docs/03-desarrollo/](../03-desarrollo/) - Guías técnicas de desarrollo
|
||
- [apps/backend/_MAP.md](../../apps/backend/_MAP.md) - Estructura del backend
|
||
- [apps/frontend/_MAP.md](../../apps/frontend/_MAP.md) - Estructura del frontend
|
||
|
||
**Para requerimientos detallados:**
|
||
- [Casos de Uso - Estudiante](../01-requerimientos/casos-uso/student/) - UC-STU-001 a UC-STU-003
|
||
- [Sistema de Gamificación](../01-requerimientos/gamificacion/README.md) - Rangos Maya, ML Coins, Achievements
|
||
- [Módulos Educativos](../01-requerimientos/modulos/README-MODULOS-EDUCATIVOS.md) - 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
|