workspace/projects/gamilit/orchestration/reportes/VALIDACION-TEACHER-MONITORING-2025-12-18.md

VALIDACION: Plan de Correccion Teacher Monitoring

Fecha: 2025-12-18 Referencia: PLAN-CORRECCION-TEACHER-MONITORING-2025-12-18.md Proyecto: Gamilit Fase: 4 - Validacion de Plan vs Analisis

---

RESULTADO DE VALIDACION

Estado: APROBADO CON AJUSTES

---

HALLAZGOS CRITICOS

HALLAZGO 1: UserStats ya contiene todos los campos necesarios

La entidad UserStats (gamification_system.user_stats) YA tiene todos los campos que necesitamos:

Campo Requerido	Campo en UserStats	Estado
total_ml_coins	ml_coins (linea 111)	DISPONIBLE
current_rank	current_rank (linea 95)	DISPONIBLE (MayaRank ENUM)
achievements_count	achievements_earned (linea 206)	DISPONIBLE
exercises_completed	exercises_completed (linea 173)	DISPONIBLE
time_spent_minutes	total_time_spent (linea 223)	DISPONIBLE (interval)

Impacto: NO necesitamos queries adicionales a user_ranks, user_achievements, etc. Simplifica enormemente la implementacion.

HALLAZGO 2: TeacherClassroomsCrudService NO tiene acceso a UserStats

Archivo: apps/backend/src/modules/teacher/services/teacher-classrooms-crud.service.ts

El servicio principal que necesita los datos de gamificacion NO tiene el repositorio de UserStats inyectado.

Servicios que SI tienen UserStats:

• bonus-coins.service.ts:32 - SI
• student-progress.service.ts:102 - SI
• analytics.service.ts:61 - SI

Servicio que NO tiene UserStats:

• teacher-classrooms-crud.service.ts - NO

Solucion: Agregar @InjectRepository(UserStats, 'gamification') al constructor de TeacherClassroomsCrudService.

HALLAZGO 3: Module teacher.module.ts ya importa UserStats

Archivo: apps/backend/src/modules/teacher/teacher.module.ts:143

TypeOrmModule.forFeature([UserStats, Achievement, UserAchievement], 'gamification'),

El modulo YA tiene la entidad registrada. Solo falta inyectarla en el servicio especifico.

---

AJUSTES AL PLAN DE IMPLEMENTACION

SIMPLIFICACION PROPUESTA

En lugar de crear 4+ funciones nuevas como se propuso en el plan original:

ANTES (Plan Original):

• getStudentsCurrentActivity() - Query a exercise_submissions
• getStudentsGamificationData() - Query a user_stats + user_ranks + user_achievements
• getStudentsExerciseStats() - Query a exercise_submissions

DESPUES (Simplificado):

• Solo agregar getStudentsGamificationFromUserStats() - Un solo query a user_stats

DATOS QUE OBTENEMOS DE UserStats

interface UserStatsData {
  user_id: string;
  ml_coins: number;                  // -> total_ml_coins
  current_rank: MayaRank;            // -> current_rank
  achievements_earned: number;       // -> achievements_count
  exercises_completed: number;       // -> exercises_completed
  total_time_spent: string;          // -> time_spent_minutes (convertir interval a minutos)
  last_activity_at: Date;            // -> last_activity (fecha real)
  modules_completed: number;         // bonus: modulos completados
  average_score: number;             // bonus: promedio ya calculado
}

---

DEPENDENCIAS VERIFICADAS

Entidades en teacher.module.ts

Entidad	Datasource	Importada	Estado
UserStats	gamification	SI (linea 143)	OK
Achievement	gamification	SI (linea 143)	OK
UserAchievement	gamification	SI (linea 143)	OK
ModuleProgress	progress	SI (linea 135)	OK
ExerciseSubmission	progress	SI (linea 135)	OK
Profile	auth	SI (linea 128)	OK
User	auth	SI (linea 128)	OK
ClassroomMember	social	SI (linea 131)	OK

