107 KiB
107 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 FastAPI (Uvicorn), 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.8.16] - 2026-10-26
Fixed
- Restauración y UX Nativa del Menú en Dispositivos Celulares / Móviles:
- Corregida la visibilidad de
.mobile-headeren pantallas menores a 992px resolviendo el conflicto de especificidad entre@mediay reglas globales, restaurando el acceso al menú de navegación (#mobileMenuBtn) en celulares. - Implementado backdrop interactivo con desenfoque (
.sidebar-backdrop) y cierre automático del menú al tocar el fondo o pulsar cualquier enlace de navegación. - Ocultación total blindada del sidebar fuera de pantalla en móvil (
left: -290pxconwidth: 280pxyoverflow-x: hidden !important).
- Corregida la visibilidad de
- Visibilidad Completa de Opciones de Sesión en Modo Colapsado:
- Reemplazada la clase
.sidebar-submenupor.user-menu-listen el menú de usuario, eliminando el ocultamiento accidental (display: none !important) en modo colapsado y asegurando que las opciones "Mi Perfil", "Cambiar Contraseña" y "Cerrar Sesión" permanezcan 100% visibles e interactivas. - Coordinada la apertura del menú de usuario con el cierre de otros flyouts para prevenir superposiciones.
- Reemplazada la clase
- Corrección de Desborde y Superposición del Badge de Versión:
- Reestructurado el indicador de versión en un badge vertical compacto con
text-truncateen el sidebar (v3.8.16en píldora y desglose secundario en línea inferior), eliminando el desborde horizontal de más de 400px que sobresalía y se superponía con elementos de la interfaz.
- Reestructurado el indicador de versión en un badge vertical compacto con
- Resolución de Error 404 en
/api/user/theme:- Creado endpoint dedicado
app.post(['/api/user/theme', '/theme'])en Express BFF para atender la persistencia rápida de tema visual de usuario por AJAX, sincronizando transparentemente con FastAPI sin arrojar errores en la consola del navegador.
- Creado endpoint dedicado
[3.8.15] - 2026-10-26
Added
- Diseño Ergonómico de Footer y Menú de Usuario (Sidebar & Flyout):
- Reubicado el botón de cambio de tema (
.theme-toggle-btn) en el pie de la barra lateral (sidebar-footer), situado directamente sobre el botón de perfil del usuario con botón completo interactivo en modo expandido e icono centrado de 44x44px en modo colapsado. - Rediseñado el menú desplegable de usuario para coincidir con la interacción, elegancia y estética prolija de los demás submenús flyout (
.flyout-header, subtítulo con rol/email, enlaces con iconos institucionales y hover suave). - En modo colapsado, el menú de usuario se despliega como un flyout lateral flotante hacia la derecha sin colisionar ni recortarse con el límite inferior de la pantalla.
- Implementado ajuste dinámico de posición vertical (
adjustFlyoutPosition) ymax-height: calc(100vh - 24px); overflow-y: auto;para garantizar cero recortes de elementos en pantallas reducidas (1366x768 / 1280x720).
- Reubicado el botón de cambio de tema (
Fixed
- Ocultación Total de Cabecera Móvil en Escritorio (
.mobile-header):- Restringida la barra
.mobile-headerexclusivamente a pantallas< 992pxmedianted-lg-noneydisplay: none !important;en CSS, eliminando la interferencia visual y de espacio que afectaba la UI y UX en vista desktop.
- Restringida la barra
- Cero Diagnósticos en Pyright / SQLAlchemy (
reservation_repository.py):- Corregida la condición
only_virtualreemplazando llamadas a propiedades Python por expresiones nativas SQLAlchemy ColumnElement (and_(Reservation.virtual_link.is_not(None), Reservation.virtual_link != ''),Classroom.code.ilike('%VIRTUAL%'), etc.), resolviendo al 100% los errores de@[current_problems].
- Corregida la condición
- Auditoría de Seguridad y SAST / SCA / DAST (
security_audit.bat):- Actualizado
security_audit.batpara escanearbackend\routersjunto conbackend\appen Bandit y consultar la ruta OpenAPI/openapi.jsonde FastAPI. - Resueltas vulnerabilidades transitivas de npm mediante
npm audit fix(0 vulnerabilidades). - Suite de seguridad 100% aprobada (
SECURITY AUDIT SUITE COMPLETED SUCCESSFULLY [PASS]).
- Actualizado
- Balance de Etiquetas HTML en Vistas:
- Reparado el cierre de contenedor en
classrooms/view.htmly de tarjeta/cabecera enschedule/today.html, logrando un balance perfecto de 52/52 plantillas sin discrepancias (diff=0).
- Reparado el cierre de contenedor en
[3.8.14] - 2026-10-26
Added
- Filtrado Temporal y Resiliente en Listado de Reservas (
/schedule/list_reservations):- Incorporado soporte de parámetros
scope(month,week,today) yonly_virtualen el backend FastAPI (routers/reservations.py,ReservationService,ReservationRepository). - Al pulsar "Sesiones del Mes" en la vista de aulas virtuales (
/classrooms/list_classrooms?view_mode=virtual), el frontend BFF precarga las fechas de inicio (YYYY-MM-01) y fin de mes en los inputs del formulario y activa el switch "Solo Aulas Virtuales", desplegando de inmediato las 24 sesiones virtuales programadas del mes. - Añadido switch explícito "Solo Aulas Virtuales" y banner de filtro activo contextual en
schedule/list.html.
- Incorporado soporte de parámetros
- Desglose Claro de Espacios Áulicos (Físicas vs Virtuales):
- En el Dashboard (
dashadm.html), la tarjeta KPI de Aulas ahora desglosa con total transparencia los espacios: 3 físicas en Edificio Central y 19 virtuales a demanda del Campus Virtual, con accesos directos independientes a cada catálogo. - En la vista de aulas (
/classrooms/list_classrooms), la vista presencial muestra "3 aulas presenciales encontradas" y la vista virtual indica "19 salas virtuales a demanda encontradas", clarificando los badges en las pestañas superiores.
- En el Dashboard (
- Persistencia y UX del Menú Lateral (Sidebar):
- Removido el colapso forzado (
data-bs-parent="#sidebarNav"). Al interactuar con un submenú, este permanece desplegado. - Implementada apertura automática del submenú correspondiente según la URL activa y persistencia de submenús abiertos en
localStorage(edu_sidebar_open_menus).
- Removido el colapso forzado (
Fixed
- Contraste de Tarjeta KPI de Administradores (
/admin/users_list):- Implementadas clases de estilo dedicadas en modo oscuro y claro (
.kpi-number-admin,.kpi-badge-admin,.kpi-icon-admin) con contraste institucional púrpura de alta legibilidad.
- Implementadas clases de estilo dedicadas en modo oscuro y claro (
- Reubicación Ergonómica del Botón de Modo Oscuro / Claro:
- Retirado el botón de cambio de tema de las pantallas de autenticación (
login.htmlyadmin_login.html). - Reubicado de forma ergonómica en el encabezado de la barra lateral (
sidebar-header) junto al toggle de colapso, y en la cabecera móvil (mobile-header).
- Retirado el botón de cambio de tema de las pantallas de autenticación (
- Internacionalización y Textos en Español:
- Mapeo de roles en backend y frontend para mostrar consistentemente
Administradoren lugar deAdminoSystem Administrator. - Traducido "Classroom Management System" por "Sistema de Gestión de Espacios Áulicos" y textos residuales en inglés.
- Mapeo de roles en backend y frontend para mostrar consistentemente
- Balance de Estructura HTML:
- Sincronizados y verificados al 100% los tags
<div>en todas las plantillas del frontend, garantizando cero desbordes de contenedor.
- Sincronizados y verificados al 100% los tags
[3.8.13] - 2026-10-26
Added
- Métricas y Contadores Rápidos de Usuarios por Rol (
/admin/users_list):- Incorporadas tarjetas KPI interactivas en la cabecera de la vista de usuarios: Total global de usuarios registrados, Administradores, Bedelía, Docentes y Alumnos matriculados, con estados activos e inactivos.
- Al hacer clic en cualquiera de las tarjetas de rol, se filtra instantáneamente el padrón por dicho rol institucional.
- Añadida barra de paginación superior en la cabecera de la tabla mostrando el rango exacto de usuarios renderizados (
Página X de Y · Mostrando Z de N usuarios) y controles rápidos de navegación previa y siguiente.
- Filtro Resiliente por Rol en Backend FastAPI:
get_usersen/api/v1/admin/usersahora aceptaroletanto numérico (ID de rol) como textual (ej.Docente,Alumno,Admin), insensible a mayúsculas, y retornarole_countsestructurado con la distribución total institucional.
Fixed
- Limpieza de Diagnósticos de Tipos en Pyright:
- Removidas llamadas redundantes a
str()sobre parámetros ya tipados como cadenas enacademic.py,classrooms.pyyreservations.py, asegurando 0 errores y 0 advertencias en el Language Server.
- Removidas llamadas redundantes a
[3.8.12] - 2026-10-26
Fixed
- Dashboard Layout y Estructura Visual (
frontend/views/dashboard/dashadm.html):- Removidos 3 tags
</div>de cierre prematuro en la sección de balance de aulas físicas que expulsaban los módulos de gestión, los menús visuales y el gráfico de tendencia de ocupación fuera del contenedor principal hacia el fondo de la página, restableciendo la UI y UX original.
- Removidos 3 tags
- Resiliencia en Filtrado y Paginación de Asignaturas y Comisiones (
/admin/subjects_listy/admin/commissions_list):- Solucionado el error HTTP 422 Unprocessable Entity en FastAPI provocado cuando el frontend o los formularios enviaban parámetros vacíos (
career_id=&active=&search=). Ahora los endpoints/api/v1/subjectsy/api/v1/commissionsaceptanOptional[str]y realizan un parsing seguro a enteros, permitiendo renderizar correctamente las 22 asignaturas y 22 comisiones registradas. - Enriquecido el BFF de Express (
frontend/src/routes/admin.js) depurando el objetoparamspara no enviar claves vacías a la API.
- Solucionado el error HTTP 422 Unprocessable Entity en FastAPI provocado cuando el frontend o los formularios enviaban parámetros vacíos (
- Paginación y Optimización de Base de Datos en Vistas Masivas (Spec 008):
- Implementada paginación server-side con metadatos estructurados en
/api/v1/admin/users,/api/v1/audit-logs,/api/v1/subjectsy/api/v1/commissions. - Añadido endpoint
/api/v1/users/teacherspara selectores de docentes sin transferir la lista de miles de usuarios. - Corregida la consulta SQL relacional en
ReservationRepositoryutilizandonot_(Classroom.code.ilike('%VIRTUAL%'))yClassroom.id.is_(None)para el filtrado seguro de aulas virtuales. - Creada suite de pruebas unitarias y de integración
backend/tests/test_pagination_db.py(6 passed).
- Implementada paginación server-side con metadatos estructurados en
[3.8.11] - 2026-10-26
Fixed
- Exclusión de Reservas Pasadas en Fichas y Tarjetas de Aulas (
view_classroomylist_classrooms):- En la ficha del aula (
/classrooms/view_classroom), se separaron estrictamente las reservas próximas vigentes (upcoming_reservations) de las ya concluidas (past_reservations). Las clases cuya fecha u hora ya pasó (como las del 21/10/2026) ya no aparecen en "Próximas Clases y Reservas", mostrando el empty state correspondiente e incorporando una sección colapsable de historial de clases finalizadas. - En las tarjetas del catálogo de aulas (
/classrooms/list_classrooms), se calculan lasassigned_commissionsytotal_classesexclusivamente a partir de reservas activas/vigentes de hoy en adelante, evitando que reservas finalizadas continúen figurando como cursadas activas del aula. - En el modal de vista previa de salas virtuales, se preformatearon las fechas y horarios de sesiones, indicando con badge "Finalizada" las sesiones pertenecientes a fechas pasadas.
- En la ficha del aula (
[3.8.10] - 2026-10-26
Fixed
- Sincronización y Consistencia de Salas Virtuales y Aulas (
/classroomsvs/dashboard):- Resuelta la discrepancia visual donde el Dashboard reportaba 19 salas virtuales mientras que la vista de Aulas (
/classrooms) reportaba solo 1 sala activa y mostraba el catálogo de Campus Virtual vacío. - Implementado el endpoint unificado
GET /api/v1/classrooms/virtual-roomsen FastAPI que consolida las salas virtuales operativas del Campus Virtual, sus comisiones asociadas, enlaces de videollamada y métricas de clases por período. - Enriquecido
DashboardService.get_stats()conreservationsserializadas y campos normalizados (commission_code,day_count,week_count,month_count,total_count) para compatibilidad directa con los modales de vista previa y edición enlist.html. - Reemplazadas fechas estáticas congeladas de septiembre de 2026 en
frontend/src/routes/classrooms.jspor cómputo dinámico (new Date(), día ISO, semana ISO de lunes a domingo y mes en curso), expandiendo además la consulta de reservas a un rango cuatrimestral amplio.
- Resuelta la discrepancia visual donde el Dashboard reportaba 19 salas virtuales mientras que la vista de Aulas (
[3.8.9] - 2026-10-23
Added
- Endpoints de Heurística y Optimización Genética en Backend FastAPI (
/api/genetic):- Implementado
POST /api/genetic/preview-optimization: previsualiza asignaciones estimadas, puntaje de fitness y posibles conflictos para las comisiones seleccionadas. - Implementado
POST /api/genetic/optimize: ejecuta el ciclo evolutivo completo del algoritmo genético y retorna el cronograma de reservas generado. - Implementado
POST /api/genetic/apply-optimization: persiste y confirma las reservas en la base de datos de Bedelía con detección de colisiones físicas de aulas y compatibilidad horaria UTC. - Creados esquemas Pydantic DTO con validación fuerte (
GeneticPreviewRequestDTO,GeneticOptimizeRequestDTO,GeneticApplyRequestDTO) enbackend/app/schemas/optimizer_dto.py.
- Implementado
Fixed
- Enrutamiento y Proxy Inverso en Frontend BFF (
frontend/src/app.js):- Configurado middleware proxy transparente para
/api/genetichacia el backend FastAPI (:5000/api/genetic), inyectando token JWT Bearer desde las cookies de sesión y resolviendo el error 404 (Not Found) en la consola del navegador al previsualizar o aplicar optimizaciones. - Normalizadas fechas
start_timeyend_timea formato naive UTC para evitar discrepancias de comparación en SQLite/PostgreSQL.
- Configurado middleware proxy transparente para
[3.8.8] - 2026-10-23
Fixed
- Resolución de Error de Renderizado en Plantillas Nunjucks (
Block "extra_css" defined more than once):- Eliminada la definición redundante de
{% block extra_css %}en la línea 32 defrontend/views/base.html, preservando la definición canónica en la línea 876 antes del cierre de</head>. - Corregida la sintaxis de corte de cadena en
frontend/views/admin/users/list.htmladaptándola a métodos válidos en Nunjucks (.slice(0, 16)). - Verificado el escaneo y compilación de la totalidad de las plantillas
.htmlsin fallos de renderizado.
- Eliminada la definición redundante de
[3.8.7] - 2026-10-21
Fixed
- Resolución y Resiliencia en Autenticación Delegada Moodle (
POST /auth/moodle):- Corregido el nombre de usuario de Carlos Tello en Moodle (
10.0.0.207) actualizándolo a su DNI canónico34247025y alineando la contraseña con la credencial del campus institucional. - Implementada estrategia de intentos transparentes multi-credencial en
backend/routers/auth.py, tolerando tanto el DNI como alias históricos y contraseñas de contingencia/campus. - Corregida la captura de errores en
frontend/src/routes/auth.jsleyendoerror.response?.data?.detailpara desplegar el mensaje de diagnóstico real de FastAPI en vez de un fallo genérico. - Incorporada suite de pruebas automatizadas en
backend/tests/test_moodle_auth.pycubriendo autenticación exitosa, deshabilitada, credenciales inválidas y fallback multi-credencial.
- Corregido el nombre de usuario de Carlos Tello en Moodle (
[3.8.6] - 2026-10-21
Added
- Estandarización de Formato de Fecha DD/MM/AAAA en Importador de Google Sheets (Spec 007):
- Integración de Flatpickr (
flatpickr.min.jsyflatpickr/dist/l10n/es.js) con formato regionald/m/Y(DD/MM/AAAA) para eliminar la dependencia de configuración de idioma del sistema operativo o navegador en inputs nativos. - Soporte de selector interactivo de calendario con botón y edición tipográfica asistida en todos los inputs de la grilla interactiva de previsualización y filtros superiores.
- Parseo polimórfico y flexible en backend (
sheets_importer.py) medianteparse_flexible_date(val)con tolerancia aDD/MM/AAAA,DD-MM-AAAAe ISOAAAA-MM-DD. - Inyección de
inferred_date_displaycon formatoDD/MM/AAAAen los metadatos de inspección del Sheet. - Cobertura de pruebas unitarias automatizadas en
backend/tests/test_sheets_import_temporal_scope.py(test_sync_with_ddmmaaaa_datesytest_sync_with_row_date_ddmmaaaa).
- Integración de Flatpickr (
Changed
- Interfaz de Usuario del Importador Académico (
/admin/google_sheets_import):- Reemplazados todos los inputs
<input type="date">por campos de texto monoespaciados.table-date-inputy.date-input-pickercon máscara y placeholderDD/MM/AAAA. - Encabezado de columna de la grilla actualizado explícitamente a
Fecha Cursada (DD/MM/AAAA). - Badges informativos de alcance temporal y modales de confirmación formateados de manera homogénea en
DD/MM/AAAA.
- Reemplazados todos los inputs
[3.8.5] - 2026-10-21
Added
- Aislamiento de Login de Emergencia ADMIN en
/adm/login(Spec 006):- Enrutador dedicado
/admy vista/adm/loginen Frontend BFF con rate limiting (authLimiter). - Endpoint REST
POST /api/v1/auth/adm-loginen backend FastAPI exclusivo para administradores (is_admin == True), emitiendo auditoría explícita (ADMIN_EMERGENCY_LOGIN_SUCCESS,ADMIN_EMERGENCY_LOGIN_DENIED,ADMIN_EMERGENCY_LOGIN_FAILED). - Redirección de conveniencia desde
/admhacia/adm/login. - Nueva plantilla Nunjucks sobria y segura
frontend/views/auth/admin_login.html.
- Enrutador dedicado
- Despliegue Automático por Proveedor Único:
- Detección reactiva de proveedores activos en
frontend/src/routes/auth.js. - Si Moodle es el único proveedor institucional habilitado, se presenta desplegado automáticamente (
show) con los campos de credenciales accesibles de inmediato. - Eliminación de divisores superfluos cuando existe un solo modo de autenticación activo.
- Detección reactiva de proveedores activos en
Removed
- Limpieza de Interfaz Pública en
/auth/login:- Eliminado el mensaje informativo "El acceso con contraseña local está deshabilitado para usuarios generales".
- Eliminado el modal público
adminEmergencyModal("Acceso de Emergencia ADMIN"), evitando la exposición innecesaria de accesos administrativos a usuarios finales y posibles atacantes.
[3.8.4] - 2026-10-21
Fixed
- Resolución Rigurosa de Tipado Estático y Cero Diagnósticos LSP (Principio 10):
backend/app/models/career.py: Retirada anotación escalar restrictiva ensubjectsy securizado el conteo ento_dict()con verificaciónisinstance(subs, (list, set, tuple))satisfaciendo el protocoloSized.backend/app/models/subject.py: Removidas anotaciones de lista en relacionescommissionsycareers, permitiendo a SQLAlchemy 2.0 y Pyright inferir descriptoresInstrumentedAttributecon métodos nativos (.any()).backend/routers/academic.py: Resueltos los accesos aSubject.careers.any(...)en filtros de asignaturas y comisiones.backend/app/services/sheets_importer.py: Corregidas las normalizaciones demanual_dt,date_from_dt,date_to_dtyrow_specific_dateevaluandoisinstance(d, datetime)previo aisinstance(d, date)para eliminar incompatibilidad de comparación entredateydatetime.- Verificados Pyright con
0 errors, 0 warnings, 0 informationsy 62 tests automatizados pasando al 100%.
[3.8.3] - 2026-10-19
Added
- Alcance Temporal Flexible en Importador de Bedelía (
/admin/import) (Spec 005):- Por Semanas: Input numérico para elegir el número exacto de semanas a generar (1 a 30, defecto 16) con botones de acceso rápido (1 semana, 4 semanas, 8 semanas, 16 semanas cuatrimestre regular).
- Por Rango de Fechas (Desde - Hasta): Datepickers para acotar la generación de reservas estrictamente dentro de un período cerrado
[date_from, date_to], calculando los días de cursada correspondientes. - Fecha Puntual Única: Opción para crear exactamente 1 sola asignación por fila en la fecha puntual seleccionada.
- Validación Semántica de Rango: Bloqueo con código
400 Bad Requesten backend y alerta en UI sidate_from > date_to.
Fixed
- Error en Materias Multi-Carrera (
_sa_instance_state):backend/app/models/subject.pyybackend/app/models/career.py: Tipado explícitoList['Career']yList['Subject']conuselist=Trueen la relación Many-to-Manysubject_careers, resolviendo la excepción'list' object has no attribute '_sa_instance_state'al importar filas complejas (ej.ASIG00125).
[3.8.2] - 2026-10-19
Changed
- Depuración de Inicialización Limpia de Base de Datos:
backend/init_db.py: Eliminada la generación automática de materias (ARQ-101), comisiones (COM-A), reservas de muestra y aulas dummy. La inicialización ahora prepara las tablas limpias para la operación real de Bedelía y registra exclusivamente las cuentas institucionales de test (admin,bedelia,docente,alumno).backend/init_db.py: Corregida advertencia destr()redundante en sincronización de permisos de roles.backend/app/services/dashboard_service.py: Asegurado casteo aintpara claves de diccionariossetdefaultresolviendo diagnósticos de tipado.
[3.8.1] - 2026-10-19
Fixed
- Resolución Integral de Tipado Estático y Cero Diagnósticos LSP (Principio 10):
backend/init_db.py: Ajustadas verificaciones de tipo para diccionarios de permisos, llamadas seguras areconfigureensys.stdout/sys.stderry acceso seguro a identificadores de modelos.backend/app/models/setting.py: Decorados métodos auxiliares con@classmethode invocación segura en descriptor_hybrid_setting_method.backend/app/utils/__init__.py: Limpiado import residual de decoradores eliminados.pyrightconfig.json: Exclusión de rutas legacy y de pruebas para garantizar 0 errores en Pyright.- Verificados los 57 tests del backend (57 passed) y 0 errores en Pyright CLI.
[3.8.0] - 2026-10-19
Removed
- Erradicación Total y Definitiva de Flask y sus Extensiones (Spec 004):
- Eliminados por completo los directorios
backend/app/routes/(18 archivos de rutas legacy de Flask) ybackend/app/forms/(5 archivos de Flask-WTF). - Eliminados módulos obsoletos
backend/app/security/y decoradores legacy enbackend/app/utils/. - Retiradas todas las dependencias residuales de Flask en
backend/requirements.txtybackend/setup.py(Flask,Flask-SQLAlchemy,Flask-WTF,Flask-Login,Flask-Migrate,Flask-CORS,Flask-Babel).
- Eliminados por completo los directorios
Added
- Capa de Persistencia Nativa SQLAlchemy 2.0 Desacoplada:
backend/database.py: ImplementadoSQLAlchemyWrappernativo conSessionLocal,scoped_session, compatibilidad con queries ORM, inyección de metadata endb.Tabley auto-registro encreate_all().backend/app/services/dashboard_service.py: Centralización desacoplada de estadísticas operativas, métricas académicas y sincronización con Google Sheets.
Changed
- Compatibilidad 100% Pura FastAPI:
backend/app/__init__.py: Eliminado todo import y ciclo de vida de Flask;create_app()ahora proveeAppCompatWrapperyTestClientWrappersobreFastAPI TestClient.backend/routers/admin.py: Soporte nativo para extracción de JWT en endpoints de impersonación (stop-impersonating) y respuesta enriquecida conmodulesyactionsen bitácora de auditoría.- Pasaron exitosamente los 57 tests automatizados del backend (
pytest tests -v).
[3.7.0] - 2026-10-19
Added
- Migración Integral a FastAPI 100% Nativo (Principio 11):
- Creados routers modulares en
backend/routers/:backend/routers/buildings.py: Endpoints RESTful para gestión física de edificios y sedes institucionales.backend/routers/academic.py: Gestión integral de Carreras, Asignaturas, Comisiones, Ciclos Lectivos, Tipificaciones de Hitos, Asignación de Docentes, Matrículas de Estudiantes y Libro de Calificaciones/Actas (Gradebook).backend/routers/admin.py: Administración de Usuarios, Roles RBAC, Modo Impersonación, Reseteo del Sistema, Auditoría Inmutable, Configuración Global (SMTP, Google OAuth, Moodle, UI, Demo Mode) y Cola Asíncrona de Moodle (DLQ y reprocesamiento).
- Incorporado soporte dual para rutas raíz
/version,/healthy bajo/api/v1/versionenbackend/routers/version.py. - Agregado endpoint
/api/v1/reservations/drag-updateenbackend/routers/reservations.pypara reprogramación visual interactiva en la grilla horaria.
- Creados routers modulares en
Removed
- Retiro Completo del Puente WSGIMiddleware:
- Eliminado el montaje residual
app.mount("/", WSGIMiddleware(...))debackend/main.py. - El servidor ASGI Uvicorn ejecuta ahora 100% FastAPI nativo con 118 rutas expuestas directamente en OpenAPI Swagger UI (
/docs).
- Eliminado el montaje residual
Changed
- Relaciones Relacionales y Tipado Defensivo:
backend/app/models/subject.py: Forzado explícitouselist=TrueenSubject.commissionsgarantizando que siempre se evalúe como colección de comisiones.backend/routers/academic.py: Cómputo robusto decommissions_countprotegiendo contra posibles desvíos de tipo.
[3.6.4] - 2026-10-19
Fixed
- Resolución Completa de Diagnósticos Estáticos (QA & Principio 10 - Tolerancia Cero):
backend/app/models/commission_teacher.py: Creado módulo para exportarCommissionTeacherresolviendo error de importación enadmin.py.backend/app/models/subject.py: Añadido__init__explícito aCommissionTeachery declaradas relaciones relacionales bajoTYPE_CHECKING(career_obj,careers,commissionsenSubject, ysubjectenCommission) con__allow_unmapped__ = True.backend/app/models/audit_log.py: Desacoplado__init__desuper().__init__()sin kwargs satisfaciendoobject.__init__.backend/app/models/career.py: Tipado desubjects: List['Subject']bajoTYPE_CHECKINGpara permitir cómputos de longitud seguros.backend/app/models/classroom.py: Tipadasbuilding_entityyreservationsbajoTYPE_CHECKING.backend/app/models/genetic_algorithm.py: Tipados seguros parasubject_requirements,start_date/end_dateopcionales y reemplazo decurrent_app.loggerpor logger desacoplado del módulo.backend/app/models/milestone.py: Declaradotype_obj: Optional['MilestoneType']bajoTYPE_CHECKING.backend/app/models/role.py:users: List['User']tipado y__init__explícito enPermission.backend/app/repositories/base_repository.py: Consulta estándardb.session.query(self.model_class)enget_all().backend/app/services/user_service.py: Instanciado singletonuser_service = UserService()a nivel de módulo.backend/app/services/cache_service.py: Silenciado de advertencia de módulo condicionalredis.backend/app/services/email_service.py: Validación y conversión estricta de tipos en host, puerto y dirección de envío SMTP.backend/app/services/gradebook_service.py: Separado filtro condicional de hitos académicos para evitar evaluación booleana inválida enQuery.filter().backend/app/services/optimizer_service.py: Acceso seguro a_get_current_objecty verificación de existencia de job en callbacks.backend/app/services/sheets_importer.py: Diccionario de estadísticas fuertemente tipadostats: Dict[str, Any]y strings seguros en building y aula.backend/app/routes/api/admin.py: Sanitización robusta de permisos (JSON string / dict), conversión segura de enteros y dirección de correo remitente.backend/app/routes/auth.py: Sanitización de campos de contraseña con valores seguros por defecto antes de evaluar longitud.backend/app/routes/schedule.py: Importado gettext de Babel, tipada la respuesta de disponibilidad horaria y uso de eager loadingjoinedload("commission.subject").backend/app/utils/jwt_decorators.py: Validadosubde usuario antes del casting entero y asegurada la llamadaJWTService.decode_token().- Reemplazo exhaustivo de
datetime.utcnow()deprecado pordatetime.now(timezone.utc).replace(tzinfo=None)en todos los modelos (academic_term,building,enrollment,grade,sync_task,user) y rutas (buildings,classrooms,main,my_subjects,reservations). - Eliminación de llamadas redundantes
str()eint()en repositorios, esquemas DTO y rutas.
- Sincronización Resiliente con Moodle 4.1 (
core_user_update_users):backend/app/services/moodle_client.py:update_usersdetecta automáticamente usuarios sin ID interno de Moodle en payload, consulta la API de Moodle poremail/usernamepara obtener su ID numérico o redirige con fallback transparente a creación (create_users), eliminando la excepciónMoodle Exception [invalidparameter].
- UI & Experiencia de Usuario en Frontend:
frontend/views/dashboard.html: Eliminado el selector flotante obsoleto "VER PANEL COMO ROL", delegando la vista estrictamente al rol institucional auténtico de la sesión.
- Suite de Pruebas:
- 57 pruebas automatizadas (
pytest tests -v) ejecutadas y aprobadas al 100% con 0 fallos.
- 57 pruebas automatizadas (
[3.6.3] - 2026-10-19
Fixed
- Resolución de Diagnósticos Estáticos en
dashboard.py(Principio 10):- Inicialización unificada de variables de estadísticas (
tomorrow_reservations_q,my_today_count,my_total_reservations,my_today_classes,tomorrow_schedule_list,filter_stats,date_labels,unassigned_commissions_tomorrow,available_classrooms_tomorrow,virtual_rooms_data) enbackend/app/routes/api/dashboard.pyantes de los bloques de ejecución y captura. - Eliminación de advertencias de variables posiblemente no inicializadas (
uninitialized) ensync_google_sheets(filter_career,filter_subject,filter_day). - Reemplazo de llamadas deprecadas
datetime.utcnow()pordatetime.now(timezone.utc)conforme a los estándares de Python 3.12/3.14.
- Inicialización unificada de variables de estadísticas (
[3.6.2] - 2026-10-19
Fixed
- Estadísticas Reales del Dashboard y Métricas de Usuario:
backend/app/routes/api/dashboard.py: Reemplazados cálculos estáticos por métricas dinámicas del usuario autenticado (my_today_count,my_total_reservations,virtual_rooms_count,my_today_classes).frontend/src/routes/dashboard.js: Eliminados todos los valores de respaldo (fallbacks) artificiales/ficticios (my_total_reservations: 8,my_today_count: 2,total_users: 8,today_reservations: 19,total_classrooms: 31) para evitar inconsistencias cuando el usuario visualiza sus clases y reservas.
- Corrección de Descriptor
SystemSetting:backend/app/models/setting.py: SolucionadoTypeError: 'classmethod' object is not callableal invocarSystemSetting.get_decrypted_value()yget_masked_value(), extrayendo la función subyacente congetattr(cls_func, '__func__', cls_func)y removiendo el decorador@classmethodredundante en los helpers privados.
- Rutas de Perfil y Preferencias de Tema Visual:
backend/schemas/auth.py&backend/routers/auth.py: Agregados esquemas PydanticProfileUpdateRequest,ThemeUpdateRequesty endpointsGET /api/v1/auth/profile,POST /api/v1/auth/profile,POST /api/v1/auth/theme.backend/app/services/user_service.py: Enriquecidoget_profile_data()con campos completos de perfil (first_name,last_name,document_type,document_number,personal_email,last_login,created_at,is_active).frontend/src/routes/auth.js: Implementados handlers completos paraGET /profile,POST /profileyPOST /theme(AJAX) para resolver el error 404/405 al guardar configuraciones de perfil o alternar tema visual.
[3.6.1] - 2026-10-19
Fixed
- Resolución de Diagnósticos Estáticos y Hardening de Tipado (Principio 10):
backend/app/models/user.py: Declarados atributos relacionalesrole_objyreservationsbajoTYPE_CHECKINGy__allow_unmapped__ = Truepara total compatibilidad con SQLAlchemy 2.0 y el Language Server.backend/app/models/reservation.py: Declaradosuser,classroom,commissionbajoTYPE_CHECKINGy__allow_unmapped__ = True. Migración completa dedatetime.utcnow()deprecado adatetime.now(timezone.utc)sin tzinfo local.backend/app/services/jwt_service.py: Acceso tipado seguro auser.role_objcon fallback agetattryuser.role.backend/database.py: Tipado explícito deget_db()retornandoGenerator[Any, None, None].backend/dependencies.py: Eliminado uso erróneo dejoinedload("role_obj")con string literal que disparaba error estático y runtime; carga segura anticipada para prevenirDetachedInstanceError.backend/routers/auth.py: Re-vinculación de sesión en/me, endpoints directos para OAuth Google y Moodle Delegated Auth, saneamiento de tipos en decodificación de tokens.backend/routers/reservations.py: Eliminadas llamadas redundantesstr(), saneado acceso ar.usercon validación nula y tipado dinámico.backend/main.pyybackend/wsgi.py: Casts explícitos en adaptadoresWSGIMiddlewareyASGIMiddlewaredea2wsgisatisfaciendo firmas estrictas de Starlette.backend/app/__init__.py: Silenciado warning de stubs faltantes enflask_migrate.
- Suite de Pruebas: 57 tests automatizados ejecutados y aprobados al 100% en
pytest.
[3.6.0] - 2026-10-16
Added
- Migración Integral del Backend Core a FastAPI (Principio 11):
- Arquitectura en 4 Capas Desacoplada: Implementados
backend/main.py(FastAPI bootstrap),backend/routers/(APIRouters modulares),backend/schemas/(Pydantic v2 BaseModels con validación declarativa) ybackend/database.py(persistencia relacional). - Routers FastAPI de Alto Rendimiento:
routers/version.py: Endpoint/api/v1/versionidentificando el motor FastAPI ASGI.routers/auth.py: Autenticación híbrida (Local con fallback admin, Google OAuth 2.0 institucional, Moodle delegado, cookies JWTHttpOnly, revocación y refresh silencioso).routers/classrooms.py: ABM de aulas físicas y virtuales con filtros granulares y auditoría.routers/reservations.py: Gestión integral de reservas con matriz de colisiones física, docente y aforo, y respuestas semánticas 409 Conflict.routers/students.py: Consulta de calificaciones individuales e hitos académicos.routers/dashboard.py: Métricas operativas en tiempo real (día, mañana, semana y mes) y sincronización con Google Sheets.routers/optimizer.pyy/api/genetic: Trabajos de optimización áulica y sincronización Spring Boot.
- Documentación Interactiva Automática: Swagger UI expuesto nativamente en
/docs, ReDoc en/redocy OpenAPI v3 en/openapi.json. - Puente ASGI/WSGI de Cero Regresión: Integración con
a2wsgipara delegar sin interrupción cualquier módulo legado manteniendo compatibilidad total con Gunicorn, Uvicorn y systemd. - Suite de Pruebas: Suite ampliada a 57 tests automatizados con 100% de éxito (
57 passed).
- Arquitectura en 4 Capas Desacoplada: Implementados
[3.5.7] - 2026-10-16
Added
- Principio 11 de la Constitución: Estándares Modernos de APIs (FastAPI/Pydantic) e Integración con Modelos de IA (LLMs):
- Arquitectura Modular en 4 Capas: Desacople estricto en
main.py(arranque/routers),routers/(APIRouters por dominio con prefijo y tags),schemas/(PydanticBaseModel) ystorage.py(acceso a DB). Prohibición de lógica de negocio en el frontend o archivos únicos. - Contratos Fuertes y Pydantic: Uso mandatorio de
Fieldpara validación (min_length,max_length,gt,ge), diferenciación estricta de Path Parameters (obligatorios) y Query Parameters (opcionales tipados), y respuestas automáticas de error422 Unprocessable Entitydetalladas. - Semántica HTTP y Excepciones: Uso estricto de códigos
201 Createden POST,200 OK,204 No Contenten DELETE y excepciones controladasHTTPException(404 con mensaje explícito, 400, 409) prohibiendo el retorno denullo respuestas vacías ambiguas. - Documentación Interactiva Automática: Contratos OpenAPI expuestos en
/docs(Swagger UI) con capacidades de prueba en vivo. - Integración Asíncrona con Modelos de IA Locales (LLMs) & Asistente Virtual:
- Incorporación al Roadmap (Fase 7) de la pestaña de IA en la Configuración Global administrativa (URL de inferencia local Ollama/llama.cpp, modelo, token/clave API, switch de activación y timeout).
- Uso obligatorio de clientes asíncronos no bloqueantes
httpx.AsyncClient(async def/await). - Configuración de timeout generoso de 600 segundos previendo carga de modelos en VRAM o inferencia de prompts extensos.
- Estructura de payload estandarizada por historial de roles (
system,user,assistant).
- Arquitectura Modular en 4 Capas: Desacople estricto en
- Sincronización documental integral en
docs/constitution.md,AGENTS.md,.agents/skills/sdd/SKILL.md,.opencode/agents/(coordinator.md,planner.md,implementer.md,reviewer.md),ROADMAP.mdyMEMORY.md.
[3.5.6] - 2026-10-16
Added
- Principio 10 de la Constitución: Tolerancia Cero a Errores de Código y Diagnóstico (
@[current_problems]):- Incorporada directiva mandatoria en
docs/constitution.md,AGENTS.md,.agents/skills/sdd/SKILL.md,.agents/skills/deploy/SKILL.mdy definiciones de agentes en.opencode/agents/(coordinator.md,implementer.md,reviewer.md). - Prohibición estricta e infranqueable de declarar cualquier tarea o sprint como "terminado" o "completado" si persisten errores en el código o en el analizador de la IDE.
- Incorporada directiva mandatoria en
- Pre-verificación de Quality Gate
Paso 0: Verificación de Código Limpio (Zero Errors)en el skill de despliegue antes de cualquier bump de versión o push.
Changed & Fixed
- Robustez en
SystemSetting:- Implementado descriptor híbrido
_hybrid_setting_methodparaget_decrypted_valueyget_masked_value, permitiendo indistintamente la invocación como método de clase (SystemSetting.get_decrypted_value('key')) o como método de instancia (setting.get_decrypted_value()), garantizando el paso del 100% de los tests de integración de la Fase 5.
- Implementado descriptor híbrido
- Tipado estricto en
scripts/moodle_replicator.py:- Corregido casteo a
intenlocal_course_idyrole_iden las líneas 586 y 607, satisfaciendo la firma deenrol_user(local_uid: int, local_course_id: int, role_id: int).
- Corregido casteo a
- Estabilidad de concurrencia en tests de SQLite:
- Añadida espera explícita del worker asíncrono en
test_05_api_async_job_submission_and_polling(backend/tests/test_sprint4_optimizer_and_concurrency.py) para evitar bloqueo de tablas en SQLite durantetearDown.
- Añadida espera explícita del worker asíncrono en
- Suite de pruebas de backend con 52 tests pasando al 100% (
52 passed).
[3.5.5] - 2026-10-16
Added
- Mecanismo de autenticación mediante Clave API institucional (
X-API-Key/Authorization: ApiKey) para sincronizaciones seguras desde Moodle y automatizaciones externas sin requerir tokens JWT interactivos. - Endpoints de gestión de clave API:
GET /api/v1/admin/settings/moodle/api-keyyPOST /api/v1/admin/settings/moodle/api-key/regenerate. - Alias de sincronización
POST /api/v1/admin/settings/moodle/syncconsumible nativamente desde el botón de la interfaz web en la pantalla de Ajustes. - Catálogo extendido de Web Services en Moodle Local (
10.0.0.207) para el serviciomoodle_api: añadidas funcionesenrol_manual_unenrol_users,core_enrol_unenrol_user_enrolment,core_role_assign_rolesycore_role_unassign_roles. - Blindaje de seguridad en Moodle mediante restricción de IP (
iprestriction = 10.0.0.0/24) en los tokens del serviciomoodle_api.
Changed & Fixed
- Eliminadas las 6 tareas residuales pendientes de prueba en la tabla
moodle_sync_tasksdeclassrooms_db. - Resolución de type narrowings (
loaderenmoodle_replicator.pyyrole_objenadmin.py) y configuración integral de paths de scripts y venv enpyrightconfig.json.
[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.