Justificación de las HU - Itz-oji/GRUPO3-2025-PROYINF GitHub Wiki

Se definieron estas nuevas HU:

  • HU9: Marcar como libre ciertas preguntas.
  • HU10: Filtro por etiqueta( práctica con preguntas libres)
  • HU11: Resultado de preguntas por intento
  • HU12: Guardar intento( Histórico personal)
  • HU13: Tabla de intentos( Últimas 10)
  • HU14: Personalización visual de ensayos por color

respecto a este nuevo conjunto de exigencias y contemplando las HU pendientes, establecimos de manera primordial las siguientes HU:

  • HU3: Revisión de ensayo por parte del profesor
  • HU11: Resultado de preguntas del intento
  • HU12: Guardar intento (histórico personal)
  • HU9: Marcar como libre ciertas preguntas
  • HU10: Filtro por etiquetas( prácticas con preguntas libres)

Estas historias de usuario conforman el núcleo funcional y pedagógico del proyecto, pues conectan directamente al profesor, al estudiante y al sistema de evaluación–retroalimentación.

La HU3 establece la base del proceso educativo: permite al profesor revisar los ensayos de sus alumnos, dejar comentarios y ofrecer recursos de apoyo, asegurando una retroalimentación personalizada que impulsa el aprendizaje.

La HU11 complementa este proceso desde la perspectiva del estudiante, brindándole resultados inmediatos sobre sus respuestas, lo que refuerza la comprensión y motiva la mejora continua.

La HU12 da continuidad a esa experiencia al registrar el historial de prácticas con fecha, etiqueta y porcentaje, permitiendo un seguimiento del progreso individual a lo largo del tiempo.

Por su parte, la HU9 proporciona al docente control sobre qué preguntas se habilitan como “libres”, garantizando un equilibrio entre práctica y evaluación formal.

Finalmente, la HU10 potencia la autonomía del estudiante, ya que le permite practicar por temas o etiquetas, personalizando su proceso de aprendizaje según sus necesidades.

En conjunto, estas HU consolidan el propósito esencial del proyecto: crear una plataforma educativa dinámica, transparente y orientada a la mejora constante, donde el aprendizaje y la retroalimentación se integran de forma continua y significativa.

  • HU de mayor prioridad: HU12 - Guardar intento (histórico personal)

Debido a que aporta un valor directo al usuario, permitiéndole ver su progreso.

Es base necesaria para HU13 (tabla de intentos).

Y sobre todo mejora la experiencia personalizada del sistema.

  • Descomposición de la HU12 en tareas

  1. Modificar la base de datos Crear una tabla intentos con campos: id_usuario, fecha, puntaje, preguntas_correctas, preguntas_totales, etc.

  2. Actualizar backend Añadir un endpoint /guardar_intento para almacenar los resultados del quiz.

  3. Conectar frontend Al finalizar el quiz, enviar los datos del intento al backend mediante una petición POST.

  4. Validar y probar Verificar que los intentos se guardan correctamente y que no se duplican.

  5. Registrar en repositorio Documentar los cambios en el issue correspondiente con tiempos y descripción.