Repositorios en TeacherClassroomsCrudService

Repositorio	Inyectado	Requerido	Accion
ClassroomMember	SI	SI	OK
Profile	SI	SI	OK
User	SI	SI	OK
ModuleProgress	SI	SI	OK
ExerciseSubmission	SI	SI	OK
UserStats	NO	SI	AGREGAR

---

CAMPOS FALTANTES: current_module y current_exercise

Estos campos NO estan en UserStats. Opciones:

Opcion A: Query adicional a module_progress (RECOMENDADA)

SELECT
  mp.user_id,
  m.title as current_module,
  mp.last_accessed_at
FROM progress_tracking.module_progress mp
JOIN educational_content.modules m ON m.id = mp.module_id
WHERE mp.user_id IN (...)
  AND mp.status = 'in_progress'
ORDER BY mp.last_accessed_at DESC
LIMIT 1 per user

Opcion B: Query adicional a exercise_submissions

SELECT DISTINCT ON (es.user_id)
  es.user_id,
  e.title as current_exercise,
  m.title as current_module
FROM progress_tracking.exercise_submissions es
JOIN educational_content.exercises e ON e.id = es.exercise_id
JOIN educational_content.modules m ON m.id = e.module_id
WHERE es.user_id IN (...)
ORDER BY es.user_id, es.submitted_at DESC

Recomendacion: Usar Opcion B porque da tanto current_module como current_exercise en un solo query.

---

PLAN DE IMPLEMENTACION AJUSTADO

Paso 1: Aumentar limite (P0) - SIN CAMBIOS

• Archivo: teacher-classrooms-crud.service.ts
• Cambio: limit = 20 -> limit = 100

Paso 2: Agregar repositorio UserStats (P0) - NUEVO

• Archivo: teacher-classrooms-crud.service.ts
• Agregar en constructor:

@InjectRepository(UserStats, 'gamification')
private readonly userStatsRepo: Repository<UserStats>,

Paso 3: Crear funcion getStudentsUserStats (P1) - SIMPLIFICADO

• Una sola funcion que obtiene datos de gamificacion de UserStats

Paso 4: Crear funcion getStudentsCurrentActivity (P1) - SIN CAMBIOS

• Query a exercise_submissions para current_module/current_exercise

Paso 5: Modificar getClassroomStudents (P1) - AJUSTADO

• Agregar llamada a las dos nuevas funciones
• Combinar en Promise.all

Paso 6: Modificar mapToStudentInClassroomDto (P1) - AJUSTADO

• Agregar nuevos campos con datos de UserStats

Paso 7: Frontend - Ajustar hooks (P2) - SIN CAMBIOS

• Agregar limit: 100 al query

---

CHECKLIST FINAL

Pre-implementacion

• Verificar entidades disponibles
• Verificar modulo imports
• Identificar repositorios faltantes
• Simplificar queries donde sea posible

Implementacion

• Agregar @InjectRepository(UserStats) al servicio
• Implementar getStudentsUserStats()
• Implementar getStudentsCurrentActivity()
• Modificar getClassroomStudents() para usar nuevas funciones
• Modificar mapToStudentInClassroomDto()
• Actualizar limite de paginacion
• Actualizar hooks del frontend

Post-implementacion

• Verificar compilation sin errores
• Verificar que se muestran 44+ estudiantes
• Verificar datos de gamificacion correctos
• Verificar current_module/current_exercise

---

ESTIMACION AJUSTADA

Tarea	Tiempo Original	Tiempo Ajustado
P0 - Paginacion	30 min	30 min
P1 - Datos gamificacion	2-3 horas	1-1.5 horas
P2 - Frontend	30 min	30 min
Total	3-4 horas	2-2.5 horas

---

Siguiente Fase: Ejecucion de Implementaciones/Correcciones