📚 Guía de Usuario & Manual Técnico

Documentación Oficial de EvaGrade Desktop

Aprende a conectar tu Moodle, configurar el motor de inteligencia artificial (gratuito o local), definir rúbricas pedagógicas y automatizar tus correcciones por lotes con 100% de privacidad.

📖 1. Introducción a EvaGrade Desktop

EvaGrade Desktop es una aplicación nativa diseñada para docentes de colegios, institutos, formación profesional y universidades. Su propósito es automatizar la lectura y corrección por lotes de tareas de Moodle mediante rúbricas pedagógicas e Inteligencia Artificial, reduciendo el tiempo de calificación en más de un 90% y garantizando el cumplimiento estricto del RGPD europeo.

Requisitos del Sistema y Hardware

  • Sistemas Operativos: Windows 10 / 11 (64 bits) o distribuciones Linux modernas (Ubuntu 20.04+, Debian 11+, Fedora, Arch Linux).
  • Requisitos de la App (Modo Cloud o Servidor Propio): Muy ligeros: cualquier ordenador docente con 4 GB de RAM y procesador estándar.
  • Requisitos para IA Local (Ollama Offline en tu propio PC):
    • Mínimo: 16 GB de memoria RAM y procesador de 4+ núcleos (para modelos locales ligeros).
    • Aconsejable / Recomendado: 32 GB de memoria RAM o tarjeta gráfica dedicada (GPU) con 8 GB+ VRAM (para modelos locales de alta capacidad y máxima precisión pedagógica).
  • Conexión a Internet: Solo requerida para sincronizar con Moodle y en Modo Cloud. Con Ollama Local, la corrección funciona 100% sin conexión.

💻 2. Instalación Paso a Paso

🪟 Instalación en Windows

1

Descarga el instalador oficial

Descarga el archivo EvaGrade_Setup.exe desde la web oficial de EvaGrade.

2

Ejecuta el Asistente

Haz doble clic en el archivo descargado. Si Windows SmartScreen muestra un aviso preventivo, pulsa en "Más información" y selecciona "Ejecutar de todas formas".

3

Listo para Evaluar

Se creará automáticamente un acceso directo en tu escritorio y menú de inicio.

🐧 Instalación en Linux (.AppImage)

1

Descarga el archivo AppImage

Descarga EvaGrade-x86_64.AppImage.

2

Otorga Permisos de Ejecución

Haz clic derecho en el archivo ➔ Propiedades ➔ Permisos ➔ Permitir ejecutar como programa o ejecuta en terminal:

chmod +x EvaGrade-x86_64.AppImage
3

Ejecución

Haz doble clic sobre el archivo o lánzalo desde terminal: ./EvaGrade-x86_64.AppImage.

🎁 3. Activación de la Prueba Gratuita (15 Días PRO)

Al abrir EvaGrade por primera vez, se te otorgarán 15 días de prueba con todas las funciones PRO desbloqueadas (corrección por lotes ilimitada, extractores ZIP/Excel/PDF y todos los modelos de IA).

💡
Sin tarjeta de crédito: No necesitas introducir ningún método de pago ni datos bancarios. Solo tu correo electrónico docente para vincular tu periodo de prueba.

🏫 4. Conexión con tu Servidor Moodle

EvaGrade se conecta de forma nativa a cualquier plataforma Moodle estándar (v3.9 a v4.5+), incluyendo plataformas institucionales, universidades, institutos y centros educativos privados de todo el mundo.

