875 lines
97 KiB
Markdown
875 lines
97 KiB
Markdown
# 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](https://keepachangelog.com/es-ES/1.1.0/) y este proyecto se adhiere a [Semantic Versioning](https://semver.org/lang/es/).
|
|
|
|
---
|
|
|
|
## [Unreleased]
|
|
### Planificado (Fase 6 del Roadmap)
|
|
- **Despliegue e Infraestructura (Fase 6):** `docker-compose.yml` productivo 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.11] - 2026-10-26
|
|
### Fixed
|
|
- **Exclusión de Reservas Pasadas en Fichas y Tarjetas de Aulas (`view_classroom` y `list_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 las `assigned_commissions` y `total_classes` exclusivamente 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.
|
|
|
|
## [3.8.10] - 2026-10-26
|
|
### Fixed
|
|
- **Sincronización y Consistencia de Salas Virtuales y Aulas (`/classrooms` vs `/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-rooms` en 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()` con `reservations` serializadas 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 en `list.html`.
|
|
- Reemplazadas fechas estáticas congeladas de septiembre de 2026 en `frontend/src/routes/classrooms.js` por 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.
|
|
|
|
## [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`) en `backend/app/schemas/optimizer_dto.py`.
|
|
|
|
### Fixed
|
|
- **Enrutamiento y Proxy Inverso en Frontend BFF (`frontend/src/app.js`)**:
|
|
- Configurado middleware proxy transparente para `/api/genetic` hacia 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_time` y `end_time` a formato naive UTC para evitar discrepancias de comparación en SQLite/PostgreSQL.
|
|
|
|
## [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 de `frontend/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.html` adaptándola a métodos válidos en Nunjucks (`.slice(0, 16)`).
|
|
- Verificado el escaneo y compilación de la totalidad de las plantillas `.html` sin fallos de renderizado.
|
|
|
|
## [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ónico `34247025` y 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.js` leyendo `error.response?.data?.detail` para 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.py` cubriendo autenticación exitosa, deshabilitada, credenciales inválidas y fallback multi-credencial.
|
|
|
|
## [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.js` y `flatpickr/dist/l10n/es.js`) con formato regional `d/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`) mediante `parse_flexible_date(val)` con tolerancia a `DD/MM/AAAA`, `DD-MM-AAAA` e ISO `AAAA-MM-DD`.
|
|
- Inyección de `inferred_date_display` con formato `DD/MM/AAAA` en 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_dates` y `test_sync_with_row_date_ddmmaaaa`).
|
|
|
|
### 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-input` y `.date-input-picker` con máscara y placeholder `DD/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`.
|
|
|
|
## [3.8.5] - 2026-10-21
|
|
### Added
|
|
- **Aislamiento de Login de Emergencia ADMIN en `/adm/login` (Spec 006)**:
|
|
- Enrutador dedicado `/adm` y vista `/adm/login` en Frontend BFF con rate limiting (`authLimiter`).
|
|
- Endpoint REST `POST /api/v1/auth/adm-login` en 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 `/adm` hacia `/adm/login`.
|
|
- Nueva plantilla Nunjucks sobria y segura `frontend/views/auth/admin_login.html`.
|
|
- **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.
|
|
|
|
### 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 en `subjects` y securizado el conteo en `to_dict()` con verificación `isinstance(subs, (list, set, tuple))` satisfaciendo el protocolo `Sized`.
|
|
- `backend/app/models/subject.py`: Removidas anotaciones de lista en relaciones `commissions` y `careers`, permitiendo a SQLAlchemy 2.0 y Pyright inferir descriptores `InstrumentedAttribute` con métodos nativos (`.any()`).
|
|
- `backend/routers/academic.py`: Resueltos los accesos a `Subject.careers.any(...)` en filtros de asignaturas y comisiones.
|
|
- `backend/app/services/sheets_importer.py`: Corregidas las normalizaciones de `manual_dt`, `date_from_dt`, `date_to_dt` y `row_specific_date` evaluando `isinstance(d, datetime)` previo a `isinstance(d, date)` para eliminar incompatibilidad de comparación entre `date` y `datetime`.
|
|
- Verificados Pyright con `0 errors, 0 warnings, 0 informations` y 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 Request` en backend y alerta en UI si `date_from > date_to`.
|
|
|
|
### Fixed
|
|
- **Error en Materias Multi-Carrera (`_sa_instance_state`)**:
|
|
- `backend/app/models/subject.py` y `backend/app/models/career.py`: Tipado explícito `List['Career']` y `List['Subject']` con `uselist=True` en la relación Many-to-Many `subject_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 de `str()` redundante en sincronización de permisos de roles.
|
|
- `backend/app/services/dashboard_service.py`: Asegurado casteo a `int` para claves de diccionarios `setdefault` resolviendo 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 a `reconfigure` en `sys.stdout`/`sys.stderr` y acceso seguro a identificadores de modelos.
|
|
- `backend/app/models/setting.py`: Decorados métodos auxiliares con `@classmethod` e 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) y `backend/app/forms/` (5 archivos de Flask-WTF).
|
|
- Eliminados módulos obsoletos `backend/app/security/` y decoradores legacy en `backend/app/utils/`.
|
|
- Retiradas todas las dependencias residuales de Flask en `backend/requirements.txt` y `backend/setup.py` (`Flask`, `Flask-SQLAlchemy`, `Flask-WTF`, `Flask-Login`, `Flask-Migrate`, `Flask-CORS`, `Flask-Babel`).
|
|
|
|
### Added
|
|
- **Capa de Persistencia Nativa SQLAlchemy 2.0 Desacoplada**:
|
|
- `backend/database.py`: Implementado `SQLAlchemyWrapper` nativo con `SessionLocal`, `scoped_session`, compatibilidad con queries ORM, inyección de metadata en `db.Table` y auto-registro en `create_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 provee `AppCompatWrapper` y `TestClientWrapper` sobre `FastAPI TestClient`.
|
|
- `backend/routers/admin.py`: Soporte nativo para extracción de JWT en endpoints de impersonación (`stop-impersonating`) y respuesta enriquecida con `modules` y `actions` en 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`, `/health` y bajo `/api/v1/version` en `backend/routers/version.py`.
|
|
- Agregado endpoint `/api/v1/reservations/drag-update` en `backend/routers/reservations.py` para reprogramación visual interactiva en la grilla horaria.
|
|
|
|
### Removed
|
|
- **Retiro Completo del Puente WSGIMiddleware**:
|
|
- Eliminado el montaje residual `app.mount("/", WSGIMiddleware(...))` de `backend/main.py`.
|
|
- El servidor ASGI Uvicorn ejecuta ahora 100% FastAPI nativo con 118 rutas expuestas directamente en OpenAPI Swagger UI (`/docs`).
|
|
|
|
### Changed
|
|
- **Relaciones Relacionales y Tipado Defensivo**:
|
|
- `backend/app/models/subject.py`: Forzado explícito `uselist=True` en `Subject.commissions` garantizando que siempre se evalúe como colección de comisiones.
|
|
- `backend/routers/academic.py`: Cómputo robusto de `commissions_count` protegiendo 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 exportar `CommissionTeacher` resolviendo error de importación en `admin.py`.
|
|
- `backend/app/models/subject.py`: Añadido `__init__` explícito a `CommissionTeacher` y declaradas relaciones relacionales bajo `TYPE_CHECKING` (`career_obj`, `careers`, `commissions` en `Subject`, y `subject` en `Commission`) con `__allow_unmapped__ = True`.
|
|
- `backend/app/models/audit_log.py`: Desacoplado `__init__` de `super().__init__()` sin kwargs satisfaciendo `object.__init__`.
|
|
- `backend/app/models/career.py`: Tipado de `subjects: List['Subject']` bajo `TYPE_CHECKING` para permitir cómputos de longitud seguros.
|
|
- `backend/app/models/classroom.py`: Tipadas `building_entity` y `reservations` bajo `TYPE_CHECKING`.
|
|
- `backend/app/models/genetic_algorithm.py`: Tipados seguros para `subject_requirements`, `start_date` / `end_date` opcionales y reemplazo de `current_app.logger` por logger desacoplado del módulo.
|
|
- `backend/app/models/milestone.py`: Declarado `type_obj: Optional['MilestoneType']` bajo `TYPE_CHECKING`.
|
|
- `backend/app/models/role.py`: `users: List['User']` tipado y `__init__` explícito en `Permission`.
|
|
- `backend/app/repositories/base_repository.py`: Consulta estándar `db.session.query(self.model_class)` en `get_all()`.
|
|
- `backend/app/services/user_service.py`: Instanciado singleton `user_service = UserService()` a nivel de módulo.
|
|
- `backend/app/services/cache_service.py`: Silenciado de advertencia de módulo condicional `redis`.
|
|
- `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 en `Query.filter()`.
|
|
- `backend/app/services/optimizer_service.py`: Acceso seguro a `_get_current_object` y verificación de existencia de job en callbacks.
|
|
- `backend/app/services/sheets_importer.py`: Diccionario de estadísticas fuertemente tipado `stats: 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 loading `joinedload("commission.subject")`.
|
|
- `backend/app/utils/jwt_decorators.py`: Validado `sub` de usuario antes del casting entero y asegurada la llamada `JWTService.decode_token()`.
|
|
- Reemplazo exhaustivo de `datetime.utcnow()` deprecado por `datetime.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()` e `int()` en repositorios, esquemas DTO y rutas.
|
|
- **Sincronización Resiliente con Moodle 4.1 (`core_user_update_users`)**:
|
|
- `backend/app/services/moodle_client.py`: `update_users` detecta automáticamente usuarios sin ID interno de Moodle en payload, consulta la API de Moodle por `email`/`username` para obtener su ID numérico o redirige con fallback transparente a creación (`create_users`), eliminando la excepción `Moodle 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.
|
|
|
|
## [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`) en `backend/app/routes/api/dashboard.py` antes de los bloques de ejecución y captura.
|
|
- Eliminación de advertencias de variables posiblemente no inicializadas (`uninitialized`) en `sync_google_sheets` (`filter_career`, `filter_subject`, `filter_day`).
|
|
- Reemplazo de llamadas deprecadas `datetime.utcnow()` por `datetime.now(timezone.utc)` conforme a los estándares de Python 3.12/3.14.
|
|
|
|
## [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`: Solucionado `TypeError: 'classmethod' object is not callable` al invocar `SystemSetting.get_decrypted_value()` y `get_masked_value()`, extrayendo la función subyacente con `getattr(cls_func, '__func__', cls_func)` y removiendo el decorador `@classmethod` redundante en los helpers privados.
|
|
- **Rutas de Perfil y Preferencias de Tema Visual**:
|
|
- `backend/schemas/auth.py` & `backend/routers/auth.py`: Agregados esquemas Pydantic `ProfileUpdateRequest`, `ThemeUpdateRequest` y endpoints `GET /api/v1/auth/profile`, `POST /api/v1/auth/profile`, `POST /api/v1/auth/theme`.
|
|
- `backend/app/services/user_service.py`: Enriquecido `get_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 para `GET /profile`, `POST /profile` y `POST /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 relacionales `role_obj` y `reservations` bajo `TYPE_CHECKING` y `__allow_unmapped__ = True` para total compatibilidad con SQLAlchemy 2.0 y el Language Server.
|
|
- `backend/app/models/reservation.py`: Declarados `user`, `classroom`, `commission` bajo `TYPE_CHECKING` y `__allow_unmapped__ = True`. Migración completa de `datetime.utcnow()` deprecado a `datetime.now(timezone.utc)` sin tzinfo local.
|
|
- `backend/app/services/jwt_service.py`: Acceso tipado seguro a `user.role_obj` con fallback a `getattr` y `user.role`.
|
|
- `backend/database.py`: Tipado explícito de `get_db()` retornando `Generator[Any, None, None]`.
|
|
- `backend/dependencies.py`: Eliminado uso erróneo de `joinedload("role_obj")` con string literal que disparaba error estático y runtime; carga segura anticipada para prevenir `DetachedInstanceError`.
|
|
- `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 redundantes `str()`, saneado acceso a `r.user` con validación nula y tipado dinámico.
|
|
- `backend/main.py` y `backend/wsgi.py`: Casts explícitos en adaptadores `WSGIMiddleware` y `ASGIMiddleware` de `a2wsgi` satisfaciendo firmas estrictas de Starlette.
|
|
- `backend/app/__init__.py`: Silenciado warning de stubs faltantes en `flask_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) y `backend/database.py` (persistencia relacional).
|
|
- **Routers FastAPI de Alto Rendimiento**:
|
|
- `routers/version.py`: Endpoint `/api/v1/version` identificando el motor FastAPI ASGI.
|
|
- `routers/auth.py`: Autenticación híbrida (Local con fallback admin, Google OAuth 2.0 institucional, Moodle delegado, cookies JWT `HttpOnly`, 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.py` y `/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 `/redoc` y OpenAPI v3 en `/openapi.json`.
|
|
- **Puente ASGI/WSGI de Cero Regresión**: Integración con `a2wsgi` para 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`).
|
|
|
|
## [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/` (Pydantic `BaseModel`) y `storage.py` (acceso a DB). Prohibición de lógica de negocio en el frontend o archivos únicos.
|
|
- **Contratos Fuertes y Pydantic**: Uso mandatorio de `Field` para 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 error `422 Unprocessable Entity` detalladas.
|
|
- **Semántica HTTP y Excepciones**: Uso estricto de códigos `201 Created` en POST, `200 OK`, `204 No Content` en DELETE y excepciones controladas `HTTPException` (404 con mensaje explícito, 400, 409) prohibiendo el retorno de `null` o 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`).
|
|
- 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.md` y `MEMORY.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.md` y 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.
|
|
- 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_method` para `get_decrypted_value` y `get_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.
|
|
- **Tipado estricto en `scripts/moodle_replicator.py`**:
|
|
- Corregido casteo a `int` en `local_course_id` y `role_id` en las líneas 586 y 607, satisfaciendo la firma de `enrol_user(local_uid: int, local_course_id: int, role_id: int)`.
|
|
- **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 durante `tearDown`.
|
|
- 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-key` y `POST /api/v1/admin/settings/moodle/api-key/regenerate`.
|
|
- Alias de sincronización `POST /api/v1/admin/settings/moodle/sync` consumible 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 servicio `moodle_api`: añadidas funciones `enrol_manual_unenrol_users`, `core_enrol_unenrol_user_enrolment`, `core_role_assign_roles` y `core_role_unassign_roles`.
|
|
- Blindaje de seguridad en Moodle mediante restricción de IP (`iprestriction = 10.0.0.0/24`) en los tokens del servicio `moodle_api`.
|
|
|
|
### Changed & Fixed
|
|
- Eliminadas las 6 tareas residuales pendientes de prueba en la tabla `moodle_sync_tasks` de `classrooms_db`.
|
|
- Resolución de type narrowings (`loader` en `moodle_replicator.py` y `role_obj` en `admin.py`) y configuración integral de paths de scripts y venv en `pyrightconfig.json`.
|
|
|
|
## [3.5.4] - 2026-10-16
|
|
### Added
|
|
- Integración completa bidireccional con el Web Service `moodle_api` de Moodle Local (`10.0.0.207`) usando token dedicado `810428346d3601c68a37a315fcba8d4391629f46`.
|
|
- Soporte para autenticación delegada Moodle (`/api/v1/auth/moodle`) con fallback dinámico entre `moodle_api` y `moodle_mobile_app`, y matching por número de documento (DNI) y prefijo de usuario.
|
|
- Endpoint administrativo `POST /api/v1/admin/moodle/sync-from-moodle` para sincronización directa de usuarios, roles y catálogo de cursos desde Moodle hacia la base de datos `classrooms_db`.
|
|
- Métodos `get_courses()`, `get_categories()` y `sync_from_moodle_to_app()` en `MoodleClient`.
|
|
- Otorgamiento de capability `moodle/webservice:createtoken` al rol autenticado de Moodle en `10.0.0.207` y 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.py` mediante configuración de `.vscode/settings.json` y 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 a `Docente` (`role_id=2`) y estudiantes (`student`) asignados a `Alumno` (`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`).
|
|
- **Desmatriculación Total de la Cuenta Admin en Moodle Local (`10.0.0.207`):**
|
|
- Removidas todas las asociaciones y enrolamientos espurios de la cuenta `admin` en 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).
|
|
|
|
## [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 como `username` y `password`.
|
|
- Mecanismo en `get_or_create_user` para forzar la actualización de contraseña y correo de cuentas existentes evitando bloqueos por credenciales obsoletas.
|
|
- **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 de `python-requests`.
|
|
- **Pre-caché y Optimización de Extracción:**
|
|
- Carga automática de correos previamente cacheados desde `participantes_export.json` para reducir en un 80% las consultas HTTP a producción y evitar timeouts.
|
|
|
|
## [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 de `logintoken` pre-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}`) como `username` y `password` para 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 mediante `core_user_create_users` y `core_user_update_users` con 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`).
|
|
- **Especificación SDD (`specs/002-moodle-export-sync/`):**
|
|
- `spec.md` con 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.md` con las reglas mandatorias del flujo SDD y sintaxis EARS.
|
|
- **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 `\uFEFF` y 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 print` para 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`).
|
|
- **Verificación de Calidad:**
|
|
- 52 pruebas automatizadas en verde (`52 passed`) en pytest.
|
|
|
|
## [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' })` y `express.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).
|
|
- **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`.
|
|
- **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.
|
|
|
|
## [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`).
|
|
- **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.
|
|
- **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 modelo `AuditLog` para 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/:id` y `/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_id` y `floor`) para agilizar la creación de espacios desde la vista de edificios.
|
|
|
|
## [3.4.6] - 2026-10-08
|
|
### Corregido & Mejorado (Reservas, Relaciones Edificios/Aulas, Fechas y Filtros)
|
|
- **Módulo de Reservas (`/schedule/add_reservation` y `/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_json` y `commission_data_json` sin escape de entidades HTML (`"`), y matching ultra tolerante de pisos físicos y virtuales.
|
|
- **Calendario Académico (`/schedule/calendar_view` y `/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.
|
|
- **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.
|
|
- **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.
|
|
- **Gestión de Edificios, Aulas y Pisos Dinámicos (`/buildings/list_buildings` y `/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_list` y `classrooms_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.
|
|
- **Filtros en Gestión de Comisiones (`/admin/commissions_list`):**
|
|
- Corrección de `UnboundLocalError` en `backend/app/routes/api/admin.py` dentro de `get_commissions` causado por importación interna tardía de `Career`, que provocaba error 500 al filtrar por carrera (`career_id=180, 181, 182`). Grilla ahora filtra correctamente sobre materias compartidas (`subject_careers`).
|
|
|
|
## [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 Forbidden` a usuarios con rol `Bedelia`, `Docente` o Administradores con roles formateados en minúsculas en los endpoints `/api/genetic/commissions`, `/api/genetic/algorithm-status`, `/api/genetic/preview-optimization`, `/api/genetic/optimize` y `/api/genetic/apply-optimization`.
|
|
- Creación del helper de verificación de permisos `check_optimizer_permission(user, requires_write)` en `backend/app/routes/genetic_algorithm.py` admitiendo a Administradores, Bedelía, Docentes y permisos RBAC personalizados.
|
|
- **Enriquecimiento del Listado de Comisiones para Asignación Áulica:**
|
|
- `GET /api/genetic/commissions` ahora expone `subject_name`, `subject_code`, `career_name`, `schedule` y `shift` para 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_optimizer` con `requireAuth` e inyección de datos de sesión en `frontend/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`, `Semana` y `Mes`, 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.
|
|
- Soporte completo en backend (`backend/app/routes/api/dashboard.py`): cálculo de `tomorrow_dt`, estadísticas en `filter_stats['tomorrow']`, `tomorrow_schedule_list` y soporte de sincronización de datos con frontend BFF.
|
|
|
|
## [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.
|
|
- **Backend & BFF Endpoints:**
|
|
- `POST /api/v1/dashboard/sheets-inspect` retorna metadatos y `preview_rows` con inferencia de fechas, estados de validación y carreras compartidas.
|
|
- `POST /api/v1/dashboard/sync-sheets` procesa opcionalmente `selected_rows` con 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 `for` de 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.
|
|
- **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`.
|
|
- Creación de la función utilitaria `formatReservationDates` en 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.html` y `view.html`.
|
|
|
|
## [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 `availableCareers` y `availableSubjects` en `handleGoogleSheetsImport` (`frontend/src/routes/admin.js`).
|
|
- Eliminación del error 500 al acceder por GET a `/admin/google_sheets_import` o `/admin/import`.
|
|
- **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.py` para 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 en `classrooms`.
|
|
- Agregado del arreglo `virtual_rooms` con 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.
|
|
|
|
### Refactorizado
|
|
- **Modularización de Vistas por Roles (`dashboard.html` como Layout Padre):**
|
|
- División de la plantilla monolítica `dashboard.html` en 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.html` mediante directivas `{% include %}` de Nunjucks.
|
|
|
|
### 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_careers` en 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_id` principal y exponiendo colecciones `careers` en `Subject` y `Commission`.
|
|
- Desglose de badges en UI para cada carrera vinculada tanto en `/admin/subjects_list` como 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`).
|
|
- **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 `/pubhtml` con 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`.
|
|
- **Habilitación y Reactivación de Operador Institucional de Bedelía:**
|
|
- Desbloqueo y activación de la cuenta `bedelia@edu-space.com` para gestión operativa continua con credenciales institucionales.
|
|
|
|
---
|
|
|
|
## [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:
|
|
1. **Sede / Edificio (`/buildings/list_buildings`):** Creación y administración del inmueble universitario.
|
|
2. **Aula (`/classrooms/list_classrooms`):** Alta de espacios físicos y aulas virtuales con control de aforo y recursos.
|
|
3. **Ciclo Lectivo (`/admin/academic_terms_list`):** Creación del período lectivo y activación del cuatrimestre corriente.
|
|
4. **Carrera / Titulación (`/admin/careers_list`):** Creación y administración del programa académico institucional.
|
|
5. **Asignatura / Materia (`/admin/subjects_list`):** Alta en plan de estudios asociada obligatoriamente a la Carrera.
|
|
6. **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.
|
|
7. **Asociar Profesores (`/admin/commission_detail`):** Asignación del cuerpo docente y co-docentes con roles de cátedra.
|
|
8. **Asociar Alumnos (`/admin/commission_detail`):** Matriculación con validación de restricciones horarias y excepciones de Bedelía.
|
|
9. **Reserva de Espacios (`/schedule/add_reservation` o Drag & Drop en `/schedule/calendar_view`):** Asignación de aula y franja horaria en 1 clic con chequeo de conflictos.
|
|
- **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`).
|
|
- **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.
|
|
- **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.
|
|
- **Mantenimiento del Importador de Google Sheets:**
|
|
- Preservación del servicio `sheets_importer.py` para ingesta masiva inicial sin fricción para el personal.
|
|
|
|
---
|
|
|
|
## [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 (`User` con 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 `AuditLog` con la acción `SYSTEM_RESET`, asociando el correo del administrador ejecutor, su IP y el recuento de entidades purgadas.
|
|
- **Interfaz de Usuario y Modal Interactivo:** Diálogo modal `#modalResetSystem` con 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).
|
|
|
|
### 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`) en `frontend/src/routes/classrooms.js`, permitiendo navegar a `/classrooms/list_classrooms?view_mode=physical` y `/classrooms/list_classrooms?view_mode=virtual` sin caídas ante bases vacías.
|
|
- **Corrección de Evaluación de Longitud en Nunjucks:** Actualizadas las directivas condicionales en `frontend/views/classrooms/list.html` a `classrooms.items|length > 0` y `virtual_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:** `handleAddClassroom` y `handleClassroomsList` ahora 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_metrics` y `virtual_rooms`, impidiendo errores 500 no controlados.
|
|
|
|
---
|
|
|
|
## [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>` y `POST /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`) en `frontend/views/admin/academic_terms/list.html`.
|
|
- **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_classroom` y `/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`).
|
|
- **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=true` y `POST /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`.
|
|
- **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`).
|
|
- **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.html` con autoselección de Edificio, Piso y Aula al navegar desde el catálogo de espacios.
|
|
- **Conexión REST en Vivo para Reservas:**
|
|
- Sustitución de listas fijas/mockeadas en `frontend/src/routes/schedule.js` por consulta dinámica a `/commissions` en vivo, permitiendo reservar aulas para cualquiera de las comisiones reales de la plataforma.
|
|
- **Soporte Multisede Consistente en Aulas:**
|
|
- Resolución robusta de `building_id` y flag `is_virtual` en `frontend/src/routes/classrooms.js`, eliminando hardcodes y asegurando que las aulas físicas pertenezcan a la sede seleccionada.
|
|
- **Inicialización de Base de Datos Limpia sin Datos Demo (`--empty-academic` / `--no-demo`):**
|
|
- **Soporte en `install.sh` y Menú Interactivo:** Incorporación de la opción `sudo 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-academic` que 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.
|
|
- **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 en `dashboard.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_enabled` administrado vía `POST /api/v1/admin/settings/ui`, respaldado por `SystemSetting` y registrado en `AuditLog`.
|
|
|
|
### 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 a `openPurgeModal()`, el cual no ejecutaba ninguna acción por ausencia del modal `#purgeConfirmModal` en 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.
|
|
- **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.
|
|
- **Instalador `install.sh`:**
|
|
- Inclusión de banderas `--keep-db` y `--keep-users` para evitar sobreescritura de contraseñas y usuarios en reinstalaciones o actualizaciones.
|
|
|
|
---
|
|
|
|
## [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 (`CryptoService` en `backend/app/services/crypto_service.py`).
|
|
- Migración y extensión de `SystemSetting` con columnas `category` e `is_encrypted`, junto con métodos polimórficos `get_decrypted_value()` y `get_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.html` con soporte optimizado para pantallas 720p, 1360x768 y 1080p, y enlace integrado en el menú de navegación lateral.
|
|
- **Épica 2: Infraestructura Asíncrona y Caché:**
|
|
- Servicio híbrido de caché `CacheService` con integración Redis y fallback en memoria/TTL.
|
|
- Modelo `MoodleSyncTask` y procesador asíncrono `MoodleQueueService` con Exponential Backoff y Dead Letter Queue (DLQ).
|
|
- Métricas en vivo y reintentos manuales individuales y masivos para tareas en DLQ.
|
|
- **É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 `MoodleClient` con 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.
|
|
- **Épica 5: Motor de Notificaciones (Email Server):**
|
|
- Cliente SMTP dinámico en `EmailService` con 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.
|
|
- **Pruebas y Verificación:**
|
|
- Suite de integración automatizada `backend/tests/test_phase6_integration.py` con 7 pruebas aprobadas al 100%. Regresión completa de 30 pruebas en verde en los módulos core.
|
|
|
|
---
|
|
|
|
## [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-update` con 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 `AuditLog` y muestra confirmación visual de éxito.
|
|
- **Estadio 4.2 — Modo Impersonación del Superadmin:**
|
|
- Soporte completo de cabecera `X-Impersonate-User` en el decorador JWT del Backend Flask (`jwt_required`) para administradores.
|
|
- Endpoints administrativos `POST /api/v1/admin/impersonate` y `POST /api/v1/admin/stop-impersonating` con registro estricto en `AuditLog` bajo las acciones `IMPERSONATE_START` e `IMPERSONATE_END`.
|
|
- Inyección contextual de impersonación en el Frontend BFF (`authMiddleware` y proxy transparente `/api`) mediante cookies seguras `impersonate_user_id` e `impersonate_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`.
|
|
- **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ñana` 08:00-12:00, `Tarde` 14:00-18:00, `Vespertino`/`Noche` 18:30-22:30).
|
|
- Soporte de guardado masivo en base de datos (`POST /api/genetic/apply-optimization` y `apply_optimized_reservations`) con prevención de solapamientos físicos y conversión estricta de fechas ISO.
|
|
- **Suite de Pruebas Unitarias de Fase 4:**
|
|
- Archivo `backend/tests/test_phase4_interactive_impersonation.py` con 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).
|
|
|
|
---
|
|
|
|
## [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-milestones` con 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*).
|
|
- **Estadio 3.2 — Libro de Calificaciones (*Gradebook*) y Cierre de Actas:**
|
|
- Extensiones al modelo `Commission`: campos `grades_closed` (booleano), `grades_closed_at` (timestamp), `grades_closed_by` (ID usuario) y `acta_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_grade` y `bulk_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 en `AuditLog` y 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`.
|
|
- Script de migración de base de datos SQLite `backend/migrate_phase3_fields.py`.
|
|
- **Suite de Pruebas Unitarias de Fase 3:**
|
|
- Archivo `backend/tests/test_phase3_gradebook.py` con 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).
|
|
|
|
---
|
|
|
|
## [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>/teachers` y `DELETE /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`).
|
|
- **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-conflicts` para pre-validación asíncrona de conflictos físicos, docentes y de capacidad antes del guardado.
|
|
- **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_course` en modelo `Subject`; 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_exception` y `exception_reason` en el modelo `StudentEnrollment`, 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>` y `PUT /api/v1/commissions/<id>/enrollments/<student_id>`.
|
|
- Adaptación completa de UI en `/admin/commission_detail` con 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.
|
|
- **Suite de Pruebas Unitarias e Integrales de Reglas de Negocio:**
|
|
- Archivo `backend/tests/test_phase2_rules.py` con 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.
|
|
- **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.bat` para Windows y actualización de `.gitea/workflows/security-audit.yaml` para asegurar la correcta ejecución del stack de auditoría (Bandit, pip-audit, njsscan y Schemathesis).
|
|
## [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 en `sheets_importer.py` mediante 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 en `backend/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.
|
|
|
|
---
|
|
|
|
## [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 `User` de 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) y `document_number` (Número de documento validado).
|
|
- Catálogo formal de reglas de negocio en `backend/app/constants/document_types.py` con 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/users` y `PUT /api/v1/users/<id>`.
|
|
- Búsqueda dinámica en `/admin/users_list` habilitada para filtrar por número de documento o email personal/institucional además de nombre.
|
|
- Rediseño del formulario `/admin/users/form` estructurado 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.py` para agregar las columnas e inicializar nombres desglosados de los usuarios existentes.
|
|
- **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>/teachers` y `DELETE /api/v1/commissions/<id>/teachers/<user_id>`, junto con la serialización completa de cátedras en `GET /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.
|
|
- **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.
|
|
|
|
### 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 con `overflow` (`.table-responsive`). Se refactorizó hacia un único modal global `#modalEditSubject` instanciado fuera de la tabla e inicializado dinámicamente con JavaScript.
|
|
### 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`.
|
|
- **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*.
|
|
|
|
### Corregido
|
|
- **Fallo Crítico de Renderizado en Nunjucks (`memberLookup` con `.items`):**
|
|
- Solucionada la incompatibilidad de `nunjucks/src/jinja-compat` que interceptaba la propiedad `.items` convirtiendo `classrooms.items` en una función interna en lugar de un array, lo que impedía dibujar las tarjetas de aulas presenciales en `frontend/views/classrooms/list.html`.
|
|
- Implementado interceptor en `memberLookup` en `frontend/src/app.js` para preservar arrays intactos.
|
|
- **Clasificación Errónea de Reservas Físicas como Virtuales (`is_virtual`):**
|
|
- Corregida la propiedad `@property is_virtual` en `Reservation` (`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.
|
|
- **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_number` en `backend/app/routes/api/dashboard.py`, migrando la clasificación de aulas presenciales y virtuales a una evaluación robusta en memoria Python (`Classroom.code` y `Classroom.building`).
|
|
|
|
---
|
|
|
|
## [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.py` con argumentos de limpieza granular (`--all`, `--reservations`, `--classrooms`, `--careers`, `--yes`).
|
|
- Endpoint de API `POST /api/v1/admin/reset-academic-data` protegido por JWT (rol `admin`) con registro en `AuditLog`.
|
|
- Panel interactivo "Zona de Reinicio y Purga Académica" en `/admin/google_sheets_import` con 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.
|
|
- **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-config` y `POST /api/v1/admin/sheets-config`.
|
|
- Normalizador de enlaces en `GoogleSheetsImporter` compatible 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.
|
|
- **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).
|
|
|
|
---
|
|
|
|
## [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_reservation` y `POST /schedule/cancel_reservation`.
|
|
- Actualización de enlaces en `today.html`, `list.html`, `dashboard.html` y `view.html` para navegar directamente con el identificador de la reserva (`?id=...`).
|
|
- **Creación y Asociación de Comisiones a Asignaturas (`admin/commissions_list`):**
|
|
- Botón destacado `+ Nueva Comisión` en el encabezado y en el estado vacío de la tabla.
|
|
- Modal interactivo `#modalAddCommission` con 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.
|
|
- **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/commissions` con validación estricta de existencia de asignatura y resolución inteligente de unicidad.
|
|
|
|
---
|
|
|
|
## [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=Lax` y `Secure`.
|
|
- Inyección transparente del token `Bearer` en peticiones internas mediante cliente Axios centralizado.
|
|
- **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.
|
|
- **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.
|
|
|
|
### 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.py` que 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 por `commission_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}`).
|
|
|
|
---
|
|
|
|
## [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.
|