# 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.17] - 2026-10-26 ### Changed & Improved - **Disponibilidad Áulica por Piso en Dashboard de Bedelía & Administración**: - Reemplazado el gráfico genérico de curva mensual de reservas por el nuevo **Panel de Disponibilidad & Ocupación Áulica por Piso (Operación Hoy)**, facilitando la toma de decisiones operativas de Bedelía con Chart.js en barras horizontales apiladas (`Libres Hoy` en verde vs `Con Cursada Activa` en magenta `#B43E8E`). - Incorporada mini-matriz interactiva de Aulas Presenciales en vivo con badges de estatus (`Libre` con botón de asignación directa o `Ocupada` con detalle de comisión y horario). - **Cálculo Real y Dinámico de Métricas de Ocupación (`/admin/occupancy_metrics`)**: - Eliminadas las constantes estáticas y mockeadas (aulas y pisos ficticios); ahora las métricas se computan en tiempo real contra los registros relacionales de la base de datos (`physicalRooms`, reservas activas, conteo de turnos reales Mañana/Tarde/Vespertino/Noche y distribución real por piso). - **Enriquecimiento Visual y Detalle en Últimos Eventos de Auditoría**: - Enriquecido el serializador del backend (`dashboard_service.py`) mapeando `action_label` y `module_label` en español institucional. - Rediseñada la tarjeta de auditoría en el Dashboard con avatar de usuario, badges semánticos por color de operación (`Acceso`, `Creación`, `Edición`, `Baja`, `Impersonación`), fecha/hora y renderizado del detalle explicativo (`audit.details`) que antes se encontraba omitido. - **Internacionalización y Modernización de Cabeceras (UI/UX)**: - Traducidos al español y modernizados los formularios de alta de aulas (`/classrooms/add_classroom`) y reservas (`/schedule/add_reservation`). - Rediseñada la cabecera tosca de `add_classroom` sustituyéndola por una tarjeta institucional con acento magenta `#B43E8E`, badges informativos y breadcrumbs ergonómicos. - Eliminada la opción redundante "Comisiones en Horario" del submenú de Reservas & Calendario para centralizar la gestión en Estructura Académica. ## [3.8.16] - 2026-10-26 ### Fixed - **Restauración y UX Nativa del Menú en Dispositivos Celulares / Móviles**: - Corregida la visibilidad de `.mobile-header` en pantallas menores a 992px resolviendo el conflicto de especificidad entre `@media` y reglas globales, restaurando el acceso al menú de navegación (`#mobileMenuBtn`) en celulares. - Implementado backdrop interactivo con desenfoque (`.sidebar-backdrop`) y cierre automático del menú al tocar el fondo o pulsar cualquier enlace de navegación. - Ocultación total blindada del sidebar fuera de pantalla en móvil (`left: -290px` con `width: 280px` y `overflow-x: hidden !important`). - **Visibilidad Completa de Opciones de Sesión en Modo Colapsado**: - Reemplazada la clase `.sidebar-submenu` por `.user-menu-list` en el menú de usuario, eliminando el ocultamiento accidental (`display: none !important`) en modo colapsado y asegurando que las opciones "Mi Perfil", "Cambiar Contraseña" y "Cerrar Sesión" permanezcan 100% visibles e interactivas. - Coordinada la apertura del menú de usuario con el cierre de otros flyouts para prevenir superposiciones. - **Corrección de Desborde y Superposición del Badge de Versión**: - Reestructurado el indicador de versión en un badge vertical compacto con `text-truncate` en el sidebar (`v3.8.16` en píldora y desglose secundario en línea inferior), eliminando el desborde horizontal de más de 400px que sobresalía y se superponía con elementos de la interfaz. - **Resolución de Error 404 en `/api/user/theme`**: - Creado endpoint dedicado `app.post(['/api/user/theme', '/theme'])` en Express BFF para atender la persistencia rápida de tema visual de usuario por AJAX, sincronizando transparentemente con FastAPI sin arrojar errores en la consola del navegador. ## [3.8.15] - 2026-10-26 ### Added - **Diseño Ergonómico de Footer y Menú de Usuario (Sidebar & Flyout)**: - Reubicado el botón de cambio de tema (`.theme-toggle-btn`) en el pie de la barra lateral (`sidebar-footer`), situado directamente sobre el botón de perfil del usuario con botón completo interactivo en modo expandido e icono centrado de 44x44px en modo colapsado. - Rediseñado el menú desplegable de usuario para coincidir con la interacción, elegancia y estética prolija de los demás submenús flyout (`.flyout-header`, subtítulo con rol/email, enlaces con iconos institucionales y hover suave). - En modo colapsado, el menú de usuario se despliega como un flyout lateral flotante hacia la derecha sin colisionar ni recortarse con el límite inferior de la pantalla. - Implementado ajuste dinámico de posición vertical (`adjustFlyoutPosition`) y `max-height: calc(100vh - 24px); overflow-y: auto;` para garantizar cero recortes de elementos en pantallas reducidas (1366x768 / 1280x720). ### Fixed - **Ocultación Total de Cabecera Móvil en Escritorio (`.mobile-header`)**: - Restringida la barra `.mobile-header` exclusivamente a pantallas `< 992px` mediante `d-lg-none` y `display: none !important;` en CSS, eliminando la interferencia visual y de espacio que afectaba la UI y UX en vista desktop. - **Cero Diagnósticos en Pyright / SQLAlchemy (`reservation_repository.py`)**: - Corregida la condición `only_virtual` reemplazando llamadas a propiedades Python por expresiones nativas SQLAlchemy ColumnElement (`and_(Reservation.virtual_link.is_not(None), Reservation.virtual_link != '')`, `Classroom.code.ilike('%VIRTUAL%')`, etc.), resolviendo al 100% los errores de `@[current_problems]`. - **Auditoría de Seguridad y SAST / SCA / DAST (`security_audit.bat`)**: - Actualizado `security_audit.bat` para escanear `backend\routers` junto con `backend\app` en Bandit y consultar la ruta OpenAPI `/openapi.json` de FastAPI. - Resueltas vulnerabilidades transitivas de npm mediante `npm audit fix` (0 vulnerabilidades). - Suite de seguridad 100% aprobada (`SECURITY AUDIT SUITE COMPLETED SUCCESSFULLY [PASS]`). - **Balance de Etiquetas HTML en Vistas**: - Reparado el cierre de contenedor en `classrooms/view.html` y de tarjeta/cabecera en `schedule/today.html`, logrando un balance perfecto de 52/52 plantillas sin discrepancias (`diff=0`). ## [3.8.14] - 2026-10-26 ### Added - **Filtrado Temporal y Resiliente en Listado de Reservas (`/schedule/list_reservations`)**: - Incorporado soporte de parámetros `scope` (`month`, `week`, `today`) y `only_virtual` en el backend FastAPI (`routers/reservations.py`, `ReservationService`, `ReservationRepository`). - Al pulsar "Sesiones del Mes" en la vista de aulas virtuales (`/classrooms/list_classrooms?view_mode=virtual`), el frontend BFF precarga las fechas de inicio (`YYYY-MM-01`) y fin de mes en los inputs del formulario y activa el switch "Solo Aulas Virtuales", desplegando de inmediato las 24 sesiones virtuales programadas del mes. - Añadido switch explícito "Solo Aulas Virtuales" y banner de filtro activo contextual en `schedule/list.html`. - **Desglose Claro de Espacios Áulicos (Físicas vs Virtuales)**: - En el Dashboard (`dashadm.html`), la tarjeta KPI de Aulas ahora desglosa con total transparencia los espacios: **3 físicas** en Edificio Central y **19 virtuales** a demanda del Campus Virtual, con accesos directos independientes a cada catálogo. - En la vista de aulas (`/classrooms/list_classrooms`), la vista presencial muestra "3 aulas presenciales encontradas" y la vista virtual indica "19 salas virtuales a demanda encontradas", clarificando los badges en las pestañas superiores. - **Persistencia y UX del Menú Lateral (Sidebar)**: - Removido el colapso forzado (`data-bs-parent="#sidebarNav"`). Al interactuar con un submenú, este permanece desplegado. - Implementada apertura automática del submenú correspondiente según la URL activa y persistencia de submenús abiertos en `localStorage` (`edu_sidebar_open_menus`). ### Fixed - **Contraste de Tarjeta KPI de Administradores (`/admin/users_list`)**: - Implementadas clases de estilo dedicadas en modo oscuro y claro (`.kpi-number-admin`, `.kpi-badge-admin`, `.kpi-icon-admin`) con contraste institucional púrpura de alta legibilidad. - **Reubicación Ergonómica del Botón de Modo Oscuro / Claro**: - Retirado el botón de cambio de tema de las pantallas de autenticación (`login.html` y `admin_login.html`). - Reubicado de forma ergonómica en el encabezado de la barra lateral (`sidebar-header`) junto al toggle de colapso, y en la cabecera móvil (`mobile-header`). - **Internacionalización y Textos en Español**: - Mapeo de roles en backend y frontend para mostrar consistentemente `Administrador` en lugar de `Admin` o `System Administrator`. - Traducido "Classroom Management System" por "Sistema de Gestión de Espacios Áulicos" y textos residuales en inglés. - **Balance de Estructura HTML**: - Sincronizados y verificados al 100% los tags `