68 KiB
68 KiB
Changelog Oficial — Admin Edu-Space (UniCABA)
Todas las modificaciones notables a este proyecto serán documentadas en este archivo. El formato está basado en Keep a Changelog y este proyecto se adhiere a Semantic Versioning.
[Unreleased]
Planificado (Fase 6 del Roadmap)
- Despliegue e Infraestructura (Fase 6):
docker-compose.ymlproductivo orquestando Flask (Gunicorn), Node.js BFF (PM2) y PostgreSQL 15, con proxy inverso Nginx, SSL/TLS y compresión. - Sincronización Continua Moodle (Fase 6): Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1.
- Pruebas de Carga y Hardening (Fase 6): Pruebas de estrés de concurrencia y validación final de producción.
[3.5.4] - 2026-10-16
Added
- Integración completa bidireccional con el Web Service
moodle_apide Moodle Local (10.0.0.207) usando token dedicado810428346d3601c68a37a315fcba8d4391629f46. - Soporte para autenticación delegada Moodle (
/api/v1/auth/moodle) con fallback dinámico entremoodle_apiymoodle_mobile_app, y matching por número de documento (DNI) y prefijo de usuario. - Endpoint administrativo
POST /api/v1/admin/moodle/sync-from-moodlepara sincronización directa de usuarios, roles y catálogo de cursos desde Moodle hacia la base de datosclassrooms_db. - Métodos
get_courses(),get_categories()ysync_from_moodle_to_app()enMoodleClient. - Otorgamiento de capability
moodle/webservice:createtokenal rol autenticado de Moodle en10.0.0.207y habilitación de Web Services para login token.
Fixed
- Corrección de firma en
MoodleClient.test_connection(server_url, token)que causaba TypeError al recibir argumentos opcionales desde el panel de ajustes. - Solución al error de resolución de módulos de Pyright/Pylance en
scripts/import_moodle_to_app.pymediante configuración de.vscode/settings.jsony carga modular dinámica.
[3.5.3] - 2026-10-16
Agregado & Corregido (Sincronización de Roles Moodle-App, Limpieza Admin & Hardening)
- Importador y Sincronización de Roles con la App (
scripts/import_moodle_to_app.py& flag--sync-app):- Mapeo directo y coherente de roles académicos: docentes de Moodle (
editingteacher) asignados aDocente(role_id=2) y estudiantes (student) asignados aAlumno(role_id=6) en el modelo RBAC de PostgreSQL de la App (classrooms_db). - Ingesta exitosa de 653 usuarios únicos (15 Docentes y 640 Alumnos) con contraseñas seguras PBKDF2 coincidentes con el DNI, nombres, apellidos y correos personales reales.
- Habilitada la vinculación inmediata con comisiones (
commission_teachers), reservas docentes e inscripciones de cursada (student_enrollments).
- Mapeo directo y coherente de roles académicos: docentes de Moodle (
- Desmatriculación Total de la Cuenta Admin en Moodle Local (
10.0.0.207):- Removidas todas las asociaciones y enrolamientos espurios de la cuenta
adminen asignaturas académicas y cursos institucionales (conteo reducido a 0 matriculaciones). - Eliminado el curso dummy residual
Prueba matriculaciones masivas(ID 22). - Preservados estrictamente los 16 cursos legítimos de la carrera Licenciatura en Tecnologías Digitales (CCC).
- Removidas todas las asociaciones y enrolamientos espurios de la cuenta
[3.5.2] - 2026-10-16
Corregido & Mejorado (Replicación Integral de Carreras y Materias, User-Agent Mozilla/5.0, Login Local Fix)
- Replicación Completa de los 16 Cursos de la Carrera:
- Ampliado el catálogo de cursos de la Licenciatura en Tecnologías Digitales (CCC) de 4 a 16 asignaturas completas (1/2025, 2/2025, 1/2026 y 2/2026).
- Resuelto el problema de alumnos (ej.
90010202- Carlos Guillermo Terzano) que solo veían la carrera y no sus materias cursadas: ahora cuentan con sus asignaturas y comisiones reales replicadas y matriculadas en Moodle Local (10.0.0.207). - Más de 1.100 matriculaciones procesadas y verificadas con éxito en tiempo real.
- Corrección de Inicio de Sesión de Alumnos en Moodle Local:
- Solucionada la desincronización de contraseña del usuario
34247025: restablecida y verificada con éxito tanto por CLI como vía API para que el DNI opere idénticamente comousernameypassword. - Mecanismo en
get_or_create_userpara forzar la actualización de contraseña y correo de cuentas existentes evitando bloqueos por credenciales obsoletas.
- Solucionada la desincronización de contraseña del usuario
- Personalización de Cabeceras HTTP (User-Agent):
- Configurado estrictamente el encabezado
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)en todas las sesiones y scripts hacia el Campus Virtual UniCABA, eliminando la firma por defecto depython-requests.
- Configurado estrictamente el encabezado
- Pre-caché y Optimización de Extracción:
- Carga automática de correos previamente cacheados desde
participantes_export.jsonpara reducir en un 80% las consultas HTTP a producción y evitar timeouts.
- Carga automática de correos previamente cacheados desde
[3.5.1] - 2026-10-16
Agregado & Mejorado (Replicador de Moodle Producción a Entorno Local con Usuarios y Correos Reales)
- Skill y Script de Replicación (
.agents/skills/moodle-replicator/SKILL.md&scripts/moodle_replicator.py):- Autenticación automatizada en Moodle Producción (
https://campus.udelaciudad.edu.ar/) mediante extracción delogintokenpre-sesión. - Extracción híbrida: descarga masiva JSON vía
action_redir.php+ scraping optimizado de perfiles de usuario. - Correos Electrónicos Reales: Consulta concurrente de perfiles para capturar el email real y personal de cada estudiante y docente (omitiendo emails sintéticos o inventados).
- Mocking Determinístico de DNI: Generación de DNI de 8 dígitos (
90{moodle_id:06d}) comousernameypasswordpara el entorno local, preservando el DNI real de Carlos Tello (34247025). - Carga en Moodle Local (
10.0.0.207): Creación y actualización de cuentas mediantecore_user_create_usersycore_user_update_userscon enrolamiento manual (enrol_manual_enrol_users) con roles de estudiante (student, ID 5) y profesor (editingteacher, ID 3). - 504 matriculaciones completadas exitosamente en 4 cursos: Carrera Lic. en Tecnologías Digitales (922 -> 19), ASIG00124 (5311 -> 16), ASIG00126 (5313 -> 17) y ASIG00127 (5314 -> 18).
- Verificación de login exitosa de alumnos en Moodle local (
http://10.0.0.207/moodle/login/index.php).
- Autenticación automatizada en Moodle Producción (
- Especificación SDD (
specs/002-moodle-export-sync/):spec.mdcon 6 Requisitos Funcionales en sintaxis EARS, plan de arquitectura y tareas verificables completadas al 100%.
[3.5.0] - 2026-10-16
Agregado & Mejorado (Cierre Formal MVP Bedelía & Adopción Metodología SDD / Arnés de IA)
- Arnés de Ingeniería de Software con IA (Harness Engineering):
- Incorporación de la skill formal de SDD (
.agents/skills/sdd/SKILL.md) con las directivas de especificación, planificación y tareas. - Implementación de comandos personalizados en
.opencode/commands/(sdd-spec,sdd-plan,sdd-tasks). - Configuración de roles de subagentes en
.opencode/agents/: Coordinator, Planner, Implementer, Reviewer (QA). - Actualización de
AGENTS.mdcon las reglas mandatorias del flujo SDD y sintaxis EARS.
- Incorporación de la skill formal de SDD (
- Especificación Formal de Cierre de MVP (
specs/001-cierre-mvp-bedelia/):- Delimitación inamovible de los 10 Requisitos Funcionales en notación EARS y delimitación explícita de Fuera de Alcance para evitar el Scope Creep.
- Herramientas de Exportación e Impresión para Bedelía y Portería:
- Nuevo endpoint en Frontend BFF (
/schedule/export_csv) que genera un archivo CSV con formato Excel nativo (UTF-8 con BOM\uFEFFy separador;) conteniendo la cartelera de clases del día/semana seleccionada. - Botón "Excel / CSV" y botón "Imprimir" en
/schedule/today(today.html). - Hojas de estilo CSS
@media printpara impresión oficial limpia en hoja A4 con membrete institucional de UniCABA (oculta barras de navegación, botones y filtros). - Accesos directos de exportación e impresión en el Dashboard Operativo de Bedelía (
dashbede.html).
- Nuevo endpoint en Frontend BFF (
- Verificación de Calidad:
- 52 pruebas automatizadas en verde (
52 passed) en pytest.
- 52 pruebas automatizadas en verde (
[3.4.9] - 2026-10-09
Corregido & Mejorado (Importador de Google Sheets & Sistema de Diagnóstico de Incidentes)
- Corrección de Límite de Payload en Importación Masiva de Google Sheets (
PayloadTooLargeError):- Ajuste de los analizadores de cuerpo en el Frontend BFF Express (
express.json({ limit: '50mb' })yexpress.urlencoded({ extended: true, limit: '50mb' })), resolviendo el error 500 al enviar matrices de filas preseleccionadas (~154 KB que excedían el límite por defecto de 100 KB).
- Ajuste de los analizadores de cuerpo en el Frontend BFF Express (
- Sistema Institucional de Manejo de Incidentes y Diagnóstico Transparente:
- Reemplazo de la pantalla genérica de error por una interfaz estructurada con código de ticket único (
INC-YYYYMMDD-XXXX), código HTTP, síntesis contextual y recomendación de acción correctiva. - Sección técnica colapsable de diagnóstico con Ruta, Marca de Tiempo, Usuario activo, IP del cliente y Stack Trace.
- Botón "Copiar Reporte para Soporte" con formateo estándar para agilizar la asistencia técnica por Bedelía o Soporte IT.
- Registro automático del incidente técnico en
AuditLog(action='SYSTEM_ERROR',module='system') vía nuevo endpoint/api/v1/admin/log-error.
- Reemplazo de la pantalla genérica de error por una interfaz estructurada con código de ticket único (
- Auditoría Integral de Sincronización de Hojas de Cálculo (
/api/v1/dashboard/sync-sheets):- Registro de eventos exitosos (
SHEETS_IMPORT) con estadísticas de entidades procesadas (carreras, materias, comisiones, aulas, reservas) y filtros aplicados. - Registro de errores de sincronización (
SHEETS_IMPORT_ERROR) con detalle de la excepción para trazabilidad en la bitácora institucional.
- Registro de eventos exitosos (
[3.4.8] - 2026-10-09
Agregado & Mejorado (Registro de Auditoría Institucional y Trazabilidad Operativa)
- Auditoría Completa de Autenticación y Sesiones (
AuditService&/api/v1/auth/):- Registro sistemático de eventos de inicio de sesión exitosos (
LOGIN), inicios vía Google SSO (LOGIN_GOOGLE) y Moodle delegado (LOGIN_MOODLE). - Registro de intentos fallidos (
LOGIN_FAILED) con captura de correo, IP de origen y motivo del rechazo (credenciales inválidas, dominio no autorizado o cuenta inactiva). - Auditoría de accesos bloqueados por deshabilitación administrativa de contraseña local (
LOGIN_BLOCKED). - Auditoría de cierres de sesión (
LOGOUT) y cambios de contraseña institucional por el usuario (PASSWORD_CHANGE).
- Registro sistemático de eventos de inicio de sesión exitosos (
- Trazabilidad de Espacios Físicos, Aulas y Reservas:
- Auditoría de altas, modificaciones, bajas y alternancia de estado en edificios (
buildings) y aulas (classrooms). - Auditoría de creación, edición, cancelación, confirmación y borrado de reservas (
reservations). - Auditoría de corridas (
OPTIMIZE_RUN) y aplicación de asignaciones masivas (OPTIMIZE_APPLY) del Optimizador Genético IA.
- Auditoría de altas, modificaciones, bajas y alternancia de estado en edificios (
- Endpoint RESTful de Auditoría (
GET /api/v1/admin/audit-logs):- Exposición de endpoints RESTful con soporte de filtros por módulo, acción, búsqueda multi-campo y paginación configurable.
- Implementación del método
to_dict()en el modeloAuditLogpara serialización JSON segura.
- Interfaz Institucional de Auditoría (
/admin/audit_logs):- Conexión del Frontend BFF con el Backend REST Core.
- Badges temáticos e intuitivos para cada acción institucional y módulo.
- Filtros rápidos por categorías (Sesiones, Fallos de Login, Reservas, Aulas, Sedes, Optimizador IA).
- Modal interactivo de inspección con visor JSON/texto formateado y botón para copiar al portapapeles.
- Paginación dinámica nativa compatible con Nunjucks que conserva los parámetros de búsqueda.
[3.4.7] - 2026-10-08
Agregado & Mejorado (Panel Interactivo de Plantas y Aulas en Edificios)
- Gestión de Edificios (
/buildings/edit/:idy/buildings/add_building):- Transformación del formulario de edición de edificio de un mero input numérico a un Panel Interactivo de Plantas y Aulas de la Sede.
- Visualización completa de cada planta física (Subsuelos, Planta Baja, Entrepisos, Pisos 1..N) con badges de código, cantidad de aulas y capacidad instalada en alumnos.
- Listado detallado de aulas asociadas por planta física con enlaces directos a ficha, edición y reservas.
- Botón de acción directa
+ Nueva Aula en este Piso(/classrooms/add_classroom?building_id=X&floor=Y) que precarga automáticamente el edificio y el piso seleccionado. - Configurador rápido de niveles físicos con presets (
PB,PB + 1,PB + 3,Virtual), stepper dinámico y generador visual en tiempo real de la estructura proyectada.
- Módulo de Aulas (
/classrooms/add_classroom):- Soporte de preselección automática por URL (
building_idyfloor) para agilizar la creación de espacios desde la vista de edificios.
- Soporte de preselección automática por URL (
[3.4.6] - 2026-10-08
Corregido & Mejorado (Reservas, Relaciones Edificios/Aulas, Fechas y Filtros)
- Módulo de Reservas (
/schedule/add_reservationy/schedule/edit):- Corrección del fallo de serialización JSON que rompía el selector en cascada Edificio -> Piso -> Aula al seleccionar el "Edificio Central". Inyección segura de
classroom_data_jsonycommission_data_jsonsin escape de entidades HTML ("), y matching ultra tolerante de pisos físicos y virtuales.
- Corrección del fallo de serialización JSON que rompía el selector en cascada Edificio -> Piso -> Aula al seleccionar el "Edificio Central". Inyección segura de
- Calendario Académico (
/schedule/calendar_viewy/schedule/calendar_data):- Limpieza exhaustiva de datos mockeados y hardcodeados (
Arquitectura de Software ARQ-101,COM-A,Licenciatura en Sistemas). El feed y los filtros ahora consumen estrictamente asignaturas, carreras, comisiones y aulas reales de la base de datos institucional.
- Limpieza exhaustiva de datos mockeados y hardcodeados (
- Importador de Google Sheets (
sheets_importer.py):- Eliminación de la autogeneración no deseada de enlaces de Google Meet / Zoom (
https://meet.google.com/edu-...) en reservas importadas con celdas vacías (ej.#9797 ASIG00215 - Marketing Digital). Se respeta estrictamente el Sheet: solo se asocian enlaces virtuales si vienen explícitamente en el documento original.
- Eliminación de la autogeneración no deseada de enlaces de Google Meet / Zoom (
- UX/UI Ficha del Aula (
/classrooms/view_classroom):- Formateo amigable en español institucional para las reservas y clases programadas (ej.
Viernes 04/09/2026 · 18:30 a 21:30 hs) eliminando el formato ISO repetido y ampliando el rango de consulta a todo el ciclo lectivo 2026.
- Formateo amigable en español institucional para las reservas y clases programadas (ej.
- Gestión de Edificios, Aulas y Pisos Dinámicos (
/buildings/list_buildingsy/buildings/view/:id):- Corrección de la ficha de edificio que mostraba "No hay aulas asignadas a este edificio" a pesar de tener 6 aulas configuradas. Implementación del agrupador
floors_listyclassrooms_by_floor. - Corrección del contador de "Pisos Presenciales" en el listado general de edificios para mostrar el conteo real (4 pisos) en lugar de 0.
- Soporte de niveles dinámicos alfanuméricos: creación y selección de "Planta Baja (PB)", "Entrepiso (EP)", "Subsuelo (SS)", etc., en modelos, datalists y vistas de detalle.
- Corrección de la ficha de edificio que mostraba "No hay aulas asignadas a este edificio" a pesar de tener 6 aulas configuradas. Implementación del agrupador
- Filtros en Gestión de Comisiones (
/admin/commissions_list):- Corrección de
UnboundLocalErrorenbackend/app/routes/api/admin.pydentro deget_commissionscausado por importación interna tardía deCareer, que provocaba error 500 al filtrar por carrera (career_id=180, 181, 182). Grilla ahora filtra correctamente sobre materias compartidas (subject_careers).
- Corrección de
[3.4.5] - 2026-10-08
Corregido & Mejorado (Optimizador de Aulas por Inteligencia Artificial - IA)
- Corrección de Permisos RBAC para Bedelía y Operadores en el Optimizador Genético:
- Resolución del bloqueo que devolvía
403 Forbiddena usuarios con rolBedelia,Docenteo Administradores con roles formateados en minúsculas en los endpoints/api/genetic/commissions,/api/genetic/algorithm-status,/api/genetic/preview-optimization,/api/genetic/optimizey/api/genetic/apply-optimization. - Creación del helper de verificación de permisos
check_optimizer_permission(user, requires_write)enbackend/app/routes/genetic_algorithm.pyadmitiendo a Administradores, Bedelía, Docentes y permisos RBAC personalizados.
- Resolución del bloqueo que devolvía
- Enriquecimiento del Listado de Comisiones para Asignación Áulica:
GET /api/genetic/commissionsahora exponesubject_name,subject_code,career_name,scheduleyshiftpara cada comisión activa.
- Rediseño e Internacionalización de la Interfaz del Optimizador:
frontend/views/genetic_optimizer.html: Interfaz traducida integralmente a español institucional ("Optimizador Inteligente de Asignación de Aulas (IA)"), tarjetas interactivas de comisiones con badges de código, asignatura, carrera, turno, horario y aforo, buscador en vivo multi-criterio y manejo de errores visible.frontend/public/js/genetic-algorithm.js: Traducción de alertas, modales y tablas de resultados ("Resultados de la Optimización", "Previsualización", confirmación de aplicación directa a Bedelía).- Protección de la ruta web
/genetic_optimizerconrequireAuthe inyección de datos de sesión enfrontend/src/app.js.
[3.4.4] - 2026-10-07
Añadido & Mejorado (Dashboard Operativo de Bedelía y Admin)
- Filtro Temporal "Mañana" en Switchers de Período y Cartelera:
- Incorporación del botón de filtro temporal "Mañana" (
tomorrow) de forma homogénea en los switchers de período del dashboard:- Panel de Percentiles de Ocupación de Aulas Físicas: switcher con
Día (Hoy),Mañana,SemanayMes, calculando métricas de ocupación y aulas libres para el día siguiente. - Panel de Comisiones Asignadas vs Sin Asignar: visualización inmediata de comisiones con y sin aula asignada programadas para mañana.
- Panel de Aulas Físicas Asignadas vs Libres: tarjetas detalladas con aulas libres con botón de asignación directa y aulas en uso para el día de mañana.
- Cartelera Operativa & Agenda de Clases: pestaña "Clases de Mañana" con listado completo de cursadas presenciales y virtuales activas del día siguiente.
- Panel de Percentiles de Ocupación de Aulas Físicas: switcher con
- Soporte completo en backend (
backend/app/routes/api/dashboard.py): cálculo detomorrow_dt, estadísticas enfilter_stats['tomorrow'],tomorrow_schedule_listy soporte de sincronización de datos con frontend BFF.
- Incorporación del botón de filtro temporal "Mañana" (
[3.4.3] - 2026-10-07
Añadido & Refactorizado (Sincronización Google Sheets)
- Selección Granular de Entidades a Importar:
- Adopción del patrón visual de tarjetas checkbox (idéntico a la Herramienta de Reinicio y Purga Académica) con accesos rápidos "Marcar Todo" y "Desmarcar Todo".
- Toggles individuales para Asignaciones de aulas (
import_reservations), Aulas físicas y virtuales (import_classrooms), Comisiones de cursada (import_commissions), Asignaturas / Materias (import_subjects) y Carreras académicas (import_careers).
- Selector de Días de la Semana con Checkboxes Múltiples:
- Sistema de checkboxes para procesar concurrentemente múltiples días de la semana (Lunes a Sábado) con selectores rápidos ("Todos", "Lun a Vie", "Limpiar").
- Grilla de Previsualización Interactiva e Inspección Previa:
- El botón "Inspeccionar Sheet Online" no importa directamente; extrae y presenta una grilla interactiva completa (
preview_rows) de registros online. - Selección por fila mediante checkboxes individuales y checkbox maestro superior.
- Modificación manual inline de fechas de cursada por fila mediante Datepicker (
<input type="date">) y aplicador de fecha masiva a seleccionados. - Resaltado visual con badges de alerta y error ante registros incompletos o aulas no reconocidas.
- Buscador en vivo multi-criterio y paginación fluida (25 filas por página) para evitar bloqueos del navegador.
- Modal de confirmación previa con desglose exacto de filas y entidades antes de iniciar la sincronización.
- El botón "Inspeccionar Sheet Online" no importa directamente; extrae y presenta una grilla interactiva completa (
- Backend & BFF Endpoints:
POST /api/v1/dashboard/sheets-inspectretorna metadatos ypreview_rowscon inferencia de fechas, estados de validación y carreras compartidas.POST /api/v1/dashboard/sync-sheetsprocesa opcionalmenteselected_rowscon fechas editadas respetando la granularidad de entidades activadas.
[3.4.2] - 2026-10-07
Corregido & Mejorado (UX/UI)
- Agrupación Cronológica de Reservas en Cartelera del Día (
/schedule/today_schedule):- Corrección del bug que duplicaba visualmente una misma reserva por cada hora que abarcaba la cursada (eliminación del bucle
forde franjas horarias artificiales de 1 hora). - Implementación de agrupación nativa por franja horaria real de cursada (
grouped_slots, ej.08:00 - 11:00 hs,18:30 - 21:00 hs). - Cada reserva se muestra agrupada exactamente una sola vez en su bloque horario correspondiente, mostrando turno, duración, cupo, aula física/virtual, docente y enlace de videoconferencia.
- Corrección del bug que duplicaba visualmente una misma reserva por cada hora que abarcaba la cursada (eliminación del bucle
- Optimización de Formato de Fecha y Horario en el Sistema (
/schedule/list_reservations, etc.):- Reemplazo del formato ISO crudo con 'T' y segundos (
2026-10-08T08:00:00 - 2026-10-08T11:00:00 hs) por formato amigable en español:- Fecha:
Jueves 08/10/2026/08/10/2026. - Horario:
08:00 - 11:00 hs.
- Fecha:
- Creación de la función utilitaria
formatReservationDatesen el BFF y nuevos filtros Nunjucks (format_date_human,format_time,format_time_range). - Actualización de las vistas de tabla y mosaico/tarjetas en
list.html,today.htmlyview.html.
- Reemplazo del formato ISO crudo con 'T' y segundos (
[3.4.1] - 2026-10-07
Corregido
- Corrección de Bug en Importador de Google Sheets (
ReferenceError: availableCareers is not defined):- Declaración e inicialización con ámbito de función de
availableCareersyavailableSubjectsenhandleGoogleSheetsImport(frontend/src/routes/admin.js). - Eliminación del error 500 al acceder por GET a
/admin/google_sheets_importo/admin/import.
- Declaración e inicialización con ámbito de función de
- Corrección de Conteo y Renderizado de Aulas Virtuales en Dashboard de Bedelía:
- Corrección de la lógica de obtención de datos en
backend/app/routes/api/dashboard.pypara calcular las salas virtuales disponibles a partir de las 101 comisiones virtuales activas en Campus Virtual (Google Meet / Teams / Zoom) en lugar de limitarse a la única fila relacional enclassrooms. - Agregado del arreglo
virtual_roomscon metadatos completos (código de comisión, asignatura, enlace Meet, docente, cupo y turno) a los datos de Bedelía. - Incorporación de la pestaña "Salas Virtuales (Campus Virtual)" en el panel de Aulas de Bedelía (
dashbede.html), permitiendo supervisar y acceder directamente a todas las salas de videoconferencia.
- Corrección de la lógica de obtención de datos en
Refactorizado
- Modularización de Vistas por Roles (
dashboard.htmlcomo Layout Padre):- División de la plantilla monolítica
dashboard.htmlen 4 submódulos específicos por rol:dashadm.html(Administrador)dashbede.html(Bedelía)dashprof.html(Docente / Profesor)dashalum.html(Alumno / Estudiante)
- Implementación de inyección limpia de componentes en
dashboard.htmlmediante directivas{% include %}de Nunjucks.
- División de la plantilla monolítica
Documentación y Workflow
- Actualización de
docs/constitution.md(Principio 9):- Inclusión obligatoria del control de versión semántica al momento de compilar.
- Inclusión obligatoria del despliegue inmediato al servidor institucional de producción al finalizar la compilación.
[3.4.0] - 2026-10-07
Añadido
- Soporte de Materias Compartidas en Múltiples Carreras (Many-to-Many):
- Implementación de la tabla asociativa relacional
subject_careersen la base de datos para vincular asignaturas a más de una titulación académica de forma nativa. - Compatibilidad total hacia atrás preservando
career_idprincipal y exponiendo coleccionescareersenSubjectyCommission. - Desglose de badges en UI para cada carrera vinculada tanto en
/admin/subjects_listcomo en/admin/commissions_list. - Filtro avanzado por carrera en asignaturas y comisiones que incluye tanto la carrera principal como cualquiera de las carreras asociadas (
Subject.careers.any).
- Implementación de la tabla asociativa relacional
- Mejora Integral y Descubrimiento Dinámico del Importador Google Sheets (
sheets_importer.py):- Extracción y normalización automática de carreras múltiples separadas por guion en la planilla (ej.
DATOS (CCC) - TEC. DIG (CCC) - VIDEOJUEGOS (CCC),DATOS(CCC)-TEC.DIG,PROF PROF (CCC) - CIENCIAS,EF. SALUD - EF. GESTIÓN,ETD-MONO). - Mapeo canónico a nombres de carrera oficiales para evitar la creación de strings compuestos artificiales en la base de datos.
- Descubrimiento dinámico de pestañas desde
/pubhtmlcon regex optimizada para los 6 días de la semana (Lunes a Sábado con sus respectivos GIDs). - Normalización de URLs de Google Sheets para exportación CSV limpia sin restricciones de pestaña única.
- Soporte de múltiples códigos de asignatura por materia (ej.
ASIG00113 / ASIG000082) permitiendo indexación y búsqueda por cualquiera de los códigos. - Generación de informe semanal detallado con desglose de filas y estado por día de cursada (
by_day) en la interfaz de/admin/google_sheets_import.
- Extracción y normalización automática de carreras múltiples separadas por guion en la planilla (ej.
- Habilitación y Reactivación de Operador Institucional de Bedelía:
- Desbloqueo y activación de la cuenta
bedelia@edu-space.compara gestión operativa continua con credenciales institucionales.
- Desbloqueo y activación de la cuenta
[3.3.0] - 2026-10-07
Añadido
- Estandarización del Flujo Secuencial de Bedelía (9 Pasos Operativos):
- Formalización del circuito paso a paso para reemplazar el archivo Excel manual de uso diario:
- Sede / Edificio (
/buildings/list_buildings): Creación y administración del inmueble universitario. - Aula (
/classrooms/list_classrooms): Alta de espacios físicos y aulas virtuales con control de aforo y recursos. - Ciclo Lectivo (
/admin/academic_terms_list): Creación del período lectivo y activación del cuatrimestre corriente. - Carrera / Titulación (
/admin/careers_list): Creación y administración del programa académico institucional. - Asignatura / Materia (
/admin/subjects_list): Alta en plan de estudios asociada obligatoriamente a la Carrera. - Comisión (
/admin/commissions_list): Creación de comisiones con cupos y vinculación a la materia, ciclo lectivo y carrera asociada, con filtros directos por titulación. - Asociar Profesores (
/admin/commission_detail): Asignación del cuerpo docente y co-docentes con roles de cátedra. - Asociar Alumnos (
/admin/commission_detail): Matriculación con validación de restricciones horarias y excepciones de Bedelía. - Reserva de Espacios (
/schedule/add_reservationo Drag & Drop en/schedule/calendar_view): Asignación de aula y franja horaria en 1 clic con chequeo de conflictos.
- Sede / Edificio (
- Formalización del circuito paso a paso para reemplazar el archivo Excel manual de uso diario:
- Gestión Académica en RBAC y Reestructuración de Menús UX/UI:
- Ampliación de permisos RBAC para rol Bedelía permitiendo la administración total de ciclos lectivos, carreras, materias, comisiones, docentes, alumnos y reservas.
- Reorganización de la barra lateral de navegación según las mejores prácticas de IT y arquitectura de la información: menús especializados y directos para Administrador, Bedelía, Docente y Alumno.
- Control y Exposición de Versiones Institucionales (v3.3.0):
- Estandarización de número de versión en Backend (
__version__ = "3.3.0",/api/v1/version,/api/v1/health) y Frontend BFF (package.json,/version). - Badges de versión visibles y legibles en el pie del menú lateral (
sidebar-footer) y en la pantalla de inicio de sesión (login.html).
- Estandarización de número de versión en Backend (
- Corrección de Error en Catálogo de Aulas (
/classrooms/list_classrooms):- Resolución del error 500 (
Template render error: unknown block tag: endblock) balanceando los bloques condicionales de Nunjucks entre los modos presencial y virtual.
- Resolución del error 500 (
- Alineamiento de Documentación con SSD (Software System Design):
- Constitución del Sistema (
docs/constitution.md): Actualización con principios innegociables: arquitectura desacoplada REST + BFF, reemplazo definitivo del Excel, matriz de conflictos, caché de Moodle 4.1, y RBAC seguro. - Manual de Agentes (
AGENTS.md): Definición precisa del stack, comandos de desarrollo y pruebas, convenciones y límites. - Memoria Operativa (
MEMORY.md): Sincronización del estado de desarrollo para el Sprint Bedelía MVP. - Roadmap del Proyecto (
ROADMAP.md): Creación en la raíz del proyecto detallando el progreso y las metas del MVP. - Guía Operativa por Rol (
docs/GUIA_OPERATIVA_BEDELIA_Y_ROADMAP_FUTURO.md): Manual exhaustivo con paso a paso para Bedelía, Docentes y Alumnos.
- Constitución del Sistema (
- Mantenimiento del Importador de Google Sheets:
- Preservación del servicio
sheets_importer.pypara ingesta masiva inicial sin fricción para el personal.
- Preservación del servicio
[3.2.0] - 2026-09-23
Añadido
- Función de Reinicialización Total del Sistema (
POST /api/v1/admin/system/reset):- Módulo de Mantenimiento en Configuración Global (
/admin/settings): Nueva pestaña "Mantenimiento & Reinicio" con tarjeta de "Zona de Peligro" y advertencia sobre el alcance de la purga. - Requisito Estricto de Seguridad Institucional: Exige obligatoriamente la validación de la contraseña del usuario Administrador en sesión antes de ejecutar la acción; retorna 401 y aborta ante claves incorrectas registrando el evento
SYSTEM_RESET_FAILED. - Purga Referencial Completa: Vacía de forma segura y en orden estricto de claves foráneas: historiales previos (
AuditLog), reservas (Reservation), hitos evaluativos (AcademicMilestone), notas (MilestoneGrade), matrículas (StudentEnrollment), asignaciones docentes (CommissionTeacher), comisiones (Commission), materias (Subject), carreras (Career), recursos de aula (ClassroomResource), aulas (Classroom), sedes/edificios (Building), ciclos lectivos (AcademicTerm) y colas de sincronización Moodle (MoodleSyncTask). - Preservación Estricta de Administración y Cuentas: Mantiene 100% intactas todas las cuentas de usuario (
Usercon hashes de contraseñas), roles RBAC (Role), permisos (Permission), tipos de hitos (MilestoneType), configuraciones globales (SystemSetting) y todos los módulos de la pestaña Administración. - Trazabilidad Inmutable: Genera automáticamente un nuevo registro en
AuditLogcon la acciónSYSTEM_RESET, asociando el correo del administrador ejecutor, su IP y el recuento de entidades purgadas. - Interfaz de Usuario y Modal Interactivo: Diálogo modal
#modalResetSystemcon campo de contraseña enmascarada, switch de visibilidad, casilla de confirmación explícita y botón de confirmación con estado de carga (spinner).
- Módulo de Mantenimiento en Configuración Global (
Corregido
- Blindaje de Espacios y Sedes Vacíos (Presenciales y Virtuales):
- Prevención de Excepciones TypeError: Se corrigieron accesos inseguros a propiedades nulas o no definidas (
c.code.includes,r.start_time.startsWith,localeCompare) enfrontend/src/routes/classrooms.js, permitiendo navegar a/classrooms/list_classrooms?view_mode=physicaly/classrooms/list_classrooms?view_mode=virtualsin caídas ante bases vacías. - Corrección de Evaluación de Longitud en Nunjucks: Actualizadas las directivas condicionales en
frontend/views/classrooms/list.htmlaclassrooms.items|length > 0yvirtual_rooms|length > 0, garantizando el despliegue de los Empty States institucionales con botones de alta cuando no existen aulas registradas. - Mapeo Dinámico de Sedes:
handleAddClassroomyhandleClassroomsListahora sincronizan con el catálogo/buildings, ofreciendo la creación guiada de sedes y vinculación dinámica en el alta de aulas físicas. - Blindaje del Fallback Offline: En caso de fallas o demoras en la API, el manejador de captura provee valores predeterminados seguros para
global_virtual_metricsyvirtual_rooms, impidiendo errores 500 no controlados.
- Prevención de Excepciones TypeError: Se corrigieron accesos inseguros a propiedades nulas o no definidas (
[3.1.0] - 2026-09-23
Añadido
- ABM Integral de Ciclos Lectivos (
AcademicTerm):- Gestión End-to-End de Períodos Académicos: Implementación de ciclo de vida completo para ciclos lectivos: Alta, Edición, Establecimiento de Ciclo Actual, Toggle de Habilitación rápida y Eliminación protegida (
DELETE /api/v1/admin/academic-terms/<id>yPOST /api/v1/admin/academic-terms/<id>/toggle). - Integridad Relacional Protegida: Bloqueo de eliminación si el ciclo es el activo corriente, y fallback seguro a desactivación (
is_active = False) si el ciclo tiene comisiones históricas asociadas. - Interfaz Enriquecida en Bedelía / Admin: Botones de acción contextuales, switches y modales interactivos de confirmación (
#modalDeleteTerm) enfrontend/views/admin/academic_terms/list.html.
- Gestión End-to-End de Períodos Académicos: Implementación de ciclo de vida completo para ciclos lectivos: Alta, Edición, Establecimiento de Ciclo Actual, Toggle de Habilitación rápida y Eliminación protegida (
- ABM Completo de Espacios y Aulas (
Classroom):- Control de Estado y Borrado Seguro: Incorporación de toggle activo/inactivo (
POST /api/v1/classrooms/<id>/toggle) y endpoint de baja de aulas integrado con el frontend BFF (/classrooms/toggle_classroomy/classrooms/delete_classroom). - Acciones Rápidas en Vista Lista y Ficha: Botones de edición, alternancia de estado y eliminación con modales de advertencia en las vistas de cuadrícula/tabla (
list.html) y detalle (view.html).
- Control de Estado y Borrado Seguro: Incorporación de toggle activo/inactivo (
- ABM Completo de Reservas (
Reservation):- Eliminación Definitiva (Hard Delete): Soporte en backend para purga física de reservas (
DELETE /api/v1/reservations/<id>?hard=trueyPOST /api/v1/reservations/<id>/delete) complementando el flujo de cancelación lógica (CANCELLED). - Control Operativo en Vista Detalle: Botón de "Eliminar Reserva Definitivamente" con diálogo modal de confirmación en
/schedule/view.html.
- Eliminación Definitiva (Hard Delete): Soporte en backend para purga física de reservas (
- Auditoría y Cobertura 100% de ABMs en la Plataforma:
- Verificación y garantía de operaciones ABM completas en todos los componentes centrales: Sedes/Edificios (
Building), Aulas (Classroom), Ciclos Lectivos (AcademicTerm), Carreras (Career), Materias (Subject), Comisiones (Commission) y Reservas (Reservation).
- Verificación y garantía de operaciones ABM completas en todos los componentes centrales: Sedes/Edificios (
- Circuito Integral y Simplificado de Bedelía:
- Flujo Operativo Ágil para Bedelía:
- Circuito intuitivo de 3 pasos: Catálogo de Aulas (
/classrooms/list_classrooms) -> Creación/Edición con validación física/virtual y aforo real -> Asignación de Comisiones (/schedule/add_reservation). - Botón de acción rápida
Asignar Aula(bi-calendar-plus) en cada fila de/admin/commissions_list, permitiendo asignar espacio y horario a cualquier comisión en 1 solo clic. - Sincronización bidireccional de parámetros por URL (
?commission_id=...y?classroom_id=...) precargando automáticamente en el formulario de reserva la materia, código, cupo máximo de alumnos y enlace virtual de Google Meet / Teams. - Selectores inteligentes en cascada en
/schedule/add.htmlcon autoselección de Edificio, Piso y Aula al navegar desde el catálogo de espacios.
- Circuito intuitivo de 3 pasos: Catálogo de Aulas (
- Conexión REST en Vivo para Reservas:
- Sustitución de listas fijas/mockeadas en
frontend/src/routes/schedule.jspor consulta dinámica a/commissionsen vivo, permitiendo reservar aulas para cualquiera de las comisiones reales de la plataforma.
- Sustitución de listas fijas/mockeadas en
- Soporte Multisede Consistente en Aulas:
- Resolución robusta de
building_idy flagis_virtualenfrontend/src/routes/classrooms.js, eliminando hardcodes y asegurando que las aulas físicas pertenezcan a la sede seleccionada.
- Resolución robusta de
- Flujo Operativo Ágil para Bedelía:
- Inicialización de Base de Datos Limpia sin Datos Demo (
--empty-academic/--no-demo):- Soporte en
install.shy Menú Interactivo: Incorporación de la opciónsudo bash install.sh --empty-academic(o--no-demo) y opción[3]en el menú interactivo para crear la base de datos limpia desde cero, omitiendo la inyección de snapshots con carreras, materias, comisiones, aulas o reservas heredadas. - Inicializador de Esquema
init_db.py: Nuevo flag--empty-academicque genera el esquema de tablas completo, los roles y permisos RBAC, los usuarios institucionales y las tipificaciones de hitos, purgando y omitiendo cualquier edificio, aula física o virtual, carrera, materia, comisión o reserva demo por defecto.
- Soporte en
- Personalización de Interfaz y Saludo en Dashboard (Configuración Global):
- Nueva Pestaña de Interfaz & Dashboard (
/admin/settings): Módulo en el panel de configuración global para personalizar elementos visuales del sistema. - Desactivación Opcional del Saludo y Selector de Rol: Switch interactivo para habilitar o deshabilitar el banner superior
¡Hola, {Usuario}!y el selector de perspectiva de roles endashboard.html. Al deshabilitarlo, el usuario accede directamente a los indicadores y accesos operativos de su rol sin distracciones ni dudas de contexto. - Persistencia y Endpoint REST: Parámetro
dashboard_role_banner_enabledadministrado víaPOST /api/v1/admin/settings/ui, respaldado porSystemSettingy registrado enAuditLog.
- Nueva Pestaña de Interfaz & Dashboard (
Corregido
- Motor de Purga y Reinicio de Datos Académicos:
- Solución al botón inerte de Purga: En
/admin/google_sheets_import, el botón "Ejecutar Purga de Datos Seleccionados" llamaba aopenPurgeModal(), el cual no ejecutaba ninguna acción por ausencia del modal#purgeConfirmModalen el DOM. Se incorporó el modal interactivo completo con desglose dinámico de elementos marcados para borrado, advertencia de preservación de usuarios y estado de carga (spinner). - Integridad Referencial en Purga Backend: En
backend/scripts/reset_academic_data.py, se reordenó la secuencia de borrado para respetar las restricciones de clave foránea (FK):Reservation->MilestoneGrade/AcademicMilestone->CommissionTeacher->StudentEnrollment->Commission->Subject->Career->ClassroomResource/Classroom. Esto previene fallos silenciosos por FK y garantiza que las carreras, asignaturas y comisiones se eliminen de manera limpia cuando son seleccionadas. - Preservación de Usuarios y Roles: La purga garantiza que ningún usuario (
User), contraseña administrativa ni rol (Role) sea alterado o eliminado durante el reseteo académico.
- Solución al botón inerte de Purga: En
- Saneamiento de Métricas y Edición de Edificios:
- Corrección de métricas de edificios en
/buildings/list_buildings: la capacidad virtual (9999) ya no distorsiona el cómputo de bancos físicos ni los percentiles de ocupación institucional. - Formulario de edición de sedes (
/buildings/edit/:id) corregido y persistido adecuadamente.
- Corrección de métricas de edificios en
- Instalador
install.sh:- Inclusión de banderas
--keep-dby--keep-userspara evitar sobreescritura de contraseñas y usuarios en reinstalaciones o actualizaciones.
- Inclusión de banderas
[3.0.0] - 2026-09-23
Añadido
- Fase 5 — Integración Auth, Email & Moodle Backend:
- Épica 1: Panel de Configuración Global (Perfil ADMIN):
- Cifrado simétrico de credenciales y secretos con Fernet (
CryptoServiceenbackend/app/services/crypto_service.py). - Migración y extensión de
SystemSettingcon columnascategoryeis_encrypted, junto con métodos polimórficosget_decrypted_value()yget_masked_value(). - Endpoints REST
/api/v1/admin/settings/*para administración dinámica de parámetros SMTP, toggles de proveedores SSO, Google OAuth y Web Services de Moodle 4.1. - Nueva vista responsiva
frontend/views/admin/settings/global_config.htmlcon soporte optimizado para pantallas 720p, 1360x768 y 1080p, y enlace integrado en el menú de navegación lateral.
- Cifrado simétrico de credenciales y secretos con Fernet (
- Épica 2: Infraestructura Asíncrona y Caché:
- Servicio híbrido de caché
CacheServicecon integración Redis y fallback en memoria/TTL. - Modelo
MoodleSyncTasky procesador asíncronoMoodleQueueServicecon Exponential Backoff y Dead Letter Queue (DLQ). - Métricas en vivo y reintentos manuales individuales y masivos para tareas en DLQ.
- Servicio híbrido de caché
- Épica 3: Autenticación Híbrida (SSO & Local):
- Login nativo como fallback con contingencia para cuentas con rol ADMIN.
- Integración de Google OAuth 2.0 basada en la arquitectura de AlumnosLS con filtrado estricto por dominios institucionales (
google_allowed_domains). - Autenticación delegada contra Moodle 4.1 vía
/login/token.php, mapeo inicial de roles (Admin/Docente/Alumno) y gestión de roles 100% desacoplada en Edu-Space.
- Épica 4: Integración Bidireccional Moodle 4.1:
- Adaptador
MoodleClientcon Web Services de Moodle 4.1 (core_user_*,enrol_manual_*,core_enrol_*,core_role_*). - Encolado no bloqueante de sincronización al crear o editar usuarios en Edu-Space.
- Adaptador
- Épica 5: Motor de Notificaciones (Email Server):
- Cliente SMTP dinámico en
EmailServicecon desencriptación en caliente de contraseñas. - Plantillas HTML transaccionales para asignación de comisiones a profesores, citación a exámenes y pruebas en vivo de conectividad.
- Cliente SMTP dinámico en
- Pruebas y Verificación:
- Suite de integración automatizada
backend/tests/test_phase6_integration.pycon 7 pruebas aprobadas al 100%. Regresión completa de 30 pruebas en verde en los módulos core.
- Suite de integración automatizada
- Épica 1: Panel de Configuración Global (Perfil ADMIN):
[2.8.0] - 2026-09-23
Añadido
- Fase 4 del Roadmap MVP — UI/UX Avanzada para Bedelía & Modo Impersonación:
- Estadio 4.1 — Grilla Semanal Interactiva (Drag-and-Drop) con Detección de Colisiones:
- Activación de arrastre y edición interactiva en FullCalendar (
editable: true,droppable: true,eventDurationEditable: true). - Panel lateral integrado de comisiones sin aula asignada (
unassigned_commissions) con arrastre fluido hacia la grilla semanal o diaria. - Endpoint REST
POST /api/v1/reservations/drag-updatecon validación previa de la matriz integral de conflictos (ReservationService.check_full_conflicts_matrix): colisión física de aula, colisión de horario docente y aforo de estudiantes. - Si existe colisión, retorna HTTP 409 (
status: conflict), revierte automáticamente la posición del evento en la grilla (info.revert()) y notifica al usuario con un Toast detallado del motivo del choque. - Si el espacio está disponible, actualiza o crea la reserva en base de datos, asienta la acción en
AuditLogy muestra confirmación visual de éxito.
- Activación de arrastre y edición interactiva en FullCalendar (
- Estadio 4.2 — Modo Impersonación del Superadmin:
- Soporte completo de cabecera
X-Impersonate-Useren el decorador JWT del Backend Flask (jwt_required) para administradores. - Endpoints administrativos
POST /api/v1/admin/impersonateyPOST /api/v1/admin/stop-impersonatingcon registro estricto enAuditLogbajo las accionesIMPERSONATE_STARTeIMPERSONATE_END. - Inyección contextual de impersonación en el Frontend BFF (
authMiddlewarey proxy transparente/api) mediante cookies segurasimpersonate_user_ideimpersonate_user_data. - Banner de advertencia visual permanente en la barra superior (
base.html) indicando el usuario y rol impersonado, con botón de salida inmediata hacia la sesión del administrador. - Botón de acceso directo para impersonar (
bi-incognito) en cada fila de usuario activo en/admin/users_list.
- Soporte completo de cabecera
- Estadio 4.3 — Acople del Optimizador Genético a Datos y Turnos Reales:
- Algoritmo genético (
ReservationOptimizer) adaptado a las franjas horarias y turnos institucionales reales de UniCABA (Mañana08:00-12:00,Tarde14:00-18:00,Vespertino/Noche18:30-22:30). - Soporte de guardado masivo en base de datos (
POST /api/genetic/apply-optimizationyapply_optimized_reservations) con prevención de solapamientos físicos y conversión estricta de fechas ISO.
- Algoritmo genético (
- Suite de Pruebas Unitarias de Fase 4:
- Archivo
backend/tests/test_phase4_interactive_impersonation.pycon 6 tests unitarios cubriendo los criterios de aceptación: impersonación como docente y estudiante, trazabilidad en auditoría, rechazo de impersonación para usuarios no administradores, finalización de impersonación, drag-update con bloqueo por colisión 409 y drag-update exitoso 200. - Regresión global de 18 tests (Fases 2, 3 y 4) aprobada al 100% (18/18 OK).
- Archivo
- Estadio 4.1 — Grilla Semanal Interactiva (Drag-and-Drop) con Detección de Colisiones:
[2.7.0] - 2026-09-23
Añadido
- Fase 3 del Roadmap MVP — Gestión de Hitos Evaluativos y Libro de Calificaciones (Gradebook):
- Estadio 3.1 — Calendario de Evaluación y Notificaciones Preventivas:
- Modelo relacional
MilestoneGrade(milestone_grades) asociado a estudiantes (User) y reservas de tipo hito (Reservation). - Servicio
GradebookService.get_student_upcoming_milestones: consulta inteligente de exámenes parciales, recuperatorios y entregas de TP de las comisiones en las que el alumno está matriculado. - Endpoint REST
GET /api/v1/students/my-upcoming-milestonescon cálculo de días restantes (days_remaining). - Cartelera y Widget de Próximos Exámenes en el Dashboard del Alumno (
/dashboard?role=alumno) con badges dinámicos de cuenta regresiva (¡Hoy!, ¡Mañana!, Faltan X días).
- Modelo relacional
- Estadio 3.2 — Libro de Calificaciones (Gradebook) y Cierre de Actas:
- Extensiones al modelo
Commission: camposgrades_closed(booleano),grades_closed_at(timestamp),grades_closed_by(ID usuario) yacta_number(código oficial de acta). - Servicio académico
GradebookService(backend/app/services/gradebook_service.py):get_commission_gradebook: matriz bidimensional consolidada de alumnos inscriptos y notas por hito evaluativo.save_single_gradeybulk_save_grades: registro y actualización de calificaciones con validación estricta de escala (1.0 a 10.0), flag de ausente (is_absent) y soporte de retroalimentación pedagógica (feedback).- Bloqueo por inmutabilidad: rechazo de modificaciones cuando el acta se encuentra cerrada.
close_gradebook: sellado oficial del acta con generación de identificador inmutable (ACTA-YYYY-Sem-ID), registro de auditoría enAuditLogy congelamiento de calificaciones.reopen_gradebook: reapertura excepcional para Bedelía/Admin con justificación administrativa obligatoria y registro en auditoría.get_student_grades: consolidado para el alumno de todas sus materias cursadas, notas por evaluación, promedio general y condición académica final (Promocionado, Regular, Libre).
- Endpoints REST de Calificaciones:
GET /api/v1/commissions/<id>/gradebook: estructura completa para la matriz del libro de calificaciones.PUT /api/v1/commissions/<id>/gradebook/grades: guardado masivo o individual de notas vía JSON.POST /api/v1/commissions/<id>/gradebook/close: cierre formal de acta.POST /api/v1/commissions/<id>/gradebook/reopen: reapertura justificada de acta.GET /api/v1/students/my-grades: consulta individual de notas y regularidad del estudiante.
- Interfaz de Usuario y Vistas Frontend BFF:
- Vista
/schedule/gradebook/:id: matriz interactiva con cálculo de promedio en tiempo real en el DOM, asignación de condición en vivo, autoguardado asíncrono debounced (500ms) con indicador flotante de estado (Guardando..., ✓ Todos los cambios guardados), filtro de búsqueda instantánea por alumno/legajo, modal de cierre formal de acta y modal de reapertura. - Vista
/schedule/my_grades(/mis-materias/mis-notas): portal del estudiante para consultar calificaciones por hito, promedios finales, condición de cursada y actas emitidas, con soporte de impresión de certificado de cursada. - Acceso directo integrado al Libro de Calificaciones en la tarjeta de comisión de
/admin/commission_detail. - Acceso directo a "Mis Calificaciones" en el launchpad de navegación del alumno en
/dashboard.
- Vista
- Script de migración de base de datos SQLite
backend/migrate_phase3_fields.py.
- Extensiones al modelo
- Suite de Pruebas Unitarias de Fase 3:
- Archivo
backend/tests/test_phase3_gradebook.pycon 6 tests unitarios cubriendo los criterios de aceptación de Fase 3: estructura de matriz, autoguardado de notas, validaciones de rango numérico, cierre formal de acta e inmutabilidad, consulta individual de notas y cuenta regresiva de próximos exámenes. 100% de tests aprobados (12/12 en suite global Fase 2 + Fase 3).
- Archivo
- Estadio 3.1 — Calendario de Evaluación y Notificaciones Preventivas:
[2.6.1] - 2026-09-23
Modificado
- Optimización de Espacio Vertical y Compatibilidad de Pantallas (720p / 1360x768 y 1080p):
- Navbar Compacta: Reducción de altura a 46px eliminando desperdicio de espacio superior para maximizar el área visible de trabajo de Bedelía.
- Botón de Toggle de Sidebar: Reingeniería visual del botón de alternancia del menú lateral con diseño circular limpio, micro-animación en hover y centrado perfecto.
- Soporte Multipantalla: Media queries CSS especializadas para resoluciones compactas habituales en puestos de trabajo de administración y bedelía argentina (1360x768 / 1366x768) y escalado equilibrado a 1920x1080 Full HD.
- Densidad de Información: Espaciados y márgenes optimizados para evitar scrolling innecesario en formularios y catálogos de comisiones y aulas.
[2.6.0] - 2026-09-19
Añadido
- Fase 2 del Roadmap MVP — Co-docencia, Matriz de Conflictos y Regla Diaria:
- Estadio 2.1 — Modelo y Gestión Integral de Co-docencia:
- Modelo relacional
CommissionTeacher(commission_teachers) con roles de cátedra (Titular,Adjunto,JTP,Ayudante) y flags de docente principal. - Endpoints REST de cátedra:
POST /api/v1/commissions/<id>/teachersyDELETE /api/v1/commissions/<id>/teachers/<user_id>con control de duplicados y asignación dinámica. - Integración visual en el detalle de la comisión (
/admin/commission_detail) con tarjeta interactiva para vincular/desvincular integrantes del equipo docente y badges de rol en la grilla general (/admin/commissions_list).
- Modelo relacional
- Estadio 2.2 — Matriz de Conflictos y Validación Integral:
- Conflicto Físico Estricto: Bloqueo estricto de superposición horaria en la misma aula física (
ReservationRepository.find_overlapping&check_physical_conflicts). - Conflicto Docente Inteligente: Detección de doble reserva simultánea para un mismo profesor (
ReservationRepository.find_teacher_conflicts&check_teacher_conflicts). - Excepción Justificada por Co-docencia: Si un docente asignado presenta solapamiento pero la comisión cuenta con co-docentes registrados en
CommissionTeacher, el motor de conflictos autoriza la reserva validando la cobertura del equipo de cátedra. - Conflicto de Aforo: Bloqueo estricto cuando la cantidad de asistentes esperados (
expected_attendees) excede la capacidad física declarada del aula (classroom.capacity). - Endpoint unificado
POST /api/v1/reservations/check-conflictspara pre-validación asíncrona de conflictos físicos, docentes y de capacidad antes del guardado.
- Conflicto Físico Estricto: Bloqueo estricto de superposición horaria en la misma aula física (
- Estadio 2.3 — Regla de Restricción Diaria del Alumno y Motor de Excepciones:
- Servicio académico
EnrollmentService(backend/app/services/enrollment_service.py) para control de cupos, inscripciones activas y análisis de días de cursada. - Regla Diaria: Un alumno no puede matricularse en dos materias regulares programadas para el mismo día de la semana.
- Excepción Automática por Curso Corto: Indicador
is_short_courseen modeloSubject; si una de las asignaturas es un taller, seminario o curso corto, el sistema autoriza automáticamente la cursada simultánea en el mismo día. - Excepción Expresa de Bedelía: Parámetros
allow_same_day_exceptionyexception_reasonen el modeloStudentEnrollment, permitiendo a Bedelía inscribir alumnos con justificación administrativa expresa (cambio de plan, equivalencias, etc.). - Endpoints de gestión de matrículas por comisión:
GET /api/v1/commissions/<id>/enrollments,POST /api/v1/commissions/<id>/enrollments,DELETE /api/v1/commissions/<id>/enrollments/<student_id>yPUT /api/v1/commissions/<id>/enrollments/<student_id>. - Adaptación completa de UI en
/admin/commission_detailcon selector de estudiantes, toggle interactivo de excepción de Bedelía, campo de motivo justificado, y tabla de estudiantes matriculados con badges de excepción.
- Servicio académico
- Suite de Pruebas Unitarias e Integrales de Reglas de Negocio:
- Archivo
backend/tests/test_phase2_rules.pycon 6 tests completos verificando: bloqueo físico, conflicto de aforo, detección docente con bypass de co-docencia, restricción diaria de cursada, excepción por curso corto y excepción por autorización manual de Bedelía. 100% de tests aprobados.
- Archivo
- Mejoras UI/UX en Dashboard de Bedelía:
- Paneles interactivos para visualizar Comisiones Sin Reserva de Aula y Aulas Disponibles con soporte de filtrado temporal (Semana/Mes) directamente consumiendo estadísticas en tiempo real del motor backend.
- Fase 1: Auditoría y Seguridad Automatizada:
- Control de Entorno Dev: Aislamiento de herramientas de seguridad en
requirements-dev.txt. - Automatización Local e Integración Continua: Correcciones de evaluación en
security_audit.batpara Windows y actualización de.gitea/workflows/security-audit.yamlpara asegurar la correcta ejecución del stack de auditoría (Bandit, pip-audit, njsscan y Schemathesis).
- Control de Entorno Dev: Aislamiento de herramientas de seguridad en
- Estadio 2.1 — Modelo y Gestión Integral de Co-docencia:
[2.5.0] - 2026-09-19
Añadido
- Auditoría y Seguridad Automatizada Completa (Python & Node.js):
- Python SAST (
bandit): Escaneo estático del backend Flask de más de 8.400 líneas. Corrección de vulnerabilidad B310 ensheets_importer.pymediante validación estricta de esquema HTTP/HTTPS para prevenir ataques de tipo SSRF. Resultado: 0 fallos detectados. - Python SCA (
pip-audit): Análisis de dependencias con base OSV; detección de 24 CVEs históricas en paquetes desactualizados y actualización completa a versiones seguras (Flask>=3.1.3,Werkzeug>=3.1.8,requests>=2.34.2,bleach>=6.4.0,python-dotenv>=1.2.3). Resultado: 0 CVEs activas. - Python DAST / Fuzzing (
schemathesis): Especificación OpenAPI 3.0.3 enbackend/app/routes/api/openapi.py(/api/v1/openapi.json). Ejecución de 114 casos de prueba dinámicos con mutación de datos. Detección y corrección de caída 500 por payload de tipo JSON inválido en/auth/login. Resultado: 114/114 pruebas aprobadas con 0 errores de servidor. - Node.js SAST (
njsscan): Análisis de patrones de código inseguro en el BFF Express (frontend/src). Resultado: 0 hallazgos. - Node.js SCA (
npm audit): Auditoría continua de paquetes npm con 0 vulnerabilidades reportadas. - Blindaje Activo (
helmet&express-rate-limit): Incorporación de cabeceras HTTP defensivas (HSTS,nosniff,SAMEORIGIN,X-Permitted-Cross-Domain-Policies) y limitadores de tasa ante fuerza bruta en/auth/login(30 req / 15 min) y/api(180 req / min). - Script Unificado de Auditoría (
security_audit.bat): Ejecutable centralizado para correr los 5 controles en un solo comando. - Documento Formal de Seguridad (
SECURITY_AUDIT_REPORT.md): Reporte ejecutivo de auditoría y controles continuos.
- Python SAST (
[2.4.0] - 2026-09-19
Añadido
- Perfil Extendido de Usuarios y Tipificaciones de Documentos Oficiales (Argentina y Extranjeros):
- Incorporación en el modelo
Userde los campos:first_name(Nombre),last_name(Apellido),email(Email Institucional de acceso),personal_email(Email Personal/Particular de contacto),phone(Teléfono con código de área),address(Domicilio/Dirección),document_type(Tipo de documento) ydocument_number(Número de documento validado). - Catálogo formal de reglas de negocio en
backend/app/constants/document_types.pycon tipificaciones oficiales de Argentina y extranjeros (DNI, CUIL, Pasaporte Argentino, Pasaporte Extranjero, DNI Extranjero, Cédula de Identidad PFA, Cédula Mercosur, Libreta Cívica y Libreta de Enrolamiento). - Validaciones de formato, expresiones regulares, y verificación de unicidad de documento por tipo en endpoints
POST /api/v1/usersyPUT /api/v1/users/<id>. - Búsqueda dinámica en
/admin/users_listhabilitada para filtrar por número de documento o email personal/institucional además de nombre. - Rediseño del formulario
/admin/users/formestructurado en secciones: Identidad y Documentación, Contacto y Domicilio (con Teléfono, Email Personal y Dirección), y Cuenta y Rol Institucional (con Email Institucional y Clave), permitiendo al Administrador General gestionar la totalidad de los datos. - Script de migración SQLite
backend/migrate_user_profile_fields.pypara agregar las columnas e inicializar nombres desglosados de los usuarios existentes.
- Incorporación en el modelo
- Co-Docencia y Cátedras Múltiples en Comisiones:
- Creación del modelo relacional
CommissionTeacher(commission_teachers) para asociar múltiples docentes a una misma comisión con roles académicos diferenciados (Titular,Adjunto,JTP,Ayudante). - Nuevos endpoints en la API REST:
POST /api/v1/commissions/<id>/teachersyDELETE /api/v1/commissions/<id>/teachers/<user_id>, junto con la serialización completa de cátedras enGET /api/v1/commissions. - Nueva tarjeta interactiva "Equipo Docente / Cátedra" en el detalle de la comisión (
/admin/commission_detail?id=...) permitiendo agregar y desvincular docentes con sus respectivos roles. - Actualización de la grilla de comisiones (
/admin/commissions_list) para exhibir a todos los profesores asignados con badges distintivos de rol.
- Creación del modelo relacional
- Eliminación y Gestión Segura de Asignaturas:
- Incorporación de botón y modal interactivo de confirmación de eliminación de asignaturas en
/admin/subjects_list. - Implementación de regla de negocio de integridad académica: eliminación física si la materia no tiene comisiones asociadas, o desactivación automática si posee historial o cursadas vinculadas.
- Incorporación de botón y modal interactivo de confirmación de eliminación de asignaturas en
Corregido
- Bug Visual en Modificación de Asignaturas (
/admin/subjects_list):- Solucionado el problema de modales recortados o cubiertos por el fondo oscuro (
modal-backdrop), originado por la presencia de 206 modales inline dentro de celdas<td>en una tabla conoverflow(.table-responsive). Se refactorizó hacia un único modal global#modalEditSubjectinstanciado fuera de la tabla e inicializado dinámicamente con JavaScript.
- Solucionado el problema de modales recortados o cubiertos por el fondo oscuro (
Añadido
- Monitoreo y Percentiles de Asignación de Aulas Físicas (Admin & Bedelía):
- Panel analítico "Estado y Percentiles de Asignación de Aulas Físicas" incorporado en los dashboards de Administrador (
/dashboard?role=admin) y Bedelía (/dashboard?role=bedelia). - Cálculo dinámico en tiempo real de Aulas Asignadas en número y percentil (26 aulas · 96.3%) con enlace directo a cursadas activas.
- Cálculo dinámico en tiempo real de Aulas Sin Asignar / Libres en número y percentil (1 aula · 3.7%) con enlace directo al formulario de asignación de espacios.
- Barras de progreso visuales con desglose dual: Planificación Cuatrimestral (96.3% asignado vs 3.7% disponible) y Ocupación Operativa del Día (aulas con clases hoy vs aulas libres).
- Exposición de métricas de asignación y percentiles en el endpoint de la API REST
GET /api/v1/dashboard/stats.
- Panel analítico "Estado y Percentiles de Asignación de Aulas Físicas" incorporado en los dashboards de Administrador (
- Módulo de Cursadas Asignadas y Métricas Reales en Catálogo Presencial (
/classrooms/list_classrooms?view_mode=physical):- Incorporación de la sección "Cursadas Asignadas" dentro de cada tarjeta de aula física y columna en vista de tabla, detallando asignaturas, comisiones y turnos.
- Métricas de ocupación física real por período (Día, Semana, Mes) con porcentajes calculados dinámicamente (6%, 11%, 17%, 22% según la carga horaria del aula).
- Botones de acción directa con ID dinámico: Ficha (
/classrooms/view_classroom?id=...), Horarios en Calendario (/schedule/calendar_view?classroom_id=...) y Editar. - Conexión de la tabla "Próximas Clases y Reservas" en la ficha individual del aula (
/classrooms/view_classroom) con las reservas reales del cuatrimestre y enlaces a cada reserva (/schedule/view_reservation?id=...).
Modificado
- Dashboard Docente (
/dashboard?role=docente):- Eliminado el botón flotante "Reservar Aula / Solicitar espacio para clase" (
/schedule/add_reservation) a petición de los requerimientos funcionales del cuerpo docente. - Reorganizada la grilla superior a 3 columnas simétricas (
col-md-4) para las tarjetas de Mis Clases Hoy, Mis Reservas Activas y Aulas Virtuales.
- Eliminado el botón flotante "Reservar Aula / Solicitar espacio para clase" (
Corregido
- Fallo Crítico de Renderizado en Nunjucks (
memberLookupcon.items):- Solucionada la incompatibilidad de
nunjucks/src/jinja-compatque interceptaba la propiedad.itemsconvirtiendoclassrooms.itemsen una función interna en lugar de un array, lo que impedía dibujar las tarjetas de aulas presenciales enfrontend/views/classrooms/list.html. - Implementado interceptor en
memberLookupenfrontend/src/app.jspara preservar arrays intactos.
- Solucionada la incompatibilidad de
- Clasificación Errónea de Reservas Físicas como Virtuales (
is_virtual):- Corregida la propiedad
@property is_virtualenReservation(backend/app/models/reservation.py) para garantizar que si una reserva tiene aula física asignada (self.classroom and not self.classroom.is_virtual), siempre sea clasificada como presencial (is_virtual = False), evitando falsos positivos cuando la comisión posee un enlace virtual predeterminado.
- Corregida la propiedad
- Excepción de SQLAlchemy en Estadísticas de Dashboard:
- Corregido el error de ejecución generado al invocar
.ilike()sobre la propiedad Python@property Classroom.room_numberenbackend/app/routes/api/dashboard.py, migrando la clasificación de aulas presenciales y virtuales a una evaluación robusta en memoria Python (Classroom.codeyClassroom.building).
- Corregido el error de ejecución generado al invocar
[2.2.0] - 2026-09-19
Añadido
- Herramienta de Purga y Reinicio de Datos Académicos (
reset_academic_data):- Script CLI
backend/scripts/reset_academic_data.pycon argumentos de limpieza granular (--all,--reservations,--classrooms,--careers,--yes). - Endpoint de API
POST /api/v1/admin/reset-academic-dataprotegido por JWT (roladmin) con registro enAuditLog. - Panel interactivo "Zona de Reinicio y Purga Académica" en
/admin/google_sheets_importcon checkboxes independientes para reservas, aulas, comisiones, asignaturas y carreras. - Modal modal de confirmación con advertencias de seguridad para prevenir purgas accidentales.
- Preservación íntegra de usuarios del sistema, credenciales de acceso, roles RBAC y registros de auditoría.
- Script CLI
- Configuración Global Dinámica de Google Sheets:
- Nuevo modelo
SystemSetting(backend/app/models/setting.py) para almacenamiento persistente clave-valor en base de datos. - Endpoints
GET /api/v1/admin/sheets-configyPOST /api/v1/admin/sheets-config. - Normalizador de enlaces en
GoogleSheetsImportercompatible con URLs compartidas de edición (/spreadsheets/d/.../edit) o enlaces publicados (/pub?output=csv). - Interfaz web con formulario de edición de URL, botón de guardado en caliente, restauración a URL oficial predeterminada y acceso directo a Google Docs.
- Nuevo modelo
- Visualización de Asignaturas Reales:
- Tabla de asignaturas recientemente sincronizadas conectada a la base de datos real en lugar de datos de muestra (mock).
Corregido
- Fallo por Timeout en Google Sheets Academic Sync:
- Solucionado el corte prematuro de conexión en el BFF (
frontend/src/services/apiClient.js), aumentando el timeout base a 25s y el timeout específico de sincronización a 90s (anteriormente limitado a 5s en operaciones que toman ~6.7s). - Eliminado el enmascaramiento silencioso de errores en el BFF, permitiendo reportar fallos reales o éxitos detallados (+carreras, +aulas, +materias, +comisiones, +reservas).
- Solucionado el corte prematuro de conexión en el BFF (
[2.1.0] - 2026-09-19
Añadido
- Ficha Detallada de Reserva (
schedule.view_reservation):- Implementación en BFF Node.js de la ruta
/schedule/view_reservation(soportando parámetros:id,?id=o selección automática del primer registro). - Vistas y controladores para modificar reservas con selectores en cascada (
/schedule/edit_reservation). - Endpoints de acción rápida en backend y BFF:
POST /schedule/confirm_reservationyPOST /schedule/cancel_reservation. - Actualización de enlaces en
today.html,list.html,dashboard.htmlyview.htmlpara navegar directamente con el identificador de la reserva (?id=...).
- Implementación en BFF Node.js de la ruta
- Creación y Asociación de Comisiones a Asignaturas (
admin/commissions_list):- Botón destacado
+ Nueva Comisiónen el encabezado y en el estado vacío de la tabla. - Modal interactivo
#modalAddCommissioncon selección obligatoria y clara de la Asignatura / Materia Asociada (<select name="subject_id" required>), mostrando código oficial, nombre y carrera. - Campos completos de cursada: cuatrimestre (1C/2C/Anual), año lectivo, turno, docente a cargo, cupo máximo y días/horarios.
- Generación y configuración automática de enlace a Google Meet institucional cuando no se ingresa un enlace personalizado.
- Alerta de confirmación visual (
?created=1) al registrar y vincular una comisión exitosamente. - Tabla de comisiones actualizada con visualización explícita del código de materia, nombre y badge de carrera.
- Botón destacado
- Enriquecimiento de la API REST:
- Endpoint
GET /api/v1/reservations/<id>ampliado con objetos relacionales anidados:classroom(código, edificio, piso, capacidad, descripción, virtualidad),commission(código, código compuesto, materia),user(docente, nombre, apellido, correo), duración en minutos y enlaces virtuales. - Endpoint
POST /api/v1/admin/commissionscon validación estricta de existencia de asignatura y resolución inteligente de unicidad.
- Endpoint
[2.0.0] - 2026-09-18
Añadido
- Reingeniería de Arquitectura Fullstack (Desacople Monolito -> Backend + BFF):
- Desacople completo del backend Python/Flask como una API REST pura bajo
/api/v1/retornando exclusivamente JSON. - Implementación del Frontend BFF en Node.js + Express con renderizado de servidor mediante Nunjucks.
- Autenticación sin estado (Stateless) basada en tokens JWT firmados con algoritmo HS256.
- Almacenamiento seguro del token de acceso en cookies del navegador con directivas
HttpOnly,SameSite=LaxySecure. - Inyección transparente del token
Beareren peticiones internas mediante cliente Axios centralizado.
- Desacople completo del backend Python/Flask como una API REST pura bajo
- Dashboards Personalizados por Rol Institucional:
- Dashboard de Bedelía (
/dashboard?role=bedelia): Métricas operativas de campus físico y virtual, cartelera del día y panel de aprobación de solicitudes pendientes. - Dashboard de Docente (
/dashboard?role=docente): Sesiones del día con botones directos para ingresar a reuniones virtuales (Meet/Teams/Zoom) y formulario de solicitud de aulas. - Dashboard de Alumno (
/dashboard?role=alumno): Brújula de cursada "¿Dónde curso hoy?" con ubicación por piso/aula o enlace virtual, junto al calendario de exámenes y entregas. - Dashboard de Administrador (
/dashboard?role=admin): Cockpit institucional de capacidad, usuarios, auditoría RBAC y distribución de comisiones. - Selector dinámico de vista previa de roles en el banner superior para administradores.
- Dashboard de Bedelía (
- Cartelera del Día Interactiva (
/schedule/today_schedule):- Grilla estructurada en bloques horarios (07:00 a 21:00 hs) con métricas en tiempo real de ocupación y reservas confirmadas/pendientes.
- Filtro dinámico para ocultar clases virtuales (
hide_virtual=1) y segmentación por pisos o turnos.
- Seguridad Enterprise (SecurityFilterChain):
- Pipeline centralizado de cabeceras de blindaje OWASP (
nosniff,SAMEORIGIN,X-XSS-Protection,Strict-Transport-Security). - Rate limiting dinámico contra ataques de fuerza bruta en endpoints de autenticación.
- Pipeline centralizado de cabeceras de blindaje OWASP (
Corregido
- Resolución de Colisión de Horarios en Clases Virtuales (Importador de Google Sheets):
- Corrección de la búsqueda de duplicados en
sheets_importer.pyque limitaba indebidamente la unicidad a(classroom_id, start_time, end_time). - Habilitación de concurrencia ilimitada para el aula virtual (
Campus Virtual · VIRTUAL) mediante discriminación porcommission_id. - El total de reservas registradas aumentó de 363 a 643 (incorporando 280 clases virtuales que eran descartadas por falso conflicto).
- Generación y guardado automático de enlaces institucionales de Google Meet (
https://meet.google.com/edu-{materia}-{comision}).
- Corrección de la búsqueda de duplicados en
[1.0.0] - 2026-09-04
Añadido
- Versión Monolítica Base (
legacy_admin-edu-space):- Aplicación monolítica en Flask con plantillas Jinja2 y persistencia SQLAlchemy (SQLite / PostgreSQL).
- Modelado de datos inicial para sedes, aulas físicas, materias, comisiones, usuarios y reservas.
- Sistema de roles inicial (Admin, Bedelía, Docente, Alumno) basado en sesión tradicional de Flask-Login.
- Calendario de reservas mensual y semanal con FullCalendar.
- Prototipo experimental de algoritmo genético para optimización de ocupación áulica.
- Módulo de sincronización inicial con planillas de Google Sheets.