Casos de uso — Docentes
Control de asistencia
- Asistencia → elegir paralelo (la fecha de hoy viene preseleccionada).
- Todos aparecen P (presente); se marcan solo las novedades: A atraso, FJ justificada, FI injustificada → Guardar.
- Las faltas disparan la alerta automática a la familia (cola transaccional: no se pierde aunque el servidor se reinicie).

| Intento | Respuesta del sistema |
|---|---|
| Tomar asistencia de un paralelo ajeno | El selector solo ofrece paralelos con matrícula; el registro exige rol con permiso |
| Registrar dos veces el mismo día | Se actualiza la hoja existente (sin duplicados) y el cambio queda auditado |
Registro de calificaciones
- Calificaciones → paralelo, materia y parcial (solo los asignados al docente).
- La nota del parcial se compone de actividades ponderadas: el docente crea actividades (Lección 1, Taller grupal 2, Examen…) asignándolas a una categoría del esquema del colegio (p. ej. Lecciones 20%, Tareas 20%, Talleres 30%, Examen 30% — configurable en Configuración → Evaluación).
- Al registrar las notas de cada actividad, el sistema calcula automáticamente la nota oficial del parcial: promedio de cada categoría × su peso (las categorías aún sin actividades se renormalizan).
- También puede digitarse la nota directa (0–10) si el colegio no usa actividades en esa materia, o traerla de Moodle para revisar y volcar.
- Guardar notas — cada recálculo queda auditado.

| Intento | Respuesta del sistema |
|---|---|
| Nota mayor a 10 o negativa | 400 — Datos inválidos (evidencia) |
| Calificar una materia/paralelo no asignado | 403 — No tiene asignada esta materia/paralelo |
| Editar una nota de un parcial cerrado | Grilla bloqueada y 409 en la API: solo queda la rectificación |
| Traer de Moodle sin conexión configurada | 409 — Moodle no está configurado con indicación de dónde configurarlo |

Planificación de clases y avance de unidad
Diseño: el aula virtual es Moodle
La planificación didáctica, las unidades y su avance viven en el curso Moodle de cada materia — el sistema crea el curso y matricula a los alumnos automáticamente al asignar al docente. Este sistema es el núcleo oficial (asistencia, notas, actas) y mantiene a Moodle sincronizado; las notas de actividades se traen con Traer de Moodle.
Observaciones y seguimiento individual
Ficha del alumno → Observaciones: texto, categoría y visibilidad (interna al personal, o visible al representante). Las citaciones a representantes con sus acuerdos se registran en el mismo módulo.

| Intento | Respuesta del sistema |
|---|---|
| Un docente intenta crear una observación "solo DECE" | Se degrada automáticamente a interna: la visibilidad DECE es exclusiva del DECE |
| Un docente intenta leer las observaciones DECE | No aparecen — ni en la UI ni en la API (evidencia) |
| Cualquier lectura de observaciones | Queda auditada (LOPDP) |
Carga de tareas y materiales
Las tareas viven en Moodle (curso ya aprovisionado). Para circulares o material puntual a las familias: comunicados con adjuntos (hasta 5 archivos, alcance por colegio/grado/paralelo).
Reportes académicos
- Boleta PDF por alumno, desde su ficha; al cerrar el parcial se generan todas automáticamente en segundo plano (cola con reintentos).
- Exportación Excel del listado de alumnos y del estado de cuenta.