# 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.13] - 2026-10-26 ### Added - **Métricas y Contadores Rápidos de Usuarios por Rol (`/admin/users_list`)**: - Incorporadas tarjetas KPI interactivas en la cabecera de la vista de usuarios: Total global de usuarios registrados, Administradores, Bedelía, Docentes y Alumnos matriculados, con estados activos e inactivos. - Al hacer clic en cualquiera de las tarjetas de rol, se filtra instantáneamente el padrón por dicho rol institucional. - Añadida barra de paginación superior en la cabecera de la tabla mostrando el rango exacto de usuarios renderizados (`Página X de Y · Mostrando Z de N usuarios`) y controles rápidos de navegación previa y siguiente. - **Filtro Resiliente por Rol en Backend FastAPI**: - `get_users` en `/api/v1/admin/users` ahora acepta `role` tanto numérico (ID de rol) como textual (ej. `Docente`, `Alumno`, `Admin`), insensible a mayúsculas, y retorna `role_counts` estructurado con la distribución total institucional. ### Fixed - **Limpieza de Diagnósticos de Tipos en Pyright**: - Removidas llamadas redundantes a `str()` sobre parámetros ya tipados como cadenas en `academic.py`, `classrooms.py` y `reservations.py`, asegurando 0 errores y 0 advertencias en el Language Server. ## [3.8.12] - 2026-10-26 ### Fixed - **Dashboard Layout y Estructura Visual (`frontend/views/dashboard/dashadm.html`)**: - Removidos 3 tags `` de cierre prematuro en la sección de balance de aulas físicas que expulsaban los módulos de gestión, los menús visuales y el gráfico de tendencia de ocupación fuera del contenedor principal hacia el fondo de la página, restableciendo la UI y UX original. - **Resiliencia en Filtrado y Paginación de Asignaturas y Comisiones (`/admin/subjects_list` y `/admin/commissions_list`)**: - Solucionado el error HTTP 422 Unprocessable Entity en FastAPI provocado cuando el frontend o los formularios enviaban parámetros vacíos (`career_id=&active=&search=`). Ahora los endpoints `/api/v1/subjects` y `/api/v1/commissions` aceptan `Optional[str]` y realizan un parsing seguro a enteros, permitiendo renderizar correctamente las 22 asignaturas y 22 comisiones registradas. - Enriquecido el BFF de Express (`frontend/src/routes/admin.js`) depurando el objeto `params` para no enviar claves vacías a la API. - **Paginación y Optimización de Base de Datos en Vistas Masivas (Spec 008)**: - Implementada paginación server-side con metadatos estructurados en `/api/v1/admin/users`, `/api/v1/audit-logs`, `/api/v1/subjects` y `/api/v1/commissions`. - Añadido endpoint `/api/v1/users/teachers` para selectores de docentes sin transferir la lista de miles de usuarios. - Corregida la consulta SQL relacional en `ReservationRepository` utilizando `not_(Classroom.code.ilike('%VIRTUAL%'))` y `Classroom.id.is_(None)` para el filtrado seguro de aulas virtuales. - Creada suite de pruebas unitarias y de integración `backend/tests/test_pagination_db.py` (6 passed). ## [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 ``. - 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 `` 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 (``) 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/` y `POST /api/v1/admin/academic-terms//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//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/?hard=true` y `POST /api/v1/reservations//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//gradebook`: estructura completa para la matriz del libro de calificaciones. - `PUT /api/v1/commissions//gradebook/grades`: guardado masivo o individual de notas vía JSON. - `POST /api/v1/commissions//gradebook/close`: cierre formal de acta. - `POST /api/v1/commissions//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//teachers` y `DELETE /api/v1/commissions//teachers/` 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//enrollments`, `POST /api/v1/commissions//enrollments`, `DELETE /api/v1/commissions//enrollments/` y `PUT /api/v1/commissions//enrollments/`. - 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/`. - 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//teachers` y `DELETE /api/v1/commissions//teachers/`, 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 `` 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** (`