2. General Description - migueltovarb/ISWREQUERIMIENTOS202502-1Jenifrutica GitHub Wiki

2. Descripción General

2.1 Perspectiva del Producto

2.2 Funciones del Producto

2.3 Clases de Usuario y Características

A continuación se describe cada uno de los tipos de usuario que van a usar el Sistema TROLI de Gestión de Estudiantes y Notas:

Tipo de Usuario Descripción Responsabilidades Principales Características Técnicas Nivel de Acceso
Estudiante Usuario cuyo propósito principal es consultar información académica propia, inscribirse en cursos y recibir calificaciones de sus evaluaciones. • Consultar calificaciones y promedios propios• Inscribirse en cursos disponibles• Descargar comprobantes académicos en PDF• Consultar estado académico general• Recibir notificaciones de nuevas calificaciones• Modificar datos personales (correo, teléfono) • Acceso únicamente a información personal y académica propia• Interfaz simplificada enfocada en consulta y visualización• Notificaciones automáticas de cambios en calificaciones• Dashboard personalizado con resumen académico• Acceso móvil responsive Restringido: Solo a sus datos académicos
Profesor Usuario encargado de registrar y modificar calificaciones de estudiantes inscritos en sus cursos, así como consultar y reportar rendimiento académico grupal. • Registrar calificaciones por tipo de evaluación• Modificar/eliminar únicamente sus calificaciones registradas• Consultar lista de estudiantes inscritos en sus cursos• Generar reportes de rendimiento grupal• Visualizar estadísticas de sus cursos• Gestionar observaciones académicas • Acceso limitado solo a cursos asignados por administración• Interfaz con formularios especializados para registro de notas• Validaciones automáticas de rango (0.0-5.0)• Exportación de reportes en PDF• Historial de calificaciones registradas• Notificaciones de nuevas inscripciones Intermedio: Solo cursos asignados
Administrador Usuario con privilegios de gestión global sobre usuarios, cursos, calificaciones, períodos académicos y configuración general del sistema. • Crear, editar, eliminar y gestionar usuarios del sistema• Crear y administrar cursos y períodos académicos• Supervisar y corregir calificaciones cuando sea necesario• Generar reportes institucionales avanzados• Supervisar historial de cambios y auditoría• Gestionar notificaciones y comunicaciones masivas• Configurar parámetros del sistema • Acceso total y sin restricciones al sistema• Interfaz avanzada con herramientas administrativas completas• Acceso a logs de auditoría y trazabilidad completa• Generación de reportes institucionales en múltiples formatos• Control sobre seguridad, permisos y configuraciones• Panel de estadísticas globales del sistema Total: Acceso completo al sistema

2.4 Entorno Operativo

El Sistema TROLI de Gestión de Notas opera como una aplicación web completamente funcional que requiere conexión a internet para su funcionamiento. La plataforma está diseñada para ejecutarse de manera óptima en navegadores web modernos como Google Chrome, Mozilla Firefox, Microsoft Edge y Safari, garantizando compatibilidad completa tanto en sistemas operativos Windows, macOS como Linux.

Tecnología Backend: El sistema utiliza Django Framework con Python como tecnología backend y SQLite como gestor de base de datos principal, con capacidad de migración a PostgreSQL o MySQL para entornos de mayor escala.

Accesibilidad y Compatibilidad: La aplicación cuenta con una interfaz web responsiva que se adapta automáticamente a diferentes dispositivos, permitiendo que estudiantes, profesores y administradores accedan a sus funcionalidades desde computadoras de escritorio, tablets y dispositivos móviles Android e iOS de manera fluida. Los usuarios pueden realizar consultas de calificaciones, registro de notas, gestión administrativa y descarga de comprobantes de forma remota desde cualquier ubicación con conectividad a internet.

Rendimiento y Disponibilidad: La plataforma mantiene un rendimiento estable con tiempos de respuesta inferiores a 3 segundos para consultas académicas básicas y soporta múltiples usuarios simultáneos sin degradación del servicio. El sistema garantiza la disponibilidad continua del servicio académico, asegurando estabilidad y accesibilidad para todos los roles de usuario del entorno universitario.

2.5 Restricciones de Diseño e Implementación

El diseño e implementación del Sistema TROLI están condicionados por diversos factores técnicos y académicos específicos del entorno universitario.

Compatibilidad y Diseño: El sistema debe ser completamente compatible con navegadores web modernos y dispositivos móviles, por lo que emplea tecnologías web estándar y diseño responsivo que garantiza la correcta visualización y funcionalidad sin importar el dispositivo utilizado.

Seguridad y Control de Acceso: Por motivos de seguridad académica, toda la información sensible como calificaciones, datos personales de estudiantes y credenciales de acceso se maneja mediante protocolos seguros y validaciones estrictas de acceso por rol. El entorno operativo implementa autenticación por roles, validación de sesiones y control de acceso granular según el tipo de usuario.

Arquitectura Técnica: El desarrollo se realizó bajo una arquitectura web basada en Django Framework con Python, empleando patrones de diseño que garantizan escalabilidad, mantenibilidad y fácil extensión de funcionalidades. La implementación utiliza el patrón Modelo-Vista-Template de Django, ORM integrado para gestión de datos y sistema de autenticación robusto que diferencia claramente los permisos entre estudiantes, profesores y administradores.

Optimización de Recursos: Considerando que las instituciones educativas pueden tener recursos de hardware y conectividad variables, el sistema está optimizado para ser eficiente en el uso de recursos, con una base de datos SQLite liviana para implementaciones pequeñas y medianas, y arquitectura preparada para migración a sistemas más robustos cuando sea necesario.

Identidad Visual e Institucional: El diseño visual se alinea con estándares académicos profesionales, utilizando una paleta de colores clara, tipografías legibles y elementos visuales que reflejan la seriedad académica requerida en un entorno universitario.

2.6 Documentación de Usuario

Como parte integral del Sistema TROLI implementado, se proporciona documentación wiki completa y accesible que facilita el uso efectivo de la plataforma para todos los tipos de usuarios académicos. Esta documentación incluye manuales específicos por rol donde se explican detalladamente las funciones principales como autenticación, navegación por dashboards personalizados, consulta de calificaciones, registro de notas y gestión de perfiles personales.

La plataforma incorpora un sistema de ayuda contextual accesible desde la interfaz principal, que proporciona orientación inmediata sobre el uso de cada módulo y respuestas a preguntas frecuentes organizadas por tipo de usuario. El sistema incluye mensajes informativos, validaciones claras y confirmaciones que guían a los usuarios durante la ejecución de tareas críticas como registro de calificaciones o modificación de datos importantes.

Toda la documentación está disponible tanto en formato digital integrado en el sistema como en documentos externos de la wiki, garantizando que los usuarios puedan acceder a la información de ayuda en cualquier momento durante su interacción con la plataforma académica.

2.7 Supuestos y Dependencias

Se asume que la Institución cuenta con una infraestructura tecnológica académica básica que incluye conexión estable a internet, equipos de cómputo actualizados en laboratorios y áreas administrativas, y personal técnico capacitado para administrar y dar soporte al sistema. Se considera que los usuarios finales, incluyendo estudiantes, profesores y personal administrativo, disponen de dispositivos con navegadores web modernos y competencias digitales básicas necesarias para la navegación web y uso de sistemas académicos.

El correcto funcionamiento del Sistema TROLI depende de la estabilidad del framework Django y sus componentes asociados, incluyendo el sistema de autenticación integrado, el ORM para gestión de base de datos y el motor de templates para renderizado de interfaces. Las notificaciones internas del sistema operan de manera autónoma sin dependencias externas, aunque futuras integraciones con servicios de correo institucional podrían requerir configuraciones adicionales de conectividad.

La escalabilidad del sistema está condicionada a la disponibilidad de recursos de servidor y la posible migración de SQLite a sistemas de base de datos más robustos como PostgreSQL cuando el volumen de usuarios y datos académicos lo requiera. Se asume el compromiso institucional de mantener actualizados los datos académicos, realizar respaldos periódicos de la información de calificaciones y proporcionar el soporte técnico necesario para garantizar la operación continua durante períodos académicos críticos como épocas de exámenes e inscripciones. Finalmente, se considera que la institución mantendrá las competencias técnicas internas o el soporte externo necesario para administrar, actualizar y mantener la plataforma operativa de manera confiable y segura.