UNIVERSIDAD NACIONAL DE HUANCAVELICA
(Creada por la Ley Nº 25265)
FACULTAD DE INGENIERÍA ELECTRÓNICA-SISTEMAS
ESCUELA PROFESIONAL DE INGENIERÍA DE SISTEMAS
“Codificación De Un Sistema Web De Gestión Académica Para “Alan turing
Institute English Utilizando La Metodología Scrum (SIGAI)”
Docente: Mg. Ing. Gilmer S. MATOS VILA
Ciclo: VII, Sección: B
Integrantes:
− Cañete Ichillumpa Steven Richard
− Taipe Ramos Rossel Angel
− Noa Aparco Jhon Anderson
− Rojas Boza Ronald
− Tineo Quispe Feliciano
− Mayhua Quipe Dennis
DANIEL HERNANDEZ – TAYACAJA 2026
INTRODUCCIÓN
El presente manual técnico documenta el diseño, desarrollo e implementación de
SIGAI (Sistema de Gestión Académica Integral), una plataforma web creada para
automatizar y optimizar los procesos académicos del Alan Turing Institute English. El
sistema integra módulos esenciales como gestión de usuarios, configuración
académica, matrículas, registro de notas, asistencia y generación de reportes, brindando
una solución tecnológica eficiente, escalable y segura para instituciones educativas.
El desarrollo se ejecutó bajo la metodología ágil SCRUM, permitiendo una
planificación iterativa mediante sprints, priorización continua de funcionalidades,
colaboración efectiva entre roles técnicos y entrega incremental de software funcional.
Cada sprint culminó con revisiones técnicas y validaciones funcionales, asegurando la
calidad y alineación con los requisitos del usuario.
Adicionalmente, el proyecto se alineó con estándares internacionales de calidad de
software, aplicando los lineamientos de ISO/IEC 12207:2017 para procesos de
desarrollo, ISO/IEC/IEEE 29148:2018 para gestión de requisitos y ISO/IEC
25010:2011 para la evaluación de atributos de calidad como funcionalidad, usabilidad,
seguridad y rendimiento.
DEFINICIÓN DE OBJETIVOS Y ALCANCE
OBJETIVO:
Implementar un Sistema que permita la gestión eficiente de consultas, historial médico del
estudiante, programación de citas, generación de reportes, y seguimiento de casos de los
estudiantes.
ALCANCE:
El sistema incluye los siguientes módulos:
● Gestión de usuarios y autenticación (roles: administrador, docente, estudiante)
● Configuración académica (niveles, grupos, asignación docente, pesos de
evaluación).
● Gestión de matrículas (registro de estudiantes, validación de requisitos, generación
de códigos únicos).
● Registro de asistencia y notas (toma diaria, ingreso de calificaciones,
retroalimentación).
● Visualización de información (agenda docente, libreta de notas, dashboard de
métricas).
● Generación de reportes (académicos, estadísticos, históricos).
● Gestión de feriados y reposiciones (calendario académico).
● Gestión de feriados y reposiciones (calendario académico).
3. Stack Tecnológico
Componente
Lenguaje Backend
Framework Backend
Base de Datos
Tecnología / Herramienta
Java
Spring Boot
PostgreSQL
Lenguaje Frontend
TypeScript
Framework Frontend
React
Estilos CSS
TailwindCSS
Generación PDF
OpenPDF
Control de Versiones
Git
Metodología
Scrum
ARQUITECTURA DEL PROYECTO
Versión / Detalle
21 LTS
3.3.0
16 (localhost:5432, db:
sigai_db)
5.x
18 + Vite
3.x
1.3.35 (LGPL)
GitHub (HTTPS)
Agile — 4 Sprints
El sistema desarrollado utiliza el framework Django, el cual se basa en el patrón
arquitectónico MVC (Modelo-Vista-Controlador), pero con una adaptación propia
conocida como MTV (Model-Template-View). Esta variante mantiene la separación de
responsabilidades, aunque con un sistema de nombres y una estructura un poco distinta.
El código fuente está organizado en módulos (Apps de Django) para desacoplar la lógica
de negocio.
[PEGAR TEXTO DE ARQUITECTURA DEL DOCUMENTO ORIGINAL — Adaptar
la descripción MVT/MVC a la arquitectura real: Spring Boot (Java) + React
(TypeScript).]
Estructura de carpetas del proyecto
Descripción Técnica
Raíz del repositorio Git unificado
(backend + frontend)
sigai-backend/
Aplicación Spring Boot — Java 21, puerto
6060
.../model/
Entidades JPA (BaseEntity, Usuario,
Estudiante, Docente, Nota, etc.)
.../repository/
Interfaces JpaRepository (acceso a datos)
.../controller/
Controladores REST (lógica de negocio
inline, SIN presenter)
.../dto/
Data Transfer Objects (request/response)
.../service/
EmailService (envío de correos via
JavaMail)
sigai-frontend/
Aplicación React 18 + Vite + TypeScript,
puerto 5173
.../src/pages/
Vistas por módulo (tsx)
.../src/services/
Llamadas a API (fetch con X-Username
header)
.../src/components/
Componentes reutilizables (Layout,
Sidebar)
.../src/context/
Estado global — AppContext (usuario,
sesión)
DESARROLLO ITERATIVO DEL PROYECTO MEDIANTE SCRUM
Ruta / Carpeta
AlanTuringSystem/
Justificación de la elección de SCRUM para el proyecto
Para el desarrollo de sistemas de información académica, la metodología ágil Scrum se ha
consolidado como una de las más utilizadas debido a su enfoque iterativo e incremental,
orientado a la entrega continua de valor y a la adaptación al cambio. Scrum se basa en el
empirismo y el aprendizaje a partir de la experiencia, lo que permite afrontar problemas
complejos de manera flexible (Schwaber & Sutherland, 2020).
Descripción de los roles definidos
Rol
Nombre
Función
Product Owner (PO)
Rojas Boza Ronald
Define y prioriza el
Product Backlog basado en
el valor de negocio para el
Alan Turing Institute
English (SIGAI).
Representa los intereses
del instituto y valida los
incrementos del producto.
Scrum Master (SM)
Tineo Quispe Feliciano
Facilita el marco de
trabajo, elimina
impedimentos y protege al
equipo de desarrollo.
Development Team
Taipe Ramos Rossel Angel
Equipo multidisciplinario:
desarrollo backend,
frontend y testing.
Development Team
Noa Aparco Jhon
Anderson
Equipo multidisciplinario:
desarrollo backend,
frontend y testing.
Development Team
Cañete Ichillumpa Steven
Richard
Equipo multidisciplinario:
desarrollo backend,
frontend y testing.
PLANIFICACIÓN GENERAL DE LOS SPRINTS
[PEGAR TABLA DE PLANIFICACIÓN DE SPRINTS DEL DOCUMENTO
ORIGINAL — Mantener la estructura de 4 sprints. Actualizar códigos de HU según el
proyecto SIGAI.]
Sprint
Código
Nombre de la Historia de
Usuario
Sprint 0 (Preparación)
HU-01
Autenticación y Control de
Sesión
SPRINT 1
HU-03
Registro de Nuevo
Estudiante y Docente
HU-06
Configuración de Niveles
Académicos
HU-07
Creación de Grupos y
Asignación Docente
HU-04
Proceso de Matrícula
SPRINT 2
HU-02
Gestión de Perfil de
Usuario
HU-08
Visualización de Grupos
Académicos
HU-09
Toma de Asistencia Diaria
HU-10
Gestión de Materiales
SPRINT 3
HU-05
Gestión del Estado del
Estudiante
HU-11
Registro de Evaluaciones
con Pesos
HU-12
Registro de Notas y
Promedio Ponderado
SPRINT 4
HU-13
Generación de Reportes
Académicos y Libreta en
PDF
IMPLEMENTACIÓN TÉCNICA Y FUNCIONAL DEL PROYECTO POR
SPRINTS
4.4.1. Sprint 0
[PEGAR CONTENIDO DE SPRINT 0 DEL DOCUMENTO ORIGINAL — Estructura
del proyecto, configuración de base de datos, arquitectura base, roles, creación del
administrador inicial, configuración de autenticación, configuración del repositorio.]
[NOTA PARA EL DESARROLLADOR: En nuestro proyecto, Sprint 0 cubrió:
configuración de Java 21, Spring Boot 3.3, PostgreSQL, React + Vite + TypeScript,
estructura del repositorio Git unificado, y el esquema inicial de la base de datos sigai_db.]
[PEGAR CAPTURAS DE EVIDENCIA sprint_0/ aquí]
4.4.2. Sprint 1
[PEGAR CONTENIDO DE SPRINT 1 DEL DOCUMENTO ORIGINAL — HU-01,
HU-03, HU-06, HU-07, HU-04. Mantener estructura de tablas, modelos, migraciones,
formularios y templates.]
[NOTA PARA EL DESARROLLADOR: En nuestro proyecto, Sprint 1 cubrió:
autenticación JWT, gestión de usuarios (ADMIN), niveles académicos, grupos con
docente asignado, y matrículas con validaciones.]
[PEGAR CAPTURAS DE EVIDENCIA sprint_1/ aquí]
4.4.3. Sprint 2
[PEGAR CONTENIDO DE SPRINT 2 DEL DOCUMENTO ORIGINAL — HU-02,
HU-08, HU-09, HU-10, HU-05. Mantener estructura de tablas, modelos, formularios y
templates.]
[NOTA PARA EL DESARROLLADOR: En nuestro proyecto, Sprint 2 cubrió: perfil de
usuario (teléfono, dirección, foto), grupos académicos con horarios, registro de asistencia
(PRESENTE/AUSENTE/JUSTIFICADO), gestión de materiales, y estado del estudiante
(REGISTRADO, RETIRADO, EGRESADO).]
[PEGAR CAPTURAS DE EVIDENCIA sprint_2/ aquí]
4.4.4. Sprint 3
[PEGAR CONTENIDO DE SPRINT 3 DEL DOCUMENTO ORIGINAL — HU-11,
HU-12. Mantener la estructura.]
[NOTA PARA EL DESARROLLADOR: En nuestro proyecto, Sprint 3 cubrió:
evaluaciones con peso porcentual (peso_porcentual) y nota mínima aprobatoria
(nota_minima_aprobatoria), y registro de notas con cálculo de promedio ponderado =
sum(nota * peso/100) / sum(pesos) * 100. La FK de la tabla notas se corrigió para
apuntar a evaluaciones_academicas(id).]
[PEGAR CAPTURAS DE EVIDENCIA sprint_3/ aquí]
4.4.5. Sprint 4
[PEGAR CONTENIDO DE SPRINT 4 DEL DOCUMENTO ORIGINAL — HU-13.
Mantener la estructura.]
[NOTA PARA EL DESARROLLADOR: En nuestro proyecto, Sprint 4 cubrió:
generación de reportes académicos en PDF (libreta de notas y reporte de asistencia)
usando la librería OpenPDF 1.3.35. El ReporteController genera PDFs dinámicos con
información de notas, promedio ponderado y asistencia por estudiante.]
[PEGAR CAPTURAS DE EVIDENCIA sprint_4/ aquí]
CONCLUSIONES
[PEGAR CONCLUSIONES DEL DOCUMENTO ORIGINAL — Mantener la estructura
y adaptar al proyecto SIGAI Alan Turing Institute English. Incluir: cumplimiento de
objetivos, arquitectura Spring Boot + React, metodología Scrum, validaciones de
negocio, calidad del software e ISO/IEC 12207:2017.]