Documento de Requerimientos - Sistema de
Gestión Escolar CUSA
🌟 Propósito General
Facilitar la organización académica y administrativa brindando espacios
personalizados para alumnos, docentes y personal administrativo, con el fin
de mejorar la comunicación, el seguimiento académico y la eficiencia
institucional.
🔹 Requerimientos Funcionales (MVP)
Estudiantes
1. Consultar calificaciones por materia y parcial.
2. Visualizar horario y calendario de clases.
3. Recibir tareas y avisos de docentes.
4. Acceso a documentos oficiales (constancias, historial).
5. Acceso a materiales educativos digitales.
Docentes
1. Registro y edición de calificaciones por grupo.
2. Registro de asistencia por día y materia.
3. Asignación de tareas con fechas de entrega.
4. Envio de mensajes/avisos a estudiantes.
5. Consulta de horario, grupos asignados y calendario escolar.
Personal Administrativo
1. Consultar historial académico de alumnos.
2. Generar constancias automáticas.
3. Gestionar inscripciones, grupos y materias.
4. Validación de pagos (registro manual o integración futura).
5. Control de permisos y roles de usuario.
🔹 Requerimientos No Funcionales
1. Accesibilidad desde dispositivos móviles y de escritorio.
2. Interfaz amigable, clara y responsiva (Tailwind CSS v4).
3. Seguridad de datos: encriptación, roles, sesiones protegidas.
4. Disponibilidad y rendimiento aceptable con alta concurrencia.
5. Modularidad y escalabilidad para agregar futuras funcionalidades.
6. Soporte multiusuario y multirol.
7. Uso de tecnologías modernas:
o Backend: Django (Python)
o Frontend: TypeScript + TailwindCSS v4
o Base de datos: PostgreSQL
o Gestor de dependencias: PNPM
🔢 Jerarquización de Módulos (por urgencia)
Módulo Prioridad Usuario Principal
Autenticación y Alta Todos
gestión de roles
Registro de Alta Docente
calificaciones
Consulta de Alta Estudiante
calificaciones
Horarios y Alta Estudiante
calendario escolar
Mensajería interna Media Docente
y avisos
Registro de Media Docente
asistencia
Consulta y Media Administrativo
generación de
documentos
Gestión de tareas y Media Docente/Alumno
materiales
Estadísticas y Baja Coordinador
reportes
académicos
Validación de pagos Baja Administrativo
y reinscripción
Módulo móvil / App Baja Todos
🔢 Salida esperada
Este documento sirve como base para el inicio de la fase de análisis y
diseño. A partir de aquí se construirá el backlog del proyecto, los primeros
wireframes, la estructura de la base de datos y el plan de desarrollo por
sprints. Además, orientará las decisiones de priorización y validación con
usuarios finales.
⚙️3. Desarrollo Modular (Fase de Programación)
Durante esta fase, el sistema se estructura en módulos claramente
definidos, lo que facilita el trabajo en equipo y permite una implementación
más ordenada y eficiente. El desarrollo se lleva a cabo mediante sprints
cortos, con objetivos definidos por módulo y entregas funcionales al finalizar
cada iteración.
Cada módulo aborda un área específica del sistema, garantizando su
independencia, aunque todos estén interconectados mediante una
arquitectura basada en el patrón MVC y consumo de servicios vía API REST.
Esta estructura modular asegura facilidad de mantenimiento, escalabilidad y
reutilización de componentes.
Se recomienda el uso de Git como herramienta de control de versiones y el
despliegue de los avances en entornos de prueba, ya sea en servidores
locales (como XAMPP o Laragon) o plataformas cloud (como Vercel o
Render).
🧩 Módulos principales y sus funciones
Usuarios y roles: Gestión de autenticación, creación de cuentas,
recuperación de contraseñas y asignación de permisos según tipo de
usuario.
Panel personalizado: Interfaz inicial que se adapta dinámicamente al
perfil del usuario, mostrando sólo la información y accesos relevantes
para su rol.
Calificaciones y asistencia: Permite a los docentes registrar
calificaciones y asistencia, mientras que los alumnos pueden consultar
su historial.
Tareas: Módulo para que los docentes asignen tareas, y los
estudiantes puedan entregarlas con retroalimentación directa.
Mensajes y notificaciones: Comunicación interna efectiva mediante
avisos generales, mensajes dirigidos o notificaciones automáticas.
Calendario institucional: Gestión centralizada de fechas importantes
como exámenes, tareas, eventos o periodos académicos.
Gestión administrativa: Herramientas para el personal
administrativo como asignación de aulas, manejo de horarios, pagos y
documentación.
Reportes automáticos: Generación de informes en PDF y Excel,
incluyendo gráficas estadísticas para evaluar el rendimiento
académico.
🧪 4. Pruebas internas y feedback
La fase de pruebas tiene como objetivo garantizar que cada módulo funcione
correctamente tanto de manera individual como integrada. También permite
recopilar impresiones de los usuarios finales para detectar áreas de mejora
antes de la implementación oficial.
✅ Tipos de pruebas aplicadas
Pruebas unitarias: Se aplican sobre componentes individuales, como
funciones, modelos o vistas, asegurando que cada uno cumpla su
objetivo de forma aislada.
Pruebas integradas: Verifican la interacción entre diferentes
módulos, comprobando la correcta comunicación entre frontend,
backend y base de datos.
Testeo con usuarios piloto: Participación de estudiantes, docentes o
personal administrativo en un entorno controlado, ejecutando
escenarios reales de uso.
📝 Gestión de feedback y errores
Para cada etapa de prueba se habilita un canal para el reporte de errores o
sugerencias. Esto puede hacerse mediante formularios, herramientas de
seguimiento de incidencias o bitácoras. Cada incidencia se analiza en
sesiones de revisión semanales, permitiendo su priorización en función de su
impacto, frecuencia o viabilidad técnica.
🚀 5. Implementación y Capacitación
Una vez que el sistema ha superado las pruebas iniciales, se procede a su
implementación de forma progresiva para reducir riesgos y facilitar la
adaptación de los usuarios.
🧭 Plan de implementación
Primera fase: Activación del sistema en una o dos carreras como plan
piloto, observando el comportamiento en condiciones reales.
Segunda fase: Expansión a otras áreas administrativas o carreras
adicionales, incorporando ajustes según la experiencia inicial.
Tercera fase: Implementación completa en todo el plantel, con
soporte continuo.
📚 Capacitación y soporte
Para asegurar una adopción efectiva, se desarrollan materiales de apoyo por
perfil:
Manuales de usuario: Instructivos impresos o digitales
personalizados para estudiantes, docentes y administrativos.
Guías rápidas: Documentos simples con pasos básicos para tareas
frecuentes.
Talleres exprés: Capacitaciones presenciales o virtuales enfocadas
en el uso del sistema según el rol del usuario.
6. Mantenimiento y Mejoras
Tras la implementación, el sistema entra en una etapa continua de
seguimiento y optimización. Esta fase es clave para asegurar la estabilidad
del sistema, atender solicitudes de mejora y reaccionar ante cambios en las
necesidades institucionales.
🐞 Corrección de errores
Se habilita un sistema de registro de errores, donde usuarios o
técnicos pueden reportar fallos detectados.
Se programan mantenimientos correctivos cada 2 a 4 semanas.
Problemas de seguridad o alta prioridad son tratados mediante
parches rápidos.
✨ Evolución funcional
Los usuarios pueden enviar sugerencias de nuevas funcionalidades
mediante formularios o el mismo sistema.
Estas propuestas son analizadas mensualmente y priorizadas según
beneficio, costo y viabilidad técnica.
Las mejoras se integran en pequeños sprints para evitar interrupciones
generales.
📊 Supervisión técnica y de uso
Se registran métricas clave como número de usuarios activos, tareas
entregadas o visitas por módulo.
Se pueden implementar herramientas de monitoreo (como Sentry,
Prometheus o herramientas propias).
Se genera un informe trimestral con datos de uso y propuestas
estratégicas de mejora.
