trading-platform/docs/02-definicion-modulos/OQI-002-education/_MAP.md
rckrdmrd c1b5081208 feat(ml): Complete FASE 11 - BTCUSD update and comprehensive documentation alignment
ML Engine Updates:
- Updated BTCUSD with Polygon API data (2024-2025): 215,699 new records
- Re-trained all ML models: Attention (R²: 0.223), Base, Metamodel (87.3% confidence)
- Backtest results: +176.71R profit with aggressive_filter strategy

Documentation Consolidation:
- Created docs/99-analisis/_MAP.md index with 13 new analysis documents
- Consolidated inventories: removed duplicates from orchestration/inventarios/
- Updated ML_INVENTORY.yml with BTCUSD metrics and training results
- Added execution reports: FASE11-BTCUSD, correction issues, alignment validation

Architecture & Integration:
- Updated all module documentation with NEXUS v3.4 frontmatter
- Fixed _MAP.md indexes across all folders
- Updated orchestration plans and traces

Files: 229 changed, 5064 insertions(+), 1872 deletions(-)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 09:31:29 -06:00

7.1 KiB

id title type project updated_date
MAP-OQI-002-education Mapa de OQI-002-education Index trading-platform 2026-01-04

_MAP: OQI-002 - Módulo Educativo

Última actualización: 2025-12-05 Estado: Parcialmente Implementado Versión: 1.0.0


Propósito

Esta épica implementa la plataforma educativa de Trading Platform, permitiendo a los usuarios aprender trading a través de cursos estructurados con video, texto, quizzes y sistema de progreso con gamificación.


Contenido del Directorio

OQI-002-education/
├── README.md                    # Documentación técnica existente
├── _MAP.md                      # Este archivo - índice
├── requerimientos/              # Documentos de requerimientos funcionales
│   ├── RF-EDU-001-catalogo.md   # Catálogo de cursos
│   ├── RF-EDU-002-lecciones.md  # Sistema de lecciones
│   ├── RF-EDU-003-progreso.md   # Tracking de progreso
│   ├── RF-EDU-004-quizzes.md    # Sistema de quizzes
│   ├── RF-EDU-005-certificados.md # Certificaciones
│   └── RF-EDU-006-gamificacion.md # XP y badges
├── especificaciones/            # Especificaciones técnicas
│   ├── ET-EDU-001-database.md   # Modelo de datos
│   ├── ET-EDU-002-api.md        # Endpoints REST
│   ├── ET-EDU-003-frontend.md   # Componentes React
│   ├── ET-EDU-004-video.md      # Streaming de video
│   ├── ET-EDU-005-quizzes.md    # Motor de quizzes
│   └── ET-EDU-006-gamification.md # Sistema de gamificación
├── historias-usuario/           # User Stories
│   ├── US-EDU-001-ver-catalogo.md
│   ├── US-EDU-002-ver-curso.md
│   ├── US-EDU-003-iniciar-leccion.md
│   ├── US-EDU-004-ver-video.md
│   ├── US-EDU-005-completar-leccion.md
│   ├── US-EDU-006-realizar-quiz.md
│   ├── US-EDU-007-ver-progreso.md
│   ├── US-EDU-008-obtener-certificado.md
│   ├── US-EDU-009-buscar-cursos.md
│   ├── US-EDU-010-filtrar-categoria.md
│   ├── US-EDU-011-marcar-favorito.md
│   ├── US-EDU-012-dejar-review.md
│   ├── US-EDU-013-ver-xp.md
│   ├── US-EDU-014-desbloquear-badge.md
│   └── US-EDU-015-continuar-donde-deje.md
└── implementacion/              # Trazabilidad de implementación
    └── TRACEABILITY.yml

Requerimientos Funcionales

ID Nombre Prioridad SP Estado
RF-EDU-001 Catálogo de Cursos P0 8 Implementado
RF-EDU-002 Sistema de Lecciones P0 8 Pendiente
RF-EDU-003 Tracking de Progreso P0 8 Pendiente
RF-EDU-004 Sistema de Quizzes P1 8 Pendiente
RF-EDU-005 Certificaciones P2 5 Pendiente
RF-EDU-006 Gamificación P2 8 Pendiente

Total: 45 SP


Especificaciones Técnicas

ID Nombre Componente Estado
ET-EDU-001 Database Database Schema existe
ET-EDU-002 API REST Backend Parcial
ET-EDU-003 Frontend Frontend Parcial
ET-EDU-004 Video Streaming Backend Pendiente
ET-EDU-005 Quiz Engine Backend Pendiente
ET-EDU-006 Gamification Backend/Frontend Pendiente

Historias de Usuario

ID Historia Prioridad SP Estado
US-EDU-001 Ver catálogo de cursos P0 3 Implementado
US-EDU-002 Ver detalle de curso P0 3 Implementado
US-EDU-003 Iniciar una lección P0 3 Pendiente
US-EDU-004 Ver video de lección P0 3 Pendiente
US-EDU-005 Completar lección P0 3 Pendiente
US-EDU-006 Realizar quiz P1 5 Pendiente
US-EDU-007 Ver mi progreso P0 3 Pendiente
US-EDU-008 Obtener certificado P2 3 Pendiente
US-EDU-009 Buscar cursos P1 2 Pendiente
US-EDU-010 Filtrar por categoría P1 2 Pendiente
US-EDU-011 Marcar favorito P2 2 Pendiente
US-EDU-012 Dejar review P2 3 Pendiente
US-EDU-013 Ver XP acumulado P2 2 Pendiente
US-EDU-014 Desbloquear badge P2 3 Pendiente
US-EDU-015 Continuar donde dejé P1 3 Pendiente

Total: 45 SP


Dependencias

Depende de:

  • OQI-001: Autenticación (usuarios, JWT) - Completado
  • OQI-005: Pagos (compra de cursos premium) - Pendiente

Bloquea:

  • Ninguna

Stack Técnico

Capa Tecnología Uso
Frontend React + Zustand UI y estado
Backend Express.js API REST
Database PostgreSQL Persistencia
Video Cloudflare Stream / S3 Hosting de videos
CDN Cloudflare Assets estáticos

Entidades Principales

Category

  • Categorías de cursos (Trading Básico, Análisis Técnico, etc.)

Course

  • Curso con metadata, precio, nivel de dificultad

Module

  • Agrupación de lecciones dentro de un curso

Lesson

  • Contenido individual (video, artículo, quiz)

Enrollment

  • Inscripción de usuario en curso

Progress

  • Progreso del usuario por lección

Niveles de Dificultad

Nivel Label Color Cursos típicos
beginner Principiante Verde Introducción al trading
intermediate Intermedio Azul Análisis técnico
advanced Avanzado Naranja Estrategias avanzadas
expert Experto Rojo Trading algorítmico

Gamificación (Fase 2)

Sistema de XP

  • Completar lección: +10 XP
  • Aprobar quiz: +25 XP
  • Completar curso: +100 XP
  • Streak diario: +5 XP

Badges

  • 🎓 "Primer Paso" - Completa tu primera lección
  • 📚 "Estudiante Dedicado" - Completa 10 lecciones
  • 🏆 "Graduado" - Completa tu primer curso
  • 🔥 "En Racha" - 7 días seguidos de estudio
  • 💯 "Perfeccionista" - 100% en un quiz

Criterios de Aceptación

Funcionales

  • Catálogo muestra cursos con filtros y búsqueda
  • Usuarios pueden inscribirse en cursos
  • Videos reproducen correctamente
  • Progreso se guarda automáticamente
  • Quizzes validan respuestas correctamente
  • Certificados se generan al completar curso

No Funcionales

  • Videos cargan en < 3 segundos
  • Catálogo carga en < 1 segundo
  • Responsive en mobile
  • Accesible (WCAG 2.1 AA)

Técnicos

  • Cobertura de tests > 70%
  • Documentación API completa
  • SEO optimizado para cursos públicos

Hitos

Hito Entregables Target
M1 Catálogo + detalle curso Sprint 3
M2 Lecciones + videos Sprint 3
M3 Progreso + quizzes Sprint 4
M4 Gamificación + certificados Sprint 4

Reutilización de GAMILIT

Esta épica reutiliza ~70% de la arquitectura del proyecto GAMILIT:

  • Estructura de cursos y lecciones
  • Sistema de progreso
  • Motor de quizzes
  • Sistema de gamificación (XP, badges)

Referencias