App de Docentes
Objetivo
Section titled “Objetivo”Permitir a los docentes gestionar sus materias asignadas: evaluar, cargar asistencias (manual o por QR), consultar delineamientos y exportar planillas.
/profesores
Descripción General
Section titled “Descripción General”La app de docentes es un proyecto externo desarrollado en React, alojado en un repositorio separado al principal. Se compila dentro de la carpeta public del proyecto principal y consume la misma API central del sistema (MAIUS). Comparte el mismo dominio que la app principal: un usuario con rol de docente que intente acceder desde la app principal es redirigido automáticamente a /profesores.
Funcionalidades
Section titled “Funcionalidades”Dashboard
Section titled “Dashboard”Ruta: /profesores#/menu/docente
Vista principal de la app. Muestra todas las materias asignadas al docente, cada una en una tarjeta con: nombre de la materia, año, acta, curso y carrera.
Botones disponibles por materia:
| Botón | Descripción |
|---|---|
| Evaluar | Accede a la vista de carga de evaluaciones |
| Cargar asistencias | Accede a la vista de asistencias |
| Delineamientos | Accede a la vista de evaluaciones de la materia |
| Exportar planilla | Exporta la planilla de la materia en PDF |
Cuenta con un buscador que filtra las materias por nombre, acta o carrera mediante texto simple, activado al presionar Enter.
Asistencias
Section titled “Asistencias”Permite registrar las asistencias de los estudiantes. Es fundamental que el docente mantenga este registro actualizado, ya que determina si un estudiante está habilitado o no para rendir el examen de primera oportunidad.
Información visible:
- Nombre, acta y año de la materia.
- Clases totales: Botón que muestra la cantidad de clases en las que se llamó asistencia. Al hacer clic abre un formulario modal con el historial de días de clase en orden ascendente, donde cada fecha tiene un botón Editar que permite recuperar y modificar las asistencias de ese día.
Campo de fecha: Ubicado junto al contador de clases. Puede modificarse manualmente a una fecha anterior sin pasar por el formulario de días de clase. Al cargar la vista, el sistema verifica si ya existen asistencias para la fecha establecida: si las hay, las recupera; si no, habilita la carga de nuevas asistencias.
Tabla de asistencias: Se activa haciendo clic en “Comenzar a cargar”. Muestra por estudiante:
| Columna | Descripción |
|---|---|
| Apellidos y nombres | Datos del estudiante |
| Porcentaje de asistencia | Porcentaje actual acumulado |
| Ausencias | Cantidad de ausencias registradas |
| Presencias | Cantidad de presencias registradas |
| Estado actual | - si no se ha cargado aún / Checkbox “Presente” o “Ausente” durante la carga |
El formulario incluye un check para marcar todos como presentes o ausentes de forma masiva, con opción de editar estudiante por estudiante.
Guardado automático: Cada 60 segundos. Si se hace clic sobre el contador de segundos, guarda de inmediato. Si el guardado automático está activo o en proceso y el usuario intenta cerrar o recargar la página, se lanza una alerta de confirmación para evitar pérdida de datos.
Interceptor de red: Si se detecta pérdida de conexión antes de guardar, el sistema reintenta el envío cada 5 segundos hasta recuperar la conexión, notificando al usuario que verifique su conexión mientras tanto.
Asistencias por QR
Section titled “Asistencias por QR”Disponible desde un botón “Generar QR” dentro de la vista de asistencias. Al activarlo, reemplaza la tabla de carga manual por un código QR generado a partir de un token temporal.
Funcionamiento:
- El QR es escaneado por los estudiantes desde la aplicación de estudiantes, quienes marcan su propia asistencia directamente.
- El QR se regenera cada 15 segundos junto con el token, para evitar que un estudiante reenvíe el QR a alguien que no esté presente.
- Al generar el QR por primera vez, el sistema marca a todos los estudiantes como ausentes para registrar el día de clase. A partir de ahí, cada escaneo marca al estudiante como presente.
- Solo pueden escanear el QR los estudiantes que estén inscriptos en la materia.
Validaciones:
| Validación | Descripción |
|---|---|
| Días de clase | El QR solo puede generarse en días que coincidan con la fecha actual según el horario de la materia. No es posible generarlo para clases anteriores ni con fecha modificada manualmente |
| Campo de fecha | Se limita a los días asignados en el horario de la materia. Si hoy no es un día de clase, el campo se ajusta automáticamente al día de clase con horario más cercano, mostrando una advertencia al docente para que verifique o consulte con secretaría si el horario difiere del establecido |
Reglas de Negocio
Section titled “Reglas de Negocio”Habilitación para Examen de Primera Oportunidad
Section titled “Habilitación para Examen de Primera Oportunidad”El registro de asistencias determina si un estudiante está habilitado para rendir el examen de primera oportunidad (según el porcentaje de asistencia requerido definido en la materia).
Redirección Automática de Docentes
Section titled “Redirección Automática de Docentes”Un usuario con rol de docente que intente acceder desde la app principal es redirigido automáticamente a /profesores, ya que comparte el mismo dominio.
Restricción de Escaneo QR
Section titled “Restricción de Escaneo QR”Solo los estudiantes inscriptos en la materia pueden escanear el QR de asistencia.
Regeneración del QR
Section titled “Regeneración del QR”El QR y su token se regeneran cada 15 segundos para evitar que un estudiante reenvíe el código a alguien que no esté presente físicamente.
Información Pendiente de Relevamiento
Section titled “Información Pendiente de Relevamiento”El docu.md menciona los siguientes ítems relacionados a la app de docentes sin detalle funcional disponible:
- Delineamientos (inicio, delineamientos por materia, asistencias, carga de puntajes)
- Estudiantes
- Profesores
- Seguimiento académico
- Informes académicos (informes de calificaciones, constancias, lista de habilitados, control de planillas, control de carga de puntajes, convalidaciones, servicios educativos, planilla de calificaciones)
- App de estudiantes (cursos, materias)
- Módulo de retención/preguntas
Última revisión: 9 de julio de 2026