Exámenes tipo test

Generador de cuestionarios con resultados en tiempo real

Una aplicación web para generar y evaluar cuestionarios de forma interactiva, ideal para opositores o estudiantes que deseen practicar y visualizar sus resultados en tiempo real. Los usuarios pueden responder preguntas organizadas en bloques, obtener su puntuación, ver los errores cometidos y las respuestas correctas.

Características:

• Generación de cuestionarios dinámicos a partir de un archivo CSV.
• Organización de preguntas por bloques temáticos.
• Visualización de resultados en tiempo real en un menú lateral en la misma página del cuestionario.
• Cálculo de tiempo total tomado para responder.
• Las respuestas se calculan en base 10.
• Identificación de preguntas falladas con sus respuestas correctas.
• Diseño responsivo e interactivo utilizando Bootstrap 5.
• Cada respuesta incorrecta descuenta 0.25 puntos del cómputo global.

Requisitos

• Python 3.10+ pip o conda para la instalación de dependencias.
• Funciona en cualquier sistema operativo.
• Un archivo preguntas.csv que contenga las preguntas del cuestionario con el formato adecuado, mirar más abajo.

Dependencias

Las siguientes dependencias se gestionan mediante pip:

• fastapi: Framework web para el backend.
• uvicorn: Servidor ASGI para ejecutar la aplicación.
• jinja2: Motor de plantillas para renderizar las páginas HTML.
• pandas: Manejo y procesamiento de datos desde el archivo CSV.

Para instalar estas dependencias, usa:

pip install -r requirements.txt

Instalación y configuración

Clonar el repositorio

git clone https://github.com/rnlagos/examenes.git

cd examenes

Crear un entorno virtual Si usas pip:

python -m venv env

source env/bin/activate # En Windows: env\Scripts\activate

Si usas conda:

conda create -n cuestionarios python=3.10

conda activate cuestionarios

Instalar las dependencias

pip install -r requirements.txt

Agregar un archivo 'preguntas.csv'. Asegúrate de que el archivo preguntas.csv tenga el siguiente formato:

Bloque,Pregunta,A,B,C,D,Correcta

1, "¿Cuál es la capital de Francia?", "París", "Londres", "Berlín", "Madrid", "A"

Ejecutar la aplicación

uvicorn app.main:app --reload

Abrir la aplicación en el navegador: http://127.0.0.1:8000.

Uso

• Selecciona los bloques y el número de preguntas que deseas responder.
• Responde las preguntas del cuestionario.
• Observa tus resultados en tiempo real,

Incluye

• Puntuación total en base 10.
• Tiempo total tomado.
• Preguntas falladas y respuestas correctas.

Personalización

• Cambiar el diseño: Edita las plantillas HTML en app/templates.
• Agregar más preguntas: Añade más entradas al archivo preguntas.csv.
• Modificar reglas de puntuación: Edita la lógica en el endpoint /evaluar en main.py.