Configurar la Conexión

  1. En EvaGrade, abre la pestaña ⚙️ Configuración ➔ 🏫 Servidores Moodle.
  2. URL del Servidor: Pega la dirección raíz de tu Moodle (por ejemplo: https://moodle.tucentro.edu/ o https://aules.edu.gva.es/).
  3. Método de Autenticación:
    • Credenciales Directas (Usuario y Contraseña): Recomendado para inicio de sesión rápido. Tus contraseñas se almacenan cifradas localmente en tu equipo.
    • Token de Servicios Web (Webservices Token): Si tu centro tiene habilitada la API para docentes (Perfil ➔ Claves de Seguridad).
  4. Pulsa el botón «Probar Conexión». Al recibir confirmación, tus cursos se cargarán automáticamente.
ℹ️
Soporte Multicentro: Si trabajas en más de un centro educativo a la vez, puedes guardar diferentes perfiles de conexión y alternar entre ellos con un solo clic.

📚 5. Pestaña Cursos y Ajustes por Asignatura

La pestaña Cursos es tu panel principal para organizar las materias y definir preferencias pedagógicas específicas por aula.

Funcionalidades Clave de la Pantalla

  • ⭐ Cursos Favoritos: Haz clic en la estrella de cualquier tarjeta para fijar la asignatura en la parte superior.
  • 🙈 Cursos Ocultos: Archiva materias antiguas o inactivas para mantener la interfaz despejada. Puedes desocultarlas en cualquier momento con el botón "Mostrar Ocultos".
  • ⚙️ Ajustes Individuales por Materia (Icono Engranaje):
    • Idioma de Corrección: Fija el idioma preferido para ese curso (ej. 🏛️ Valencià para asignaturas en lengua autonómica, 🇬🇧 English para clases bilingües o 🇪🇸 Castellano).
    • Nivel de Rigor Docente: Establece si esa materia se evalúa en modo Comprensivo (K-8/ESO), Estándar (Bachillerato) o Exigente (FP/Universidad).
  • Contador de Pendientes: Cada tarjeta muestra el número de tareas activas y las entregas pendientes de calificación. Haz clic en cualquier tarjeta para abrir sus tareas.

📥 6. Pestaña Tareas & Entregas

Espacio de trabajo para consultar el enunciado de la actividad, filtrar las entregas del alumnado y lanzar la evaluación asistida.

Componentes de la Pantalla

  1. Cabecera del Enunciado: Muestra el título, fecha límite de entrega, descripción completa y archivos adjuntos del docente.
  2. Filtros Rápidos de Alumnos:
    • Pendientes de calificar: Alumnos que han entregado y no tienen nota asignada.
    • Calificados: Alumnos evaluados con nota y feedback visible.
    • Todos: Vista global del aula con buscador interactivo por nombre.
  3. Botón «🚀 Encolar Entregas Pendientes»: Lanza la corrección masiva en paralelo para todo el grupo en segundo plano.

🔍 7. Inspector Multiformato: Hojas de Cálculo con Fórmulas y ZIPs

EvaGrade incorpora extractores especializados para inspeccionar cualquier formato sin requerir que abras LibreOffice, Excel o descompresores externos:

📊 Hojas de Cálculo (Excel XLSX y LibreOffice ODS)

A diferencia de otras IAs que solo leen texto plano, EvaGrade analiza la estructura de celdas y las fórmulas matemáticas aplicadas (ej: =SUMA(B2:B10), =BUSCARV, condicionales). Esto permite a la IA verificar si el estudiante aplicó las fórmulas solicitadas o si introdujo los valores a mano.

📁 Archivos Comprimidos (ZIP y TAR.GZ)

Descompresión recursiva segura con explorador de árbol de carpetas y visor de código fuente integrado (Python, Java, C++, HTML/CSS, JS, SQL).

📝 Documentos Word (DOCX), PDFs y Texto en Línea

Extracción limpia de texto enriquecido, tablas y respuestas redactadas en el editor web de Moodle.

📐 8. Las 3 Estrategias Pedagógicas de Evaluación

En la pestaña de estrategia puedes alternar libremente entre tres metodologías según el tipo de actividad:

1

Rúbrica Analítica Estricta

Desglose por criterios con porcentajes ponderados (ej: Presentación 20%, Contenido 50%, Ortografía 30%). La IA puntúa cada criterio de 0 a 10 y calcula la media ponderada automáticamente.

2

Orientación Pedagógica / Instrucciones Libres

Escribe directrices en lenguaje natural para la IA (ej: "Valorar la originalidad del proyecto y penalizar con -1 punto si no incluye conclusiones personales").

3

Modo Directo

La IA evalúa con criterio general basándose exclusivamente en el enunciado de la tarea de Moodle.

🪄 9. Asistente Inteligente de Creación de Rúbricas

Si no dispones de una rúbrica prediseñada, pulsa el botón «🪄 Generar Rúbrica con IA».

  1. El asistente lee el enunciado y los objetivos de la tarea de Moodle.
  2. Genera en 5 segundos una propuesta de 3 a 5 criterios pedagógicos con sus niveles de logro y pesos porcentuales equilibrados.
  3. Puedes editar, añadir nuevos criterios o ajustar los porcentajes antes de iniciar la corrección.

🎯 10. Niveles de Rigor, Puntos Extra y Penalizaciones

Selector de Rigor Pedagógico

  • 🟢 Comprensivo (Primaria / ESO / K-8): Tono empático y motivador. Destaca los aciertos del alumno y ofrece consejos paso a paso.
  • 🔵 Estándar (Bachillerato / GCSE / Ciclos Medios): Evaluación equilibrada y formativa.
  • 🔴 Exigente (Universidad / Ciclos Superiores): Máximo rigor técnico y metodológico.

Bonificaciones y Penalizaciones

Puedes configurar bonificaciones por excelencia (+1 pto por creatividad o limpieza) y penalizaciones automáticas (-0.5 ptos por entrega tardía o faltas ortográficas).

Modo de Corrección Exhaustiva

Al activarlo en Configuración ➔ Estrategia, la IA analiza cada criterio de la rúbrica de forma aislada e independiente con un razonamiento profundo antes de consolidar la nota.

🎯 11. Pestaña «Validar Borradores» y Volcado a Moodle

Tú siempre tienes el control final de la nota:

  • Todas las correcciones de la IA se guardan inicialmente como Borrador local.
  • La pantalla muestra la lista de alumnos con su nota propuesta y un resumen del feedback.
  • Edición Rápida: Puedes hacer clic en cualquier alumno para ajustar la nota numérica o reescribir el comentario de retroalimentación.
  • Publicación en 1 Clic: Pulsa «🚀 Enviar Todo a Moodle» para sincronizar todas las notas aprobadas en el libro de calificaciones oficial de tu centro.

🕰️ 12. Comparador Histórico de Moodle

En la vista detallada de validación, EvaGrade muestra una tarjeta comparativa con la nota y comentarios previos que el alumno tenía en Moodle.

💡
Ideal para Reentregas: Permite comprobar al instante si el estudiante corrigió los errores de una entrega anterior y evaluar su progreso con total transparencia.

📊 13. Monitor de Rendimiento y Cola en Vivo

La pestaña Monitor te permite supervisar la actividad en segundo plano:

  • Kanban de Estados: Consulta cuántas entregas están En cola, Evaluando, Completadas o Fallidas.
  • Controles de Reproducción: Pausa o reanuda la cola en cualquier momento si necesitas cerrar el ordenador.
  • Terminal de Logs: Visualiza en directo los pasos que ejecuta la IA (extracción de ficheros, análisis de fórmulas y redacción de feedback).

🧠 14. Configuración de Modelos de IA (Ollama vs Cloud)

🏠 Modo 1: IA Local (Ollama Offline - 100% Privado)

Ejecuta modelos abiertos directamente en tu PC sin conexión a Internet. Incluye descarga en 1 clic y un control deslizante de RAM para ajustar el consumo de memoria de forma segura.

☁️ Modo 2: APIs Cloud (OpenRouter Hub / Servidor Propio)

  • OpenRouter Hub: Accede a +300 modelos (Gemini 2.5 Flash, DeepSeek R1/V3, Claude 3.5, GPT-4o o modelos 100% gratuitos `:free`) con una sola API key y presets automáticos.
  • Servidor Propio: Conecta a servidores vLLM o LM Studio de tu centro educativo.
  • Auto-Failover: Conmuta automáticamente al proveedor secundario en caso de saturación o error 429.
⚡
Probar y Activar: Pulsa siempre el botón «Probar y Activar Motor de IA» para verificar la conexión antes de evaluar.

🛡️ 15. Anonimización en el Cliente y Privacidad RGPD

EvaGrade garantiza el cumplimiento estricto de la normativa de protección de datos de menores (RGPD, FERPA y COPPA):

  • En Modo Local: Cero datos salen de tu equipo.
  • En Modo Cloud: El motor local enmascara y anonimiza nombres, correos e identificadores de los alumnos en tu propio ordenador antes de enviar el contenido a la IA. Al recibir la nota, reasocia en local la calificación al alumno real.

🔑 16. Licencia PRO y Actualizaciones

Introduce tu clave de licencia recibida por email en ⚙️ Configuración ➔ Licencia.

  • Hasta 3 Equipos: Una misma licencia sirve para tu portátil, el aula y tu ordenador de casa.
  • Actualizador en 1 Clic: En Configuración ➔ Acerca de, puedes buscar y descargar nuevas versiones en segundo plano con barra de progreso en vivo.

❓ 17. Preguntas Frecuentes Técnicas

¿Qué ocurre si cambio o formateo mi ordenador?

Puedes desvincular tu licencia desde la pestaña de configuración antes de formatear o volver a introducir tu clave en el nuevo equipo.

¿Es necesario instalar Python en mi sistema?

No. Los paquetes oficiales para Windows (.exe) y Linux (.AppImage) son completamente autónomos e incluyen todos los motores necesarios empaquetados.

¿Dónde puedo solicitar soporte técnico?

Puedes escribirnos a [email protected]. Los usuarios con Licencia PRO cuentan con soporte prioritario en menos de 24 horas laborables.