Guía de uso completa

1 · Preparar el banco de preguntas

Crea un archivo .txt con el siguiente formato:

1. ¿Cuál es la capital de Francia?
* París
- Madrid
- Roma
- Lisboa

2. ¿En qué año llegó el hombre a la Luna?
- 1965
* 1969
- 1972
- 1980

• * marca la alternativa correcta.
• - marca las incorrectas.
• Las alternativas se barajan automáticamente en cada forma.

2 · Generar exámenes

1. Ir a ① Generar exámenes.
2. Cargar el banco de preguntas (.txt).
3. Configurar: título, asignatura, número de formas y preguntas por prueba (máx. 60).
4. Pulsar Generar PDFs y pauta → seleccionar carpeta destino.

Se generan forma_01.pdf, forma_02.pdf, … y el archivo de pauta cifrada pautas_maestras.evl.

Opcionalmente, usa Generar Hoja de Respuestas Vacía para exportar la plantilla OMR en blanco. El nombre institucional y el logo se configuran en ⚙ Ajustes.

3 · Corregir hojas escaneadas

1. Ir a ② Corregir exámenes.
2. Seleccionar la carpeta con los escaneos y el archivo .evl.
3. Cargar la nómina de estudiantes (opcional; columnas requeridas: ID, Nombre).
4. Pulsar Iniciar Corrección Automática.

Se exporta un Excel resultados_YYYYMMDD_HHMMSS.xlsx con los puntajes. Si se cargó nómina, el Excel incluye el nombre de cada estudiante y queda ordenado alfabéticamente.

4 · Calcular notas

1. Ir a 📊 Calificaciones.
2. Cargar el Excel de resultados (se propone el último generado).
3. Configurar la escala: % Exigencia (default 60 %), nota mínima / aprobación / máxima (default 1.0 / 4.0 / 7.0), factor de penalización opcional (ej. 0.25).
4. Pulsar Calcular Notas → revisar el histograma de distribución.
5. Pulsar Exportar Acta Final para guardar el .xlsx con la columna Nota.

5 · Escala de notas

EvaLumina usa una fórmula lineal partida: la pendiente de aprobación y la de reprobación son independientes, lo que permite configurar cualquier umbral de exigencia:

passing_score = total × (passing_pct / 100)

if score < passing_score:
    grade = min_grade + (pass_grade − min_grade) × (score / passing_score)

if score ≥ passing_score:
    grade = pass_grade + (max_grade − pass_grade) × ((score − passing_score) / (total − passing_score))

Con la configuración por defecto (60 % de exigencia, escala 1.0 – 4.0 – 7.0):

6 · Formato de la hoja de respuestas

• Tamaño carta (LETTER).
• Hasta 60 preguntas, 5 alternativas (A–E).
• Bloque de identificación (dígitos 0–9) — soporta RUT chileno e IDs internacionales (3, 6 o 9 dígitos).
• Cuatro fiduciales en las esquinas para calibración de perspectiva.
• Compatible con escaneos a 150 dpi o fotos con iluminación razonable.
• Logo y nombre institucional configurables desde ⚙ Ajustes (sin afectar la lectura OMR).

7 · Activar EvaLumina Pro

Con la compra recibes un código de activación (formato EVL-XXXXX-XXXXX). Activar toma segundos:

1. Abrir EvaLumina y hacer clic en 🔑 Activar Licencia en la barra lateral inferior (visible solo en la versión Free).
2. Pegar el código en el campo de activación y pulsar ⚡ Activar en línea (internet se necesita solo para este paso — la corrección sigue siendo 100 % offline).
3. Listo — la licencia queda activada permanentemente en ese equipo, la barra lateral cambia de "Free" a "Pro" y la barra de título muestra "EvaLumina Pro".

¿Sin internet en ese equipo? Copia el Machine ID que aparece en el mismo diálogo (formato XXXX-XXXX-XXXX-XXXX), envíalo a contact@evalumina.app y recibirás un archivo license.key para cargar con Cargar archivo .key.

8 · Seguridad

• Pauta maestra (.evl) — cifrada con Fernet (AES-128-CBC + HMAC-SHA256). La clave está integrada en el módulo generador y los estudiantes no pueden descifrar la pauta aunque obtengan el archivo.
• Licencias comerciales (license.key) — firmadas con Ed25519 (criptografía asimétrica). La aplicación cliente solo contiene la llave pública y verifica la firma; la llave privada vive exclusivamente en la bóveda 1Password del desarrollador y nunca se distribuye. Esto hace matemáticamente inviable la creación de un keygen.
• Machine ID — derivado vía SHA-256 de MAC + nombre de nodo + plataforma + arquitectura. Cada licencia está vinculada al Machine ID del equipo.