Documentación del Sistema
Documentación del Sistema de Quiz
Formato del archivo JSON
El sistema de quiz permite importar preguntas desde un archivo JSON. El archivo debe tener la siguiente estructura:
{
"questions": [
{
"question": "¿Cuál es la capital de Francia?",
"options": ["Madrid", "Berlín", "París", "Roma"],
"correct_answers": [2], // Índices de las respuestas correctas (empieza en 0)
"type": "single" // 'single' para respuesta única, 'multiple' para respuestas múltiples
},
{
"question": "Selecciona los colores primarios.",
"options": ["Rojo", "Amarillo", "Verde", "Azul"],
"correct_answers": [0, 1, 3], // Respuestas correctas en índices
"type": "multiple" // Tipo de pregunta
}
]
}Descripción de los campos
- question: El texto de la pregunta.
- options: Array con las opciones de respuesta.
- correct_answers: Array con los índices de las respuestas correctas (comenzando desde 0).
- type: Tipo de pregunta, puede ser "single" (respuesta única) o "multiple" (respuestas múltiples).
Nota sobre el tiempo
A diferencia de versiones anteriores, el tiempo límite para responder las preguntas ya no se especifica en el archivo JSON. Ahora, después de cargar el archivo, el usuario puede configurar un tiempo límite global que se aplicará a todas las preguntas.
Tipos de preguntas
El sistema soporta dos tipos de preguntas:
- Respuesta única (single): Solo una opción es correcta. El usuario debe seleccionar una única respuesta.
- Respuestas múltiples (multiple): Varias opciones pueden ser correctas. El usuario debe seleccionar todas las opciones correctas para que la respuesta se considere correcta.
Funcionamiento del sistema
- Importar un archivo JSON con las preguntas o usar los datos de ejemplo.
- Configurar el tiempo límite para responder cada pregunta.
- Iniciar el quiz haciendo clic en "Comenzar Quiz".
- Responder cada pregunta y navegar entre ellas usando los botones "Siguiente" y "Atrás".
- Al llegar a la última pregunta, hacer clic en "Finalizar Quiz" y confirmar.
- Revisar el resumen con los resultados.
- Opcionalmente, reiniciar el mismo quiz o probar con otro cuestionario.
Resultados
Al finalizar el quiz, el sistema muestra un resumen detallado con:
- Puntuación total (porcentaje de respuestas correctas)
- Número de respuestas correctas e incorrectas
- Tiempo total utilizado
- Tiempo promedio por pregunta
- Revisión detallada de cada pregunta, mostrando las respuestas correctas e incorrectas
Integración
Este sistema de quiz puede integrarse fácilmente en cualquier aplicación web. Solo necesitas:
- Importar los componentes necesarios
- Preparar un archivo JSON con las preguntas siguiendo el formato especificado
- Renderizar el componente QuizSystem en tu aplicación