Develop

[betilloXann]

Esta PR introduce mejoras significativas en el modelo de datos, las operaciones por lotes y los reportes basados en periodos para estudiantes y matrículas. Los cambios principales incluyen un manejo mejorado de los periodos de matrícula, un registro masivo de estudiantes más robusto con sus matrículas asociadas, nuevas utilidades de simulación para datos de semestre y la refactorización del panel de control del departamento para soportar la selección de periodos y estadísticas.

---

Modelo de Matrícula y Manejo de Periodos:

• Se agregó un campo periodId a EnrollmentModel y un método estático getPeriodId para calcular el periodo basado en la fecha, asegurando que cada matrícula esté asociada a un semestre específico. Además, se implementó un método toMap para facilitar la serialización.

---

Registro Masivo de Estudiantes y Creación de Matrículas:

• Se refactorizó AuthRepository.bulkRegisterStudents para usar lotes controlados de Firestore, agregar nuevas matrículas para cada materia que un estudiante curse y asegurar que cada matrícula tenga el periodId correcto. El proceso ahora crea documentos tanto de usuario como de matrícula, y realiza commits de los lotes antes de alcanzar los límites de operaciones de Firestore.
• Se añadió la importación de EnrollmentModel para soportar la nueva lógica de matrículas.

---

Utilidades de Admin y Gestión de Semestres:

• Se actualizó AdminRepository.createUser para devolver el ID del nuevo usuario para uso posterior, y se agregó un método para insertar matrículas rápidamente. Además, al eliminar estudiantes, ahora se eliminan sus matrículas asociadas. Se introdujo closeSemesterCycle para actualizar el periodo activo en la configuración global, apoyando la transición entre semestres.

---

Servicio de Simulación:

• Se agregó SimulationService para generar usuarios y matrículas de prueba para un periodo dado, apoyando pruebas realistas y la población del panel de control.

---

Refactorización del Dashboard para Reportes Basados en Periodos:

• Se refactorizó DepartmentHomeViewModel para soportar la selección de periodos, cargar estudiantes y estadísticas del periodo seleccionado, y proporcionar conteos por academia. Esto permite vistas dinámicas del dashboard basadas en el semestre.

---

Otros:

• Se agregó documentación y descripción a devtools_options.yaml para mayor claridad en las herramientas del proyecto.
• Se añadió un método copyWith a UserModel para facilitar la actualización de objetos.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
proyecto-tutorias	Ready	Preview, Comment	Jan 7, 2026 2:10am