Casos de uso — Estudiantes y padres de familia
Cada caso incluye el camino feliz (cómo se hace) y qué puede salir mal (los errores que el sistema controla y cómo responde).
Registro y matrícula de estudiantes
La ejecuta secretaría; la familia recibe las credenciales.
- Alumnos y matrícula → Nuevo alumno: cédula, nombres, fecha de nacimiento → Crear. El sistema muestra la credencial temporal (usuario = cédula) para entregar a la familia.
- Para un curso completo: Plantilla Excel (incluye los grados y paralelos reales del año e instrucciones) → completar una fila por alumno → Importar Excel.
- Hermanos: se repite la cédula del representante en ambas filas y el padre/madre recibe una sola cuenta con acceso a todos sus hijos.

| Intento | Respuesta del sistema |
|---|---|
| Cédula que no tiene 10 dígitos | La fila se rechaza con el motivo exacto |
Fecha de nacimiento inválida (31/02/2013) |
Fila rechazada: formato AAAA-MM-DD |
Grado o paralelo que no existe (99° EGB) |
Fila rechazada indicando el valor |
| Alumno ya matriculado en el año | 409 — El alumno ya está matriculado en este año |
| Cualquier fila con error | No se importa nada (todo-o-nada): se corrige y se vuelve a subir |

Historial académico
La ficha del alumno (clic sobre su fila) muestra todas sus matrículas con año, curso y estado (inscrito, promovido, retirado…), la boleta descargable de cada año, y el histórico importado de años previos al sistema.

| Intento | Respuesta del sistema |
|---|---|
| La familia pide la ficha administrativa completa | 403 — la familia consulta el progreso por la app, no el expediente |
| Borrar una matrícula histórica | No existe: los retiros/traslados son transiciones con motivo, nada se borra |
Asistencia
Cada falta genera alerta automática a la familia. El resumen del alumno (presentes, atrasos, faltas) está en su ficha y en la app. Las faltas se justifican en inspección con motivo y documento adjunto.

| Intento | Respuesta del sistema |
|---|---|
| Justificar una falta que no es injustificada | 409 — Solo se justifican faltas injustificadas |
Adjuntar un archivo de tipo no permitido (.exe) |
Rechazado: solo PDF, imágenes y documentos de oficina |
Calificaciones y evaluaciones
Notas por parcial (0–10, dos decimales) con equivalencia automática DAR/AAR/PAR/NAR, promedios por período y anual, comportamiento A–E, y la boleta en PDF. La familia ve todo desde su cuenta — incluidas las rectificaciones ya aprobadas.

| Intento | Respuesta del sistema |
|---|---|
| Consultar notas de un alumno ajeno | La app solo expone sus hijos (my-students) |
| "¿Por qué cambió esta nota?" | Toda rectificación queda auditada: valor anterior, nuevo, motivo y quién la aprobó |
Consulta de horarios
El horario semanal del paralelo (día, hora, materia, docente, aula) es visible para la familia desde su cuenta.

Estado de cuenta y pagos
La familia ve obligaciones, abonos y saldo — consolidado si tiene varios hijos. Cada pago registrado por secretaría le llega como confirmación. El estado de cuenta se exporta a Excel.

| Intento | Respuesta del sistema |
|---|---|
| Registrar un pago mayor al saldo | 400 — El pago excede el saldo (ver errores) |
| Pagar una obligación anulada o ya pagada | 409 — La obligación ya está PAGADA/ANULADA |
Acceso a tareas, recursos y comunicados
Los comunicados llegan con push + correo, con hasta 5 adjuntos, al alcance elegido (colegio, grado o paralelo). Las tareas y materiales viven en el aula virtual Moodle: el sistema crea automáticamente cursos y usuarios, y la credencial de Moodle se entrega junto con la del sistema.

Portal para padres: el progreso de sus hijos
- Primer ingreso con la credencial temporal → cambio de contraseña obligatorio.
my-studentsdevuelve a todos sus hijos (una sola cuenta).- Por cada hijo: calificaciones, asistencia, estado de cuenta, horario, comunicados y boleta PDF.
| Intento | Respuesta del sistema |
|---|---|
| Usar la contraseña temporal sin cambiarla | Solo se permite cambiar contraseña; todo lo demás responde 403 |
| Adivinar contraseñas (fuerza bruta) | Rate limit por IP en login: 429 — Demasiados intentos |
| Leer la ficha completa de un alumno | 403 — reservada al personal (LOPDP) |
| Su acceso a datos | Queda auditado: quién consultó qué y cuándo |