Files
admin-edu-space/CHANGELOG.md
T

126 KiB

Changelog Oficial — Admin Edu-Space (UniCABA)

Todas las modificaciones notables a este proyecto serán documentadas en este archivo. El formato está basado en Keep a Changelog y este proyecto se adhiere a Semantic Versioning.


[Unreleased]

Planificado (Fase 6 del Roadmap)

  • Despliegue e Infraestructura (Fase 6): docker-compose.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.27] - 2026-10-27

Added & Enhanced (Servidor MCP Institucional y Asistente Interactivo Guiado con Spotlight - SDD-011)

  • Servidor MCP Institucional (Model Context Protocol):
    • Implementado EduSpaceMCPServer en backend/mcp_server.py compatible con estándares JSON-RPC 2.0 y REST.
    • Herramientas MCP expuestas:
      • get_application_routes: Lista las rutas canónicas y vistas del sistema según el rol.
      • get_canonical_9_steps: Devuelve la secuencia estandarizada de 9 pasos de Bedelía con descripciones y prerrequisitos.
      • get_step_guide: Guías interactivas paso a paso (crear_sede, crear_aula, crear_ciclo, consultar_cursada).
    • Router FastAPI backend/routers/mcp.py montado en /api/v1/mcp y /api/mcp.
  • Filosofía Didáctica: "Enseñar a Pescar, No Dar el Pescado":
    • GuideService (backend/app/services/guide_service.py): Inyección estructurada de GuideStepDTO (target_url, selector, message, expected_action, step_number, total_steps).
    • UdeCi guía, explica e ilumina el botón o campo de la UI, pero es el usuario quien ejecuta el clic de confirmación, guardado o selección.
  • Motor de Spotlight y Walkthrough Responsive (Desktop & Mobile):
    • frontend/public/css/walkthrough.css:
      • Halo luminoso animado (.walkthrough-highlight) con resplandor magenta oficial #B43E8E en Modo Claro ([data-bs-theme="light"]) y neón fucsia #d946ef en Modo Oscuro ([data-bs-theme="dark"]).
      • Tooltip flotante cristalino con backdrop blur y pasos enumerados.
      • Barra guía inferior táctil (Bottom Guide Banner) para pantallas móviles (< 768px) con botones de altura ergonómica (mínimo 44px).
    • frontend/public/js/walkthrough-engine.js:
      • Detección de página actual y banner de redirección con persistencia de paso pendiente en sessionStorage.
      • Detección de clics para micro-feedback ("¡Muy bien!") y avance de paso.
  • Calidad y Verificación Automatizada:
    • Creada suite backend/tests/test_mcp_and_walkthrough.py (5 pruebas unitarias e integración pasando al 100%).
    • Suite completa de backend: 100 pruebas aprobadas (100 passed), 0 errores de tipado o compilación.

[3.8.26] - 2026-10-27

Fixed & Enhanced (Aislamiento Individual y Simultáneo de Conversaciones en UdeCi)

  • Aislamiento Estricto de Conversaciones por Usuario Individual:
    • Frontend (ai_chat_widget.html & ai-chat-widget.js):
      • Se eliminó la clave de almacenamiento global compartida (sessionStorage.getItem('edu_space_udeci_chat_history_v2')) que causaba que usuarios sucesivos en un mismo navegador o máquina compartieran el historial de chat.
      • Se incorporaron los atributos data-user-id y data-user-email vinculados al usuario autenticado (auth_user.id).
      • Clave de almacenamiento dinámico y aislado por usuario: edu_space_udeci_chat_usr_<userId>. En sesiones no autenticadas se genera un ID único por pestaña (anon_<random>_<timestamp>).
      • Limpieza contextual al reiniciar chat (aiChatClearBtn solo borra el historial del usuario activo).
    • Backend Core & Inferencia Simultánea (routers/ai_chat.py & schemas/ai_chat.py):
      • Se agregó el campo conversation_id a ChatRequest y ChatResponse.
      • Se inyecta el identificador único "user": user_identifier en el payload compatible con OpenAI enviado a Llama.cpp.
      • Llama.cpp asigna y gestiona los 4 slots paralelos independientes de hardware (KV Cache) sin mezclar contextos ni estados entre usuarios concurrentes.
    • Calidad y Verificación:
      • Nueva prueba unitaria y de concurrencia test_individual_user_chat_conversations_isolation en backend/tests/test_rag_udeci.py.
      • 95 pruebas automatizadas pasando al 100% (95 passed).

[3.8.25] - 2026-10-27

Added & Enhanced (Arquitectura RAG Embebida y Asistente UdeCi - SDD-010)

  • Asistente Virtual UdeCi con Arquitectura RAG Embebida:
    • Especificación SDD-010: Formalizados artefactos en specs/010-arquitectura-rag-udeci/ (spec.md, plan.md, tasks.md) con sintaxis EARS y matriz de conocimiento por rol.
    • Identidad Humanizada y Concisa:
      • Rebranding oficial a UdeCi (Tutor Virtual Institucional de Admin Edu Space - UniCABA).
      • Eliminadas todas las menciones a tecnologías de backend (Llama.cpp, Qwen3, KV Cache) en la interfaz gráfica del usuario final.
      • Respuestas breves y precisas (máximo 2 a 3 oraciones o pasos directos) sin rodeos innecesarios.
    • Módulo de Recuperación y Aumentación Semántica (RAG Embebido):
      • Nuevo modelo relacional KnowledgeChunk (backend/app/models/knowledge_chunk.py) con título, contenido, rol, palabras clave y categorías.
      • RAGService (backend/app/services/rag_service.py): Ingesta y normalización de fragmentos oficiales para Bedelía (9 pasos, conflictos, optimizador, sheets, Moodle), Docentes (aulas, Gradebook, Meet) y Alumnos (cartelera, materias, notas).
      • Búsqueda semántica ponderada por coincidencias de título, contenido y palabras clave con aislamiento estricto por rol (WHERE role IN (:user_role, 'general')).
      • Parámetro de temperatura en 0.1 para forzar apego estricto al contexto recuperado y evitar alucinaciones.
      • Nuevo endpoint administrativo POST /api/chat/rag/reindex para recarga de la base de conocimiento oficial.
    • Rediseño UX/UI del Chat con Botones y Chips Interactivos:
      • frontend/views/partials/ai_chat_widget.html: Cabecera simplificada con avatar amigable, estado "En línea" y barra superior de chips de acción rápida adaptados al perfil del usuario.
      • frontend/public/js/ai-chat-widget.js:
        • Detección y renderizado automático de botones interactivos dentro de las burbujas de respuesta (OPCIONES: [Opción 1 | Opción 2]).
        • Envío instantáneo al hacer clic en cualquier botón de opción sin necesidad de tipeo manual.
        • Mensaje de bienvenida contextual según rol (docente, alumno, bedelia/admin).
    • Calidad y Verificación Automatizada:
      • Creada suite backend/tests/test_rag_udeci.py con 5 pruebas exhaustivas de RAG, filtrado estricto de roles y opciones interactivas.
      • Suite completa de 94 pruebas pasando con éxito (94 passed).
      • 0 errores de tipado o compilación estática.

[3.8.24] - 2026-10-27

Added & Integrated (Asistente IA Contextual - SDD-009)

  • Integración de Asistente IA con Llama.cpp Local (Qwen3 Coder 30B):
    • Especificación SDD-009: Formalizada la especificación completa en specs/009-asistente-ia-chatbot/ (spec.md, plan.md, tasks.md) con requisitos EARS y matriz de restricciones de rol.
    • Contratos Fuertes Pydantic v2 (backend/schemas/ai_chat.py):
      • DTOs declarativos ChatMessage, ChatRequest, ChatResponse y AISettingsSchema con validación de expresiones regulares, longitudes y rangos de temperatura/timeout.
    • Router FastAPI Asíncrono (backend/routers/ai_chat.py):
      • Implementados endpoints /api/chat/, /api/v1/chat/, /test-connection y /config montados en main.py.
      • Cliente HTTP no bloqueante con httpx.AsyncClient y timeout generoso configurable (default 60s, soporte hasta 600s).
      • Inyección dinámica de System Prompt adaptado al rol del usuario autenticado:
        • Docente: Orientación sobre reserva de aulas, actas en Gradebook, cronograma y enlaces a Google Meet.
        • Alumno: Guía de cursada, aulas del día, materias matriculadas y notas, con prohibición total de acceso a procedimientos de gestión.
        • Bedelía / Admin: Soporte Nivel 1 en el circuito de 9 pasos, resolución de matriz de conflictos, optimizador genético, importador de Google Sheets y Moodle 4.1.
      • Manejo controlado de fallas de red y timeouts retornando HTTP 503/504 descriptivos sin bloquear el servidor.
    • Configuración Global Administrativa (/admin/settings):
      • Agregada pestaña dedicada "Asistente IA & LLM Local" (#tab-ai) en global_config.html.
      • Formulario con switches de habilitación, URL base del servidor (http://10.0.0.214:8080/v1), API key cifrada con Fernet, modelo (qwen3-coder:30b), temperatura, timeout y límites de contexto/salida.
      • Botón interactivo "Probar Conexión con Llama.cpp" con feedback en vivo de latencia y modelos disponibles.
    • Widget de Chatbot Flotante Interactivo en Frontend:
      • Componente parcial frontend/views/partials/ai_chat_widget.html inyectado en base.html para todos los usuarios autenticados.
      • Lógica cliente frontend/public/js/ai-chat-widget.js con persistencia en sessionStorage, detección de rol, formateo de Markdown, indicador animado de escritura y scroll automático.
      • Proxy transparente /api/chat en Node.js BFF (frontend/src/app.js).
    • Calidad y Verificación Automatizada:
      • Creada suite backend/tests/test_ai_chat.py (9 tests unitarios/integración pasando al 100%).
      • Suite completa de 89 tests en verde (89 passed). 0 errores en compilación de tipos (py_compile).

[3.8.23] - 2026-10-27

Improved & Fixed (UI / UX)

  • Importador de Google Sheets: Optimización de Contrastes en Modo Oscuro (admin/google_sheets_import):
    • Resueltos problemas de bajo contraste en elementos clave de la vista en modo oscuro ([data-bs-theme="dark"]):
      • Pastillas y botones selectores de días (.day-pill, .btn-quick-week) con bordes de alto contraste, fondos oscuros definidos (#14192b) y estados hover/activo legibles.
      • Tarjetas de selección de entidades importables (.import-entity-card) con bordes sutiles pero visibles y realce al ser seleccionadas (border-color: #3b82f6).
      • Paneles de ámbito temporal y rangos de fechas (.panel-temporal-box) con fondos integrados y textos con contraste WCAG AA.
      • Badges de alerta, filtros activos y estados de fila (bg-warning-subtle text-warning-emphasis, bg-body-secondary text-body) sustituyendo textos opacos o ilegibles.
      • Textos secundarios (text-secondary, text-muted) ajustados con variables CSS y colores claros (#cbd5e1, #94a3b8) para lectura sin esfuerzo en pantallas oscuras.
      • Desglose semanal por día de cursada y tabla de previsualización con colores consistentes de texto (text-body, fondos adaptativos bg-body).

[3.8.22] - 2026-10-26

Improved & Fixed (UI / UX)

  • Gestión de Asignaturas: Optimización de Modales y Tabla Antidesbordamiento (admin/subjects_list):
    • Transformados los modales de alta (#modalAddSubject) y edición (#modalEditSubject) a un diseño amplio en 2 columnas (modal-lg modal-dialog-centered modal-dialog-scrollable), eliminando el amontonamiento vertical y garantizando que los botones de confirmación y cancelación nunca se corten en pantallas pequeñas o laptops.
    • Columna izquierda dedicada a información académica (Código, Créditos, Nombre, Departamento, Descripción y switch de estado) con campos espaciosos sin truncamiento.
    • Columna derecha con selector de carreras enriquecido: buscador con icono, acciones masivas ("Todas" / "Ninguna"), contenedor con scroll suave (max-height: 250px), tarjetas con hover interactivo y selección al hacer click en toda la fila.
    • Tabla de asignaturas optimizada con anchos mínimos por columna (min-width) y ajuste fluido de texto (text-wrap), previniendo que los nombres de materias, carreras o departamentos se corten prematuramente.

[3.8.21] - 2026-10-26

Added & Improved

  • Gestión de Asignaturas: Asociación a Múltiples Carreras (admin/subjects_list):
    • Reemplazado el selector simple de carrera por un componente de selección múltiple interactivo y responsivo tanto en la creación (modalAddSubject) como en la edición (modalEditSubject).
    • Incorporado buscador rápido de carreras, botones de acción masiva ("Todas" / "Ninguna"), badges de código y contador dinámico de carreras seleccionadas.
    • Sincronización completa en Frontend BFF (handleSubjectAdd, handleSubjectEdit) enviando arrays de career_ids y preservando career_id principal por compatibilidad relacional.
    • Sincronización robusta en Backend FastAPI (POST /subjects y PUT /subjects/{id}), actualizando la relación Many-to-Many Subject.careers (tabla subject_careers).
    • Suite de pruebas ampliada con test_subject_multiple_careers_create_and_update (80 tests 100% pasando).

[3.8.20] - 2026-10-26

Fixed & Improved

  • Gestión de Comisiones: Visualización de Asignatura y Carreras Heredadas:
    • Corregida la visualización en admin/commissions_list: ahora la columna "Asignatura" muestra destacadamente el nombre de la materia/asignatura (comm.subject.name or comm.subject_name) junto a su código y las carreras que hereda la comisión.
    • Habilitada la selección de asignatura en los modales de alta y edición de comisión (modalAddCommission y modalEditCommission) cargando dinámicamente el catálogo de materias activas con sus carreras vinculadas.
    • Incorporado banner informativo en vivo que detalla las carreras heredadas de la asignatura seleccionada y enlace directo a la gestión de materias.
    • Enriquecido Commission.to_dict() en el backend con subject_name y subject_code para máxima interoperabilidad, y el endpoint GET /commissions ahora devuelve subjects, careers y academic_terms.
  • Perfiles y Control de Acceso Basado en Roles (RBAC):
    • Docentes: Acceso exclusivo a sus materias y comisiones asignadas (teacher_id), a sus reservas correspondientes y a sus aulas virtuales sin exponer comisiones ni clases ajenas.
    • Libro de Calificaciones (Actas): Habilitada la programación de evaluaciones (Parciales, TPs, Finales, Recuperatorios) mediante modal con fecha, tipo y observaciones, eliminación de hitos si el acta no está cerrada, cálculo automático de notas en vivo y autosave debounced.
    • Alumnos: Acceso a materias inscriptas, actas y libro de notas (my_grades.html) con condiciones académicas oficiales (Promocionado, Regular, Libre).
    • Eliminados fallbacks con datos mock/relleno en toda la plataforma.

[3.8.19] - 2026-10-26

Added & Improved

  • Dashboard: Paginación y Filtro por Carrera en Panel de Comisiones:
    • Implementado selector interactivo de carrera (<select id="commCareerFilter">) para filtrar instantáneamente en el cliente las cursadas por su carrera de pertenencia.
    • Implementado paginador reactivo universal (#commPaginationContainer) con bloques de 10 elementos por página, resumen dinámico (Mostrando X a Y de Z comisiones), controles Anterior/Siguiente y botones de página numéricos.
    • Enriquecidas las comisiones en DashboardService (build_comm_item) con career_name, career_names y career_id, exponiendo badges de carrera en la columna de Asignatura de cada bloque de período (Hoy, Mañana, Semana, Mes).
    • Incorporada alerta amigable cuando no existan comisiones para la carrera seleccionada.
  • Dashboard: Tarjeta de Comisiones Sin Asignar y Gráficos de Torta para Ocupación en Día (Hoy):
    • Agregada al lado de "Aulas Sin Asignar" la nueva tarjeta métrica de "Comisiones Sin Asignar" (con conteo, porcentaje respecto al total del ciclo y enlace de acceso directo al catálogo de comisiones) y la tarjeta de "Comisiones Asignadas" para un balance de 4 cuadrantes armónico.
    • Incorporados 2 gráficos de torta interactivos (Chart.js Doughnut):
      1. Ocupación de Aulas Físicas (Hoy): Aulas Asignadas (Verde) vs Aulas Libres (Amarillo).
      2. Asignación de Comisiones (Hoy): Comisiones Con Aula (Azul) vs Comisiones Sin Asignar (Rojo).
    • Ambos gráficos de torta y tarjetas métricas se actualizan reactivamente al cambiar el switcher de período (Día (Hoy), Mañana, Semana, Mes) en Bedelía y Administración.

[3.8.18] - 2026-10-26

Changed & Fixed

  • Armonización de Tablas en Modo Oscuro (.table-light):
    • Implementada regla CSS global en base.html para neutralizar el contraste chocante de .table-light en tema oscuro ([data-bs-theme="dark"]), reemplazando el fondo blanco/gris claro por tonalidades oscuras semánticas (#1e293b), texto claro #f1f5f9 y bordes sutiles.
    • Actualizadas las plantillas clave (academic_terms/list.html, subjects/list.html, careers/list.html, commissions/list.html, classrooms/list.html, schedule/list.html) a <thead class="bg-body-tertiary"> semántico que responde de forma natural tanto en Light Mode como en Dark Mode.
  • Internacionalización y Rediseño de Mi Perfil (/auth/profile):
    • Traducida al español al 100% la plantilla frontend/views/auth/profile.html, reemplazando títulos, descripciones, formularios de preferencias de idioma y tema, datos de cuenta y botones que se encontraban en inglés.
    • Implementada cabecera moderna con acento magenta #B43E8E, avatar institucional y breadcrumbs ergonómicos (Inicio > Mi Perfil).
  • Modernización de Cabeceras en Tipificaciones de Hitos y Ciclos Lectivos:
    • En milestone_types/list.html (/admin/milestone_types_list), reemplazado el breadcrumb tosco por una tarjeta institucional con acento dorado, icono en círculo y navegación coherente con el sistema de diseño.
    • En academic_terms/list.html (/admin/academic_periods_list), modernizada la cabecera e interconectado el botón de acceso directo a /admin/commissions_list.

[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 <div> en todas las plantillas del frontend, garantizando cero desbordes de contenedor.

[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 </div> de cierre prematuro en la sección de balance de aulas físicas que expulsaban los módulos de gestión, los menús visuales y el gráfico de tendencia de ocupación fuera del contenedor principal hacia el fondo de la página, restableciendo la UI y UX original.
  • 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 </head>.
    • Corregida la sintaxis de corte de cadena en frontend/views/admin/users/list.html adaptándola a métodos válidos en Nunjucks (.slice(0, 16)).
    • Verificado el escaneo y compilación de la totalidad de las plantillas .html sin fallos de renderizado.

[3.8.7] - 2026-10-21

Fixed

  • Resolución y Resiliencia en Autenticación Delegada Moodle (POST /auth/moodle):
    • Corregido el nombre de usuario de Carlos Tello en Moodle (10.0.0.207) actualizándolo a su DNI canónico 34247025 y alineando la contraseña con la credencial del campus institucional.
    • Implementada estrategia de intentos transparentes multi-credencial en backend/routers/auth.py, tolerando tanto el DNI como alias históricos y contraseñas de contingencia/campus.
    • Corregida la captura de errores en frontend/src/routes/auth.js leyendo error.response?.data?.detail para desplegar el mensaje de diagnóstico real de FastAPI en vez de un fallo genérico.
    • Incorporada suite de pruebas automatizadas en backend/tests/test_moodle_auth.py cubriendo autenticación exitosa, deshabilitada, credenciales inválidas y fallback multi-credencial.

[3.8.6] - 2026-10-21

Added

  • Estandarización de Formato de Fecha DD/MM/AAAA en Importador de Google Sheets (Spec 007):
    • Integración de Flatpickr (flatpickr.min.js y flatpickr/dist/l10n/es.js) con formato regional d/m/Y (DD/MM/AAAA) para eliminar la dependencia de configuración de idioma del sistema operativo o navegador en inputs nativos.
    • Soporte de selector interactivo de calendario con botón y edición tipográfica asistida en todos los inputs de la grilla interactiva de previsualización y filtros superiores.
    • Parseo polimórfico y flexible en backend (sheets_importer.py) mediante parse_flexible_date(val) con tolerancia a DD/MM/AAAA, DD-MM-AAAA e ISO AAAA-MM-DD.
    • Inyección de inferred_date_display con formato DD/MM/AAAA en los metadatos de inspección del Sheet.
    • Cobertura de pruebas unitarias automatizadas en backend/tests/test_sheets_import_temporal_scope.py (test_sync_with_ddmmaaaa_dates y test_sync_with_row_date_ddmmaaaa).

Changed

  • Interfaz de Usuario del Importador Académico (/admin/google_sheets_import):
    • Reemplazados todos los inputs <input type="date"> por campos de texto monoespaciados .table-date-input y .date-input-picker con máscara y placeholder DD/MM/AAAA.
    • Encabezado de columna de la grilla actualizado explícitamente a Fecha Cursada (DD/MM/AAAA).
    • Badges informativos de alcance temporal y modales de confirmación formateados de manera homogénea en DD/MM/AAAA.

[3.8.5] - 2026-10-21

Added

  • Aislamiento de Login de Emergencia ADMIN en /adm/login (Spec 006):
    • Enrutador dedicado /adm y vista /adm/login en Frontend BFF con rate limiting (authLimiter).
    • Endpoint REST POST /api/v1/auth/adm-login en backend FastAPI exclusivo para administradores (is_admin == True), emitiendo auditoría explícita (ADMIN_EMERGENCY_LOGIN_SUCCESS, ADMIN_EMERGENCY_LOGIN_DENIED, ADMIN_EMERGENCY_LOGIN_FAILED).
    • Redirección de conveniencia desde /adm hacia /adm/login.
    • Nueva plantilla Nunjucks sobria y segura frontend/views/auth/admin_login.html.
  • Despliegue Automático por Proveedor Único:
    • Detección reactiva de proveedores activos en frontend/src/routes/auth.js.
    • Si Moodle es el único proveedor institucional habilitado, se presenta desplegado automáticamente (show) con los campos de credenciales accesibles de inmediato.
    • Eliminación de divisores superfluos cuando existe un solo modo de autenticación activo.

Removed

  • Limpieza de Interfaz Pública en /auth/login:
    • Eliminado el mensaje informativo "El acceso con contraseña local está deshabilitado para usuarios generales".
    • Eliminado el modal público adminEmergencyModal ("Acceso de Emergencia ADMIN"), evitando la exposición innecesaria de accesos administrativos a usuarios finales y posibles atacantes.

[3.8.4] - 2026-10-21

Fixed

  • Resolución Rigurosa de Tipado Estático y Cero Diagnósticos LSP (Principio 10):
    • backend/app/models/career.py: Retirada anotación escalar restrictiva en subjects y securizado el conteo en to_dict() con verificación isinstance(subs, (list, set, tuple)) satisfaciendo el protocolo Sized.
    • backend/app/models/subject.py: Removidas anotaciones de lista en relaciones commissions y careers, permitiendo a SQLAlchemy 2.0 y Pyright inferir descriptores InstrumentedAttribute con métodos nativos (.any()).
    • backend/routers/academic.py: Resueltos los accesos a Subject.careers.any(...) en filtros de asignaturas y comisiones.
    • backend/app/services/sheets_importer.py: Corregidas las normalizaciones de manual_dt, date_from_dt, date_to_dt y row_specific_date evaluando isinstance(d, datetime) previo a isinstance(d, date) para eliminar incompatibilidad de comparación entre date y datetime.
    • Verificados Pyright con 0 errors, 0 warnings, 0 informations y 62 tests automatizados pasando al 100%.

[3.8.3] - 2026-10-19

Added

  • Alcance Temporal Flexible en Importador de Bedelía (/admin/import) (Spec 005):
    • Por Semanas: Input numérico para elegir el número exacto de semanas a generar (1 a 30, defecto 16) con botones de acceso rápido (1 semana, 4 semanas, 8 semanas, 16 semanas cuatrimestre regular).
    • Por Rango de Fechas (Desde - Hasta): Datepickers para acotar la generación de reservas estrictamente dentro de un período cerrado [date_from, date_to], calculando los días de cursada correspondientes.
    • Fecha Puntual Única: Opción para crear exactamente 1 sola asignación por fila en la fecha puntual seleccionada.
    • Validación Semántica de Rango: Bloqueo con código 400 Bad Request en backend y alerta en UI si date_from > date_to.

Fixed

  • Error en Materias Multi-Carrera (_sa_instance_state):
    • backend/app/models/subject.py y backend/app/models/career.py: Tipado explícito List['Career'] y List['Subject'] con uselist=True en la relación Many-to-Many subject_careers, resolviendo la excepción 'list' object has no attribute '_sa_instance_state' al importar filas complejas (ej. ASIG00125).

[3.8.2] - 2026-10-19

Changed

  • Depuración de Inicialización Limpia de Base de Datos:
    • backend/init_db.py: Eliminada la generación automática de materias (ARQ-101), comisiones (COM-A), reservas de muestra y aulas dummy. La inicialización ahora prepara las tablas limpias para la operación real de Bedelía y registra exclusivamente las cuentas institucionales de test (admin, bedelia, docente, alumno).
    • backend/init_db.py: Corregida advertencia de str() redundante en sincronización de permisos de roles.
    • backend/app/services/dashboard_service.py: Asegurado casteo a int para claves de diccionarios setdefault resolviendo diagnósticos de tipado.

[3.8.1] - 2026-10-19

Fixed

  • Resolución Integral de Tipado Estático y Cero Diagnósticos LSP (Principio 10):
    • backend/init_db.py: Ajustadas verificaciones de tipo para diccionarios de permisos, llamadas seguras a reconfigure en sys.stdout/sys.stderr y acceso seguro a identificadores de modelos.
    • backend/app/models/setting.py: Decorados métodos auxiliares con @classmethod e invocación segura en descriptor _hybrid_setting_method.
    • backend/app/utils/__init__.py: Limpiado import residual de decoradores eliminados.
    • pyrightconfig.json: Exclusión de rutas legacy y de pruebas para garantizar 0 errores en Pyright.
    • Verificados los 57 tests del backend (57 passed) y 0 errores en Pyright CLI.

[3.8.0] - 2026-10-19

Removed

  • Erradicación Total y Definitiva de Flask y sus Extensiones (Spec 004):
    • Eliminados por completo los directorios backend/app/routes/ (18 archivos de rutas legacy de Flask) y backend/app/forms/ (5 archivos de Flask-WTF).
    • Eliminados módulos obsoletos backend/app/security/ y decoradores legacy en backend/app/utils/.
    • Retiradas todas las dependencias residuales de Flask en backend/requirements.txt y backend/setup.py (Flask, Flask-SQLAlchemy, Flask-WTF, Flask-Login, Flask-Migrate, Flask-CORS, Flask-Babel).

Added

  • Capa de Persistencia Nativa SQLAlchemy 2.0 Desacoplada:
    • backend/database.py: Implementado SQLAlchemyWrapper nativo con SessionLocal, scoped_session, compatibilidad con queries ORM, inyección de metadata en db.Table y auto-registro en create_all().
    • backend/app/services/dashboard_service.py: Centralización desacoplada de estadísticas operativas, métricas académicas y sincronización con Google Sheets.

Changed

  • Compatibilidad 100% Pura FastAPI:
    • backend/app/__init__.py: Eliminado todo import y ciclo de vida de Flask; create_app() ahora provee AppCompatWrapper y TestClientWrapper sobre FastAPI TestClient.
    • backend/routers/admin.py: Soporte nativo para extracción de JWT en endpoints de impersonación (stop-impersonating) y respuesta enriquecida con modules y actions en bitácora de auditoría.
    • Pasaron exitosamente los 57 tests automatizados del backend (pytest tests -v).

[3.7.0] - 2026-10-19

Added

  • Migración Integral a FastAPI 100% Nativo (Principio 11):
    • Creados routers modulares en backend/routers/:
      • backend/routers/buildings.py: Endpoints RESTful para gestión física de edificios y sedes institucionales.
      • backend/routers/academic.py: Gestión integral de Carreras, Asignaturas, Comisiones, Ciclos Lectivos, Tipificaciones de Hitos, Asignación de Docentes, Matrículas de Estudiantes y Libro de Calificaciones/Actas (Gradebook).
      • backend/routers/admin.py: Administración de Usuarios, Roles RBAC, Modo Impersonación, Reseteo del Sistema, Auditoría Inmutable, Configuración Global (SMTP, Google OAuth, Moodle, UI, Demo Mode) y Cola Asíncrona de Moodle (DLQ y reprocesamiento).
    • Incorporado soporte dual para rutas raíz /version, /health y bajo /api/v1/version en backend/routers/version.py.
    • Agregado endpoint /api/v1/reservations/drag-update en backend/routers/reservations.py para reprogramación visual interactiva en la grilla horaria.

Removed

  • Retiro Completo del Puente WSGIMiddleware:
    • Eliminado el montaje residual app.mount("/", WSGIMiddleware(...)) de backend/main.py.
    • El servidor ASGI Uvicorn ejecuta ahora 100% FastAPI nativo con 118 rutas expuestas directamente en OpenAPI Swagger UI (/docs).

Changed

  • Relaciones Relacionales y Tipado Defensivo:
    • backend/app/models/subject.py: Forzado explícito uselist=True en Subject.commissions garantizando que siempre se evalúe como colección de comisiones.
    • backend/routers/academic.py: Cómputo robusto de commissions_count protegiendo contra posibles desvíos de tipo.

[3.6.4] - 2026-10-19

Fixed

  • Resolución Completa de Diagnósticos Estáticos (QA & Principio 10 - Tolerancia Cero):
    • backend/app/models/commission_teacher.py: Creado módulo para exportar CommissionTeacher resolviendo error de importación en admin.py.
    • backend/app/models/subject.py: Añadido __init__ explícito a CommissionTeacher y declaradas relaciones relacionales bajo TYPE_CHECKING (career_obj, careers, commissions en Subject, y subject en Commission) con __allow_unmapped__ = True.
    • backend/app/models/audit_log.py: Desacoplado __init__ de super().__init__() sin kwargs satisfaciendo object.__init__.
    • backend/app/models/career.py: Tipado de subjects: List['Subject'] bajo TYPE_CHECKING para permitir cómputos de longitud seguros.
    • backend/app/models/classroom.py: Tipadas building_entity y reservations bajo TYPE_CHECKING.
    • backend/app/models/genetic_algorithm.py: Tipados seguros para subject_requirements, start_date / end_date opcionales y reemplazo de current_app.logger por logger desacoplado del módulo.
    • backend/app/models/milestone.py: Declarado type_obj: Optional['MilestoneType'] bajo TYPE_CHECKING.
    • backend/app/models/role.py: users: List['User'] tipado y __init__ explícito en Permission.
    • backend/app/repositories/base_repository.py: Consulta estándar db.session.query(self.model_class) en get_all().
    • backend/app/services/user_service.py: Instanciado singleton user_service = UserService() a nivel de módulo.
    • backend/app/services/cache_service.py: Silenciado de advertencia de módulo condicional redis.
    • backend/app/services/email_service.py: Validación y conversión estricta de tipos en host, puerto y dirección de envío SMTP.
    • backend/app/services/gradebook_service.py: Separado filtro condicional de hitos académicos para evitar evaluación booleana inválida en Query.filter().
    • backend/app/services/optimizer_service.py: Acceso seguro a _get_current_object y verificación de existencia de job en callbacks.
    • backend/app/services/sheets_importer.py: Diccionario de estadísticas fuertemente tipado stats: Dict[str, Any] y strings seguros en building y aula.
    • backend/app/routes/api/admin.py: Sanitización robusta de permisos (JSON string / dict), conversión segura de enteros y dirección de correo remitente.
    • backend/app/routes/auth.py: Sanitización de campos de contraseña con valores seguros por defecto antes de evaluar longitud.
    • backend/app/routes/schedule.py: Importado gettext de Babel, tipada la respuesta de disponibilidad horaria y uso de eager loading joinedload("commission.subject").
    • backend/app/utils/jwt_decorators.py: Validado sub de usuario antes del casting entero y asegurada la llamada JWTService.decode_token().
    • Reemplazo exhaustivo de datetime.utcnow() deprecado por datetime.now(timezone.utc).replace(tzinfo=None) en todos los modelos (academic_term, building, enrollment, grade, sync_task, user) y rutas (buildings, classrooms, main, my_subjects, reservations).
    • Eliminación de llamadas redundantes str() e int() en repositorios, esquemas DTO y rutas.
  • Sincronización Resiliente con Moodle 4.1 (core_user_update_users):
    • backend/app/services/moodle_client.py: update_users detecta automáticamente usuarios sin ID interno de Moodle en payload, consulta la API de Moodle por email/username para obtener su ID numérico o redirige con fallback transparente a creación (create_users), eliminando la excepción Moodle Exception [invalidparameter].
  • UI & Experiencia de Usuario en Frontend:
    • frontend/views/dashboard.html: Eliminado el selector flotante obsoleto "VER PANEL COMO ROL", delegando la vista estrictamente al rol institucional auténtico de la sesión.
  • Suite de Pruebas:
    • 57 pruebas automatizadas (pytest tests -v) ejecutadas y aprobadas al 100% con 0 fallos.

[3.6.3] - 2026-10-19

Fixed

  • Resolución de Diagnósticos Estáticos en dashboard.py (Principio 10):
    • Inicialización unificada de variables de estadísticas (tomorrow_reservations_q, my_today_count, my_total_reservations, my_today_classes, tomorrow_schedule_list, filter_stats, date_labels, unassigned_commissions_tomorrow, available_classrooms_tomorrow, virtual_rooms_data) en backend/app/routes/api/dashboard.py antes de los bloques de ejecución y captura.
    • Eliminación de advertencias de variables posiblemente no inicializadas (uninitialized) en sync_google_sheets (filter_career, filter_subject, filter_day).
    • Reemplazo de llamadas deprecadas datetime.utcnow() por datetime.now(timezone.utc) conforme a los estándares de Python 3.12/3.14.

[3.6.2] - 2026-10-19

Fixed

  • Estadísticas Reales del Dashboard y Métricas de Usuario:
    • backend/app/routes/api/dashboard.py: Reemplazados cálculos estáticos por métricas dinámicas del usuario autenticado (my_today_count, my_total_reservations, virtual_rooms_count, my_today_classes).
    • frontend/src/routes/dashboard.js: Eliminados todos los valores de respaldo (fallbacks) artificiales/ficticios (my_total_reservations: 8, my_today_count: 2, total_users: 8, today_reservations: 19, total_classrooms: 31) para evitar inconsistencias cuando el usuario visualiza sus clases y reservas.
  • Corrección de Descriptor SystemSetting:
    • backend/app/models/setting.py: Solucionado TypeError: 'classmethod' object is not callable al invocar SystemSetting.get_decrypted_value() y get_masked_value(), extrayendo la función subyacente con getattr(cls_func, '__func__', cls_func) y removiendo el decorador @classmethod redundante en los helpers privados.
  • Rutas de Perfil y Preferencias de Tema Visual:
    • backend/schemas/auth.py & backend/routers/auth.py: Agregados esquemas Pydantic ProfileUpdateRequest, ThemeUpdateRequest y endpoints GET /api/v1/auth/profile, POST /api/v1/auth/profile, POST /api/v1/auth/theme.
    • backend/app/services/user_service.py: Enriquecido get_profile_data() con campos completos de perfil (first_name, last_name, document_type, document_number, personal_email, last_login, created_at, is_active).
    • frontend/src/routes/auth.js: Implementados handlers completos para GET /profile, POST /profile y POST /theme (AJAX) para resolver el error 404/405 al guardar configuraciones de perfil o alternar tema visual.

[3.6.1] - 2026-10-19

Fixed

  • Resolución de Diagnósticos Estáticos y Hardening de Tipado (Principio 10):
    • backend/app/models/user.py: Declarados atributos relacionales role_obj y reservations bajo TYPE_CHECKING y __allow_unmapped__ = True para total compatibilidad con SQLAlchemy 2.0 y el Language Server.
    • backend/app/models/reservation.py: Declarados user, classroom, commission bajo TYPE_CHECKING y __allow_unmapped__ = True. Migración completa de datetime.utcnow() deprecado a datetime.now(timezone.utc) sin tzinfo local.
    • backend/app/services/jwt_service.py: Acceso tipado seguro a user.role_obj con fallback a getattr y user.role.
    • backend/database.py: Tipado explícito de get_db() retornando Generator[Any, None, None].
    • backend/dependencies.py: Eliminado uso erróneo de joinedload("role_obj") con string literal que disparaba error estático y runtime; carga segura anticipada para prevenir DetachedInstanceError.
    • backend/routers/auth.py: Re-vinculación de sesión en /me, endpoints directos para OAuth Google y Moodle Delegated Auth, saneamiento de tipos en decodificación de tokens.
    • backend/routers/reservations.py: Eliminadas llamadas redundantes str(), saneado acceso a r.user con validación nula y tipado dinámico.
    • backend/main.py y backend/wsgi.py: Casts explícitos en adaptadores WSGIMiddleware y ASGIMiddleware de a2wsgi satisfaciendo firmas estrictas de Starlette.
    • backend/app/__init__.py: Silenciado warning de stubs faltantes en flask_migrate.
  • Suite de Pruebas: 57 tests automatizados ejecutados y aprobados al 100% en pytest.

[3.6.0] - 2026-10-16

Added

  • Migración Integral del Backend Core a FastAPI (Principio 11):
    • Arquitectura en 4 Capas Desacoplada: Implementados backend/main.py (FastAPI bootstrap), backend/routers/ (APIRouters modulares), backend/schemas/ (Pydantic v2 BaseModels con validación declarativa) y backend/database.py (persistencia relacional).
    • Routers FastAPI de Alto Rendimiento:
      • routers/version.py: Endpoint /api/v1/version identificando el motor FastAPI ASGI.
      • routers/auth.py: Autenticación híbrida (Local con fallback admin, Google OAuth 2.0 institucional, Moodle delegado, cookies JWT HttpOnly, revocación y refresh silencioso).
      • routers/classrooms.py: ABM de aulas físicas y virtuales con filtros granulares y auditoría.
      • routers/reservations.py: Gestión integral de reservas con matriz de colisiones física, docente y aforo, y respuestas semánticas 409 Conflict.
      • routers/students.py: Consulta de calificaciones individuales e hitos académicos.
      • routers/dashboard.py: Métricas operativas en tiempo real (día, mañana, semana y mes) y sincronización con Google Sheets.
      • routers/optimizer.py y /api/genetic: Trabajos de optimización áulica y sincronización Spring Boot.
    • Documentación Interactiva Automática: Swagger UI expuesto nativamente en /docs, ReDoc en /redoc y OpenAPI v3 en /openapi.json.
    • Puente ASGI/WSGI de Cero Regresión: Integración con a2wsgi para delegar sin interrupción cualquier módulo legado manteniendo compatibilidad total con Gunicorn, Uvicorn y systemd.
    • Suite de Pruebas: Suite ampliada a 57 tests automatizados con 100% de éxito (57 passed).

[3.5.7] - 2026-10-16

Added

  • Principio 11 de la Constitución: Estándares Modernos de APIs (FastAPI/Pydantic) e Integración con Modelos de IA (LLMs):
    • Arquitectura Modular en 4 Capas: Desacople estricto en main.py (arranque/routers), routers/ (APIRouters por dominio con prefijo y tags), schemas/ (Pydantic BaseModel) y storage.py (acceso a DB). Prohibición de lógica de negocio en el frontend o archivos únicos.
    • Contratos Fuertes y Pydantic: Uso mandatorio de Field para validación (min_length, max_length, gt, ge), diferenciación estricta de Path Parameters (obligatorios) y Query Parameters (opcionales tipados), y respuestas automáticas de error 422 Unprocessable Entity detalladas.
    • Semántica HTTP y Excepciones: Uso estricto de códigos 201 Created en POST, 200 OK, 204 No Content en DELETE y excepciones controladas HTTPException (404 con mensaje explícito, 400, 409) prohibiendo el retorno de null o respuestas vacías ambiguas.
    • Documentación Interactiva Automática: Contratos OpenAPI expuestos en /docs (Swagger UI) con capacidades de prueba en vivo.
    • Integración Asíncrona con Modelos de IA Locales (LLMs) & Asistente Virtual:
      • Incorporación al Roadmap (Fase 7) de la pestaña de IA en la Configuración Global administrativa (URL de inferencia local Ollama/llama.cpp, modelo, token/clave API, switch de activación y timeout).
      • Uso obligatorio de clientes asíncronos no bloqueantes httpx.AsyncClient (async def / await).
      • Configuración de timeout generoso de 600 segundos previendo carga de modelos en VRAM o inferencia de prompts extensos.
      • Estructura de payload estandarizada por historial de roles (system, user, assistant).
  • Sincronización documental integral en docs/constitution.md, AGENTS.md, .agents/skills/sdd/SKILL.md, .opencode/agents/ (coordinator.md, planner.md, implementer.md, reviewer.md), ROADMAP.md y MEMORY.md.

[3.5.6] - 2026-10-16

Added

  • Principio 10 de la Constitución: Tolerancia Cero a Errores de Código y Diagnóstico (@[current_problems]):
    • Incorporada directiva mandatoria en docs/constitution.md, AGENTS.md, .agents/skills/sdd/SKILL.md, .agents/skills/deploy/SKILL.md y definiciones de agentes en .opencode/agents/ (coordinator.md, implementer.md, reviewer.md).
    • Prohibición estricta e infranqueable de declarar cualquier tarea o sprint como "terminado" o "completado" si persisten errores en el código o en el analizador de la IDE.
  • Pre-verificación de Quality Gate Paso 0: Verificación de Código Limpio (Zero Errors) en el skill de despliegue antes de cualquier bump de versión o push.

Changed & Fixed

  • Robustez en SystemSetting:
    • Implementado descriptor híbrido _hybrid_setting_method para get_decrypted_value y get_masked_value, permitiendo indistintamente la invocación como método de clase (SystemSetting.get_decrypted_value('key')) o como método de instancia (setting.get_decrypted_value()), garantizando el paso del 100% de los tests de integración de la Fase 5.
  • Tipado estricto en scripts/moodle_replicator.py:
    • Corregido casteo a int en local_course_id y role_id en las líneas 586 y 607, satisfaciendo la firma de enrol_user(local_uid: int, local_course_id: int, role_id: int).
  • Estabilidad de concurrencia en tests de SQLite:
    • Añadida espera explícita del worker asíncrono en test_05_api_async_job_submission_and_polling (backend/tests/test_sprint4_optimizer_and_concurrency.py) para evitar bloqueo de tablas en SQLite durante tearDown.
  • Suite de pruebas de backend con 52 tests pasando al 100% (52 passed).

[3.5.5] - 2026-10-16

Added

  • Mecanismo de autenticación mediante Clave API institucional (X-API-Key / Authorization: ApiKey) para sincronizaciones seguras desde Moodle y automatizaciones externas sin requerir tokens JWT interactivos.
  • Endpoints de gestión de clave API: GET /api/v1/admin/settings/moodle/api-key y POST /api/v1/admin/settings/moodle/api-key/regenerate.
  • Alias de sincronización POST /api/v1/admin/settings/moodle/sync consumible nativamente desde el botón de la interfaz web en la pantalla de Ajustes.
  • Catálogo extendido de Web Services en Moodle Local (10.0.0.207) para el servicio moodle_api: añadidas funciones enrol_manual_unenrol_users, core_enrol_unenrol_user_enrolment, core_role_assign_roles y core_role_unassign_roles.
  • Blindaje de seguridad en Moodle mediante restricción de IP (iprestriction = 10.0.0.0/24) en los tokens del servicio moodle_api.

Changed & Fixed

  • Eliminadas las 6 tareas residuales pendientes de prueba en la tabla moodle_sync_tasks de classrooms_db.
  • Resolución de type narrowings (loader en moodle_replicator.py y role_obj en admin.py) y configuración integral de paths de scripts y venv en pyrightconfig.json.

[3.5.4] - 2026-10-16

Added

  • Integración completa bidireccional con el Web Service moodle_api de Moodle Local (10.0.0.207) usando token dedicado 810428346d3601c68a37a315fcba8d4391629f46.
  • Soporte para autenticación delegada Moodle (/api/v1/auth/moodle) con fallback dinámico entre moodle_api y moodle_mobile_app, y matching por número de documento (DNI) y prefijo de usuario.
  • Endpoint administrativo POST /api/v1/admin/moodle/sync-from-moodle para sincronización directa de usuarios, roles y catálogo de cursos desde Moodle hacia la base de datos classrooms_db.
  • Métodos get_courses(), get_categories() y sync_from_moodle_to_app() en MoodleClient.
  • Otorgamiento de capability moodle/webservice:createtoken al rol autenticado de Moodle en 10.0.0.207 y habilitación de Web Services para login token.

Fixed

  • Corrección de firma en MoodleClient.test_connection(server_url, token) que causaba TypeError al recibir argumentos opcionales desde el panel de ajustes.
  • Solución al error de resolución de módulos de Pyright/Pylance en scripts/import_moodle_to_app.py mediante configuración de .vscode/settings.json y carga modular dinámica.

[3.5.3] - 2026-10-16

Agregado & Corregido (Sincronización de Roles Moodle-App, Limpieza Admin & Hardening)

  • Importador y Sincronización de Roles con la App (scripts/import_moodle_to_app.py & flag --sync-app):
    • Mapeo directo y coherente de roles académicos: docentes de Moodle (editingteacher) asignados a Docente (role_id=2) y estudiantes (student) asignados a Alumno (role_id=6) en el modelo RBAC de PostgreSQL de la App (classrooms_db).
    • Ingesta exitosa de 653 usuarios únicos (15 Docentes y 640 Alumnos) con contraseñas seguras PBKDF2 coincidentes con el DNI, nombres, apellidos y correos personales reales.
    • Habilitada la vinculación inmediata con comisiones (commission_teachers), reservas docentes e inscripciones de cursada (student_enrollments).
  • Desmatriculación Total de la Cuenta Admin en Moodle Local (10.0.0.207):
    • Removidas todas las asociaciones y enrolamientos espurios de la cuenta admin en asignaturas académicas y cursos institucionales (conteo reducido a 0 matriculaciones).
    • Eliminado el curso dummy residual Prueba matriculaciones masivas (ID 22).
    • Preservados estrictamente los 16 cursos legítimos de la carrera Licenciatura en Tecnologías Digitales (CCC).

[3.5.2] - 2026-10-16

Corregido & Mejorado (Replicación Integral de Carreras y Materias, User-Agent Mozilla/5.0, Login Local Fix)

  • Replicación Completa de los 16 Cursos de la Carrera:
    • Ampliado el catálogo de cursos de la Licenciatura en Tecnologías Digitales (CCC) de 4 a 16 asignaturas completas (1/2025, 2/2025, 1/2026 y 2/2026).
    • Resuelto el problema de alumnos (ej. 90010202 - Carlos Guillermo Terzano) que solo veían la carrera y no sus materias cursadas: ahora cuentan con sus asignaturas y comisiones reales replicadas y matriculadas en Moodle Local (10.0.0.207).
    • Más de 1.100 matriculaciones procesadas y verificadas con éxito en tiempo real.
  • Corrección de Inicio de Sesión de Alumnos en Moodle Local:
    • Solucionada la desincronización de contraseña del usuario 34247025: restablecida y verificada con éxito tanto por CLI como vía API para que el DNI opere idénticamente como username y password.
    • Mecanismo en get_or_create_user para forzar la actualización de contraseña y correo de cuentas existentes evitando bloqueos por credenciales obsoletas.
  • Personalización de Cabeceras HTTP (User-Agent):
    • Configurado estrictamente el encabezado User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) en todas las sesiones y scripts hacia el Campus Virtual UniCABA, eliminando la firma por defecto de python-requests.
  • Pre-caché y Optimización de Extracción:
    • Carga automática de correos previamente cacheados desde participantes_export.json para reducir en un 80% las consultas HTTP a producción y evitar timeouts.

[3.5.1] - 2026-10-16

Agregado & Mejorado (Replicador de Moodle Producción a Entorno Local con Usuarios y Correos Reales)

  • Skill y Script de Replicación (.agents/skills/moodle-replicator/SKILL.md & scripts/moodle_replicator.py):
    • Autenticación automatizada en Moodle Producción (https://campus.udelaciudad.edu.ar/) mediante extracción de logintoken pre-sesión.
    • Extracción híbrida: descarga masiva JSON vía action_redir.php + scraping optimizado de perfiles de usuario.
    • Correos Electrónicos Reales: Consulta concurrente de perfiles para capturar el email real y personal de cada estudiante y docente (omitiendo emails sintéticos o inventados).
    • Mocking Determinístico de DNI: Generación de DNI de 8 dígitos (90{moodle_id:06d}) como username y password para el entorno local, preservando el DNI real de Carlos Tello (34247025).
    • Carga en Moodle Local (10.0.0.207): Creación y actualización de cuentas mediante core_user_create_users y core_user_update_users con enrolamiento manual (enrol_manual_enrol_users) con roles de estudiante (student, ID 5) y profesor (editingteacher, ID 3).
    • 504 matriculaciones completadas exitosamente en 4 cursos: Carrera Lic. en Tecnologías Digitales (922 -> 19), ASIG00124 (5311 -> 16), ASIG00126 (5313 -> 17) y ASIG00127 (5314 -> 18).
    • Verificación de login exitosa de alumnos en Moodle local (http://10.0.0.207/moodle/login/index.php).
  • Especificación SDD (specs/002-moodle-export-sync/):
    • spec.md con 6 Requisitos Funcionales en sintaxis EARS, plan de arquitectura y tareas verificables completadas al 100%.

[3.5.0] - 2026-10-16

Agregado & Mejorado (Cierre Formal MVP Bedelía & Adopción Metodología SDD / Arnés de IA)

  • Arnés de Ingeniería de Software con IA (Harness Engineering):
    • Incorporación de la skill formal de SDD (.agents/skills/sdd/SKILL.md) con las directivas de especificación, planificación y tareas.
    • Implementación de comandos personalizados en .opencode/commands/ (sdd-spec, sdd-plan, sdd-tasks).
    • Configuración de roles de subagentes en .opencode/agents/: Coordinator, Planner, Implementer, Reviewer (QA).
    • Actualización de AGENTS.md con las reglas mandatorias del flujo SDD y sintaxis EARS.
  • Especificación Formal de Cierre de MVP (specs/001-cierre-mvp-bedelia/):
    • Delimitación inamovible de los 10 Requisitos Funcionales en notación EARS y delimitación explícita de Fuera de Alcance para evitar el Scope Creep.
  • Herramientas de Exportación e Impresión para Bedelía y Portería:
    • Nuevo endpoint en Frontend BFF (/schedule/export_csv) que genera un archivo CSV con formato Excel nativo (UTF-8 con BOM \uFEFF y separador ;) conteniendo la cartelera de clases del día/semana seleccionada.
    • Botón "Excel / CSV" y botón "Imprimir" en /schedule/today (today.html).
    • Hojas de estilo CSS @media print para impresión oficial limpia en hoja A4 con membrete institucional de UniCABA (oculta barras de navegación, botones y filtros).
    • Accesos directos de exportación e impresión en el Dashboard Operativo de Bedelía (dashbede.html).
  • Verificación de Calidad:
    • 52 pruebas automatizadas en verde (52 passed) en pytest.

[3.4.9] - 2026-10-09

Corregido & Mejorado (Importador de Google Sheets & Sistema de Diagnóstico de Incidentes)

  • Corrección de Límite de Payload en Importación Masiva de Google Sheets (PayloadTooLargeError):
    • Ajuste de los analizadores de cuerpo en el Frontend BFF Express (express.json({ limit: '50mb' }) y express.urlencoded({ extended: true, limit: '50mb' })), resolviendo el error 500 al enviar matrices de filas preseleccionadas (~154 KB que excedían el límite por defecto de 100 KB).
  • Sistema Institucional de Manejo de Incidentes y Diagnóstico Transparente:
    • Reemplazo de la pantalla genérica de error por una interfaz estructurada con código de ticket único (INC-YYYYMMDD-XXXX), código HTTP, síntesis contextual y recomendación de acción correctiva.
    • Sección técnica colapsable de diagnóstico con Ruta, Marca de Tiempo, Usuario activo, IP del cliente y Stack Trace.
    • Botón "Copiar Reporte para Soporte" con formateo estándar para agilizar la asistencia técnica por Bedelía o Soporte IT.
    • Registro automático del incidente técnico en AuditLog (action='SYSTEM_ERROR', module='system') vía nuevo endpoint /api/v1/admin/log-error.
  • Auditoría Integral de Sincronización de Hojas de Cálculo (/api/v1/dashboard/sync-sheets):
    • Registro de eventos exitosos (SHEETS_IMPORT) con estadísticas de entidades procesadas (carreras, materias, comisiones, aulas, reservas) y filtros aplicados.
    • Registro de errores de sincronización (SHEETS_IMPORT_ERROR) con detalle de la excepción para trazabilidad en la bitácora institucional.

[3.4.8] - 2026-10-09

Agregado & Mejorado (Registro de Auditoría Institucional y Trazabilidad Operativa)

  • Auditoría Completa de Autenticación y Sesiones (AuditService & /api/v1/auth/):
    • Registro sistemático de eventos de inicio de sesión exitosos (LOGIN), inicios vía Google SSO (LOGIN_GOOGLE) y Moodle delegado (LOGIN_MOODLE).
    • Registro de intentos fallidos (LOGIN_FAILED) con captura de correo, IP de origen y motivo del rechazo (credenciales inválidas, dominio no autorizado o cuenta inactiva).
    • Auditoría de accesos bloqueados por deshabilitación administrativa de contraseña local (LOGIN_BLOCKED).
    • Auditoría de cierres de sesión (LOGOUT) y cambios de contraseña institucional por el usuario (PASSWORD_CHANGE).
  • Trazabilidad de Espacios Físicos, Aulas y Reservas:
    • Auditoría de altas, modificaciones, bajas y alternancia de estado en edificios (buildings) y aulas (classrooms).
    • Auditoría de creación, edición, cancelación, confirmación y borrado de reservas (reservations).
    • Auditoría de corridas (OPTIMIZE_RUN) y aplicación de asignaciones masivas (OPTIMIZE_APPLY) del Optimizador Genético IA.
  • Endpoint RESTful de Auditoría (GET /api/v1/admin/audit-logs):
    • Exposición de endpoints RESTful con soporte de filtros por módulo, acción, búsqueda multi-campo y paginación configurable.
    • Implementación del método to_dict() en el modelo AuditLog para serialización JSON segura.
  • Interfaz Institucional de Auditoría (/admin/audit_logs):
    • Conexión del Frontend BFF con el Backend REST Core.
    • Badges temáticos e intuitivos para cada acción institucional y módulo.
    • Filtros rápidos por categorías (Sesiones, Fallos de Login, Reservas, Aulas, Sedes, Optimizador IA).
    • Modal interactivo de inspección con visor JSON/texto formateado y botón para copiar al portapapeles.
    • Paginación dinámica nativa compatible con Nunjucks que conserva los parámetros de búsqueda.

[3.4.7] - 2026-10-08

Agregado & Mejorado (Panel Interactivo de Plantas y Aulas en Edificios)

  • Gestión de Edificios (/buildings/edit/:id y /buildings/add_building):
    • Transformación del formulario de edición de edificio de un mero input numérico a un Panel Interactivo de Plantas y Aulas de la Sede.
    • Visualización completa de cada planta física (Subsuelos, Planta Baja, Entrepisos, Pisos 1..N) con badges de código, cantidad de aulas y capacidad instalada en alumnos.
    • Listado detallado de aulas asociadas por planta física con enlaces directos a ficha, edición y reservas.
    • Botón de acción directa + Nueva Aula en este Piso (/classrooms/add_classroom?building_id=X&floor=Y) que precarga automáticamente el edificio y el piso seleccionado.
    • Configurador rápido de niveles físicos con presets (PB, PB + 1, PB + 3, Virtual), stepper dinámico y generador visual en tiempo real de la estructura proyectada.
  • Módulo de Aulas (/classrooms/add_classroom):
    • Soporte de preselección automática por URL (building_id y floor) para agilizar la creación de espacios desde la vista de edificios.

[3.4.6] - 2026-10-08

Corregido & Mejorado (Reservas, Relaciones Edificios/Aulas, Fechas y Filtros)

  • Módulo de Reservas (/schedule/add_reservation y /schedule/edit):
    • Corrección del fallo de serialización JSON que rompía el selector en cascada Edificio -> Piso -> Aula al seleccionar el "Edificio Central". Inyección segura de classroom_data_json y commission_data_json sin escape de entidades HTML (&quot;), y matching ultra tolerante de pisos físicos y virtuales.
  • Calendario Académico (/schedule/calendar_view y /schedule/calendar_data):
    • Limpieza exhaustiva de datos mockeados y hardcodeados (Arquitectura de Software ARQ-101, COM-A, Licenciatura en Sistemas). El feed y los filtros ahora consumen estrictamente asignaturas, carreras, comisiones y aulas reales de la base de datos institucional.
  • Importador de Google Sheets (sheets_importer.py):
    • Eliminación de la autogeneración no deseada de enlaces de Google Meet / Zoom (https://meet.google.com/edu-...) en reservas importadas con celdas vacías (ej. #9797 ASIG00215 - Marketing Digital). Se respeta estrictamente el Sheet: solo se asocian enlaces virtuales si vienen explícitamente en el documento original.
  • UX/UI Ficha del Aula (/classrooms/view_classroom):
    • Formateo amigable en español institucional para las reservas y clases programadas (ej. Viernes 04/09/2026 · 18:30 a 21:30 hs) eliminando el formato ISO repetido y ampliando el rango de consulta a todo el ciclo lectivo 2026.
  • Gestión de Edificios, Aulas y Pisos Dinámicos (/buildings/list_buildings y /buildings/view/:id):
    • Corrección de la ficha de edificio que mostraba "No hay aulas asignadas a este edificio" a pesar de tener 6 aulas configuradas. Implementación del agrupador floors_list y classrooms_by_floor.
    • Corrección del contador de "Pisos Presenciales" en el listado general de edificios para mostrar el conteo real (4 pisos) en lugar de 0.
    • Soporte de niveles dinámicos alfanuméricos: creación y selección de "Planta Baja (PB)", "Entrepiso (EP)", "Subsuelo (SS)", etc., en modelos, datalists y vistas de detalle.
  • Filtros en Gestión de Comisiones (/admin/commissions_list):
    • Corrección de UnboundLocalError en backend/app/routes/api/admin.py dentro de get_commissions causado por importación interna tardía de Career, que provocaba error 500 al filtrar por carrera (career_id=180, 181, 182). Grilla ahora filtra correctamente sobre materias compartidas (subject_careers).

[3.4.5] - 2026-10-08

Corregido & Mejorado (Optimizador de Aulas por Inteligencia Artificial - IA)

  • Corrección de Permisos RBAC para Bedelía y Operadores en el Optimizador Genético:
    • Resolución del bloqueo que devolvía 403 Forbidden a usuarios con rol Bedelia, Docente o Administradores con roles formateados en minúsculas en los endpoints /api/genetic/commissions, /api/genetic/algorithm-status, /api/genetic/preview-optimization, /api/genetic/optimize y /api/genetic/apply-optimization.
    • Creación del helper de verificación de permisos check_optimizer_permission(user, requires_write) en backend/app/routes/genetic_algorithm.py admitiendo a Administradores, Bedelía, Docentes y permisos RBAC personalizados.
  • Enriquecimiento del Listado de Comisiones para Asignación Áulica:
    • GET /api/genetic/commissions ahora expone subject_name, subject_code, career_name, schedule y shift para cada comisión activa.
  • Rediseño e Internacionalización de la Interfaz del Optimizador:
    • frontend/views/genetic_optimizer.html: Interfaz traducida integralmente a español institucional ("Optimizador Inteligente de Asignación de Aulas (IA)"), tarjetas interactivas de comisiones con badges de código, asignatura, carrera, turno, horario y aforo, buscador en vivo multi-criterio y manejo de errores visible.
    • frontend/public/js/genetic-algorithm.js: Traducción de alertas, modales y tablas de resultados ("Resultados de la Optimización", "Previsualización", confirmación de aplicación directa a Bedelía).
    • Protección de la ruta web /genetic_optimizer con requireAuth e inyección de datos de sesión en frontend/src/app.js.

[3.4.4] - 2026-10-07

Añadido & Mejorado (Dashboard Operativo de Bedelía y Admin)

  • Filtro Temporal "Mañana" en Switchers de Período y Cartelera:
    • Incorporación del botón de filtro temporal "Mañana" (tomorrow) de forma homogénea en los switchers de período del dashboard:
      • Panel de Percentiles de Ocupación de Aulas Físicas: switcher con Día (Hoy), Mañana, Semana y Mes, calculando métricas de ocupación y aulas libres para el día siguiente.
      • Panel de Comisiones Asignadas vs Sin Asignar: visualización inmediata de comisiones con y sin aula asignada programadas para mañana.
      • Panel de Aulas Físicas Asignadas vs Libres: tarjetas detalladas con aulas libres con botón de asignación directa y aulas en uso para el día de mañana.
      • Cartelera Operativa & Agenda de Clases: pestaña "Clases de Mañana" con listado completo de cursadas presenciales y virtuales activas del día siguiente.
    • Soporte completo en backend (backend/app/routes/api/dashboard.py): cálculo de tomorrow_dt, estadísticas en filter_stats['tomorrow'], tomorrow_schedule_list y soporte de sincronización de datos con frontend BFF.

[3.4.3] - 2026-10-07

Añadido & Refactorizado (Sincronización Google Sheets)

  • Selección Granular de Entidades a Importar:
    • Adopción del patrón visual de tarjetas checkbox (idéntico a la Herramienta de Reinicio y Purga Académica) con accesos rápidos "Marcar Todo" y "Desmarcar Todo".
    • Toggles individuales para Asignaciones de aulas (import_reservations), Aulas físicas y virtuales (import_classrooms), Comisiones de cursada (import_commissions), Asignaturas / Materias (import_subjects) y Carreras académicas (import_careers).
  • Selector de Días de la Semana con Checkboxes Múltiples:
    • Sistema de checkboxes para procesar concurrentemente múltiples días de la semana (Lunes a Sábado) con selectores rápidos ("Todos", "Lun a Vie", "Limpiar").
  • Grilla de Previsualización Interactiva e Inspección Previa:
    • El botón "Inspeccionar Sheet Online" no importa directamente; extrae y presenta una grilla interactiva completa (preview_rows) de registros online.
    • Selección por fila mediante checkboxes individuales y checkbox maestro superior.
    • Modificación manual inline de fechas de cursada por fila mediante Datepicker (<input type="date">) y aplicador de fecha masiva a seleccionados.
    • Resaltado visual con badges de alerta y error ante registros incompletos o aulas no reconocidas.
    • Buscador en vivo multi-criterio y paginación fluida (25 filas por página) para evitar bloqueos del navegador.
    • Modal de confirmación previa con desglose exacto de filas y entidades antes de iniciar la sincronización.
  • Backend & BFF Endpoints:
    • POST /api/v1/dashboard/sheets-inspect retorna metadatos y preview_rows con inferencia de fechas, estados de validación y carreras compartidas.
    • POST /api/v1/dashboard/sync-sheets procesa opcionalmente selected_rows con fechas editadas respetando la granularidad de entidades activadas.

[3.4.2] - 2026-10-07

Corregido & Mejorado (UX/UI)

  • Agrupación Cronológica de Reservas en Cartelera del Día (/schedule/today_schedule):
    • Corrección del bug que duplicaba visualmente una misma reserva por cada hora que abarcaba la cursada (eliminación del bucle for de franjas horarias artificiales de 1 hora).
    • Implementación de agrupación nativa por franja horaria real de cursada (grouped_slots, ej. 08:00 - 11:00 hs, 18:30 - 21:00 hs).
    • Cada reserva se muestra agrupada exactamente una sola vez en su bloque horario correspondiente, mostrando turno, duración, cupo, aula física/virtual, docente y enlace de videoconferencia.
  • Optimización de Formato de Fecha y Horario en el Sistema (/schedule/list_reservations, etc.):
    • Reemplazo del formato ISO crudo con 'T' y segundos (2026-10-08T08:00:00 - 2026-10-08T11:00:00 hs) por formato amigable en español:
      • Fecha: Jueves 08/10/2026 / 08/10/2026.
      • Horario: 08:00 - 11:00 hs.
    • Creación de la función utilitaria formatReservationDates en el BFF y nuevos filtros Nunjucks (format_date_human, format_time, format_time_range).
    • Actualización de las vistas de tabla y mosaico/tarjetas en list.html, today.html y view.html.

[3.4.1] - 2026-10-07

Corregido

  • Corrección de Bug en Importador de Google Sheets (ReferenceError: availableCareers is not defined):
    • Declaración e inicialización con ámbito de función de availableCareers y availableSubjects en handleGoogleSheetsImport (frontend/src/routes/admin.js).
    • Eliminación del error 500 al acceder por GET a /admin/google_sheets_import o /admin/import.
  • Corrección de Conteo y Renderizado de Aulas Virtuales en Dashboard de Bedelía:
    • Corrección de la lógica de obtención de datos en backend/app/routes/api/dashboard.py para calcular las salas virtuales disponibles a partir de las 101 comisiones virtuales activas en Campus Virtual (Google Meet / Teams / Zoom) en lugar de limitarse a la única fila relacional en classrooms.
    • Agregado del arreglo virtual_rooms con metadatos completos (código de comisión, asignatura, enlace Meet, docente, cupo y turno) a los datos de Bedelía.
    • Incorporación de la pestaña "Salas Virtuales (Campus Virtual)" en el panel de Aulas de Bedelía (dashbede.html), permitiendo supervisar y acceder directamente a todas las salas de videoconferencia.

Refactorizado

  • Modularización de Vistas por Roles (dashboard.html como Layout Padre):
    • División de la plantilla monolítica dashboard.html en 4 submódulos específicos por rol:
      • dashadm.html (Administrador)
      • dashbede.html (Bedelía)
      • dashprof.html (Docente / Profesor)
      • dashalum.html (Alumno / Estudiante)
    • Implementación de inyección limpia de componentes en dashboard.html mediante directivas {% include %} de Nunjucks.

Documentación y Workflow

  • Actualización de docs/constitution.md (Principio 9):
    • Inclusión obligatoria del control de versión semántica al momento de compilar.
    • Inclusión obligatoria del despliegue inmediato al servidor institucional de producción al finalizar la compilación.

[3.4.0] - 2026-10-07

Añadido

  • Soporte de Materias Compartidas en Múltiples Carreras (Many-to-Many):
    • Implementación de la tabla asociativa relacional subject_careers en la base de datos para vincular asignaturas a más de una titulación académica de forma nativa.
    • Compatibilidad total hacia atrás preservando career_id principal y exponiendo colecciones careers en Subject y Commission.
    • Desglose de badges en UI para cada carrera vinculada tanto en /admin/subjects_list como en /admin/commissions_list.
    • Filtro avanzado por carrera en asignaturas y comisiones que incluye tanto la carrera principal como cualquiera de las carreras asociadas (Subject.careers.any).
  • Mejora Integral y Descubrimiento Dinámico del Importador Google Sheets (sheets_importer.py):
    • Extracción y normalización automática de carreras múltiples separadas por guion en la planilla (ej. DATOS (CCC) - TEC. DIG (CCC) - VIDEOJUEGOS (CCC), DATOS(CCC)-TEC.DIG, PROF PROF (CCC) - CIENCIAS, EF. SALUD - EF. GESTIÓN, ETD-MONO).
    • Mapeo canónico a nombres de carrera oficiales para evitar la creación de strings compuestos artificiales en la base de datos.
    • Descubrimiento dinámico de pestañas desde /pubhtml con regex optimizada para los 6 días de la semana (Lunes a Sábado con sus respectivos GIDs).
    • Normalización de URLs de Google Sheets para exportación CSV limpia sin restricciones de pestaña única.
    • Soporte de múltiples códigos de asignatura por materia (ej. ASIG00113 / ASIG000082) permitiendo indexación y búsqueda por cualquiera de los códigos.
    • Generación de informe semanal detallado con desglose de filas y estado por día de cursada (by_day) en la interfaz de /admin/google_sheets_import.
  • Habilitación y Reactivación de Operador Institucional de Bedelía:
    • Desbloqueo y activación de la cuenta bedelia@edu-space.com para gestión operativa continua con credenciales institucionales.

[3.3.0] - 2026-10-07

Añadido

  • Estandarización del Flujo Secuencial de Bedelía (9 Pasos Operativos):
    • Formalización del circuito paso a paso para reemplazar el archivo Excel manual de uso diario:
      1. Sede / Edificio (/buildings/list_buildings): Creación y administración del inmueble universitario.
      2. Aula (/classrooms/list_classrooms): Alta de espacios físicos y aulas virtuales con control de aforo y recursos.
      3. Ciclo Lectivo (/admin/academic_terms_list): Creación del período lectivo y activación del cuatrimestre corriente.
      4. Carrera / Titulación (/admin/careers_list): Creación y administración del programa académico institucional.
      5. Asignatura / Materia (/admin/subjects_list): Alta en plan de estudios asociada obligatoriamente a la Carrera.
      6. Comisión (/admin/commissions_list): Creación de comisiones con cupos y vinculación a la materia, ciclo lectivo y carrera asociada, con filtros directos por titulación.
      7. Asociar Profesores (/admin/commission_detail): Asignación del cuerpo docente y co-docentes con roles de cátedra.
      8. Asociar Alumnos (/admin/commission_detail): Matriculación con validación de restricciones horarias y excepciones de Bedelía.
      9. Reserva de Espacios (/schedule/add_reservation o Drag & Drop en /schedule/calendar_view): Asignación de aula y franja horaria en 1 clic con chequeo de conflictos.
  • Gestión Académica en RBAC y Reestructuración de Menús UX/UI:
    • Ampliación de permisos RBAC para rol Bedelía permitiendo la administración total de ciclos lectivos, carreras, materias, comisiones, docentes, alumnos y reservas.
    • Reorganización de la barra lateral de navegación según las mejores prácticas de IT y arquitectura de la información: menús especializados y directos para Administrador, Bedelía, Docente y Alumno.
  • Control y Exposición de Versiones Institucionales (v3.3.0):
    • Estandarización de número de versión en Backend (__version__ = "3.3.0", /api/v1/version, /api/v1/health) y Frontend BFF (package.json, /version).
    • Badges de versión visibles y legibles en el pie del menú lateral (sidebar-footer) y en la pantalla de inicio de sesión (login.html).
  • Corrección de Error en Catálogo de Aulas (/classrooms/list_classrooms):
    • Resolución del error 500 (Template render error: unknown block tag: endblock) balanceando los bloques condicionales de Nunjucks entre los modos presencial y virtual.
  • Alineamiento de Documentación con SSD (Software System Design):
    • Constitución del Sistema (docs/constitution.md): Actualización con principios innegociables: arquitectura desacoplada REST + BFF, reemplazo definitivo del Excel, matriz de conflictos, caché de Moodle 4.1, y RBAC seguro.
    • Manual de Agentes (AGENTS.md): Definición precisa del stack, comandos de desarrollo y pruebas, convenciones y límites.
    • Memoria Operativa (MEMORY.md): Sincronización del estado de desarrollo para el Sprint Bedelía MVP.
    • Roadmap del Proyecto (ROADMAP.md): Creación en la raíz del proyecto detallando el progreso y las metas del MVP.
    • Guía Operativa por Rol (docs/GUIA_OPERATIVA_BEDELIA_Y_ROADMAP_FUTURO.md): Manual exhaustivo con paso a paso para Bedelía, Docentes y Alumnos.
  • Mantenimiento del Importador de Google Sheets:
    • Preservación del servicio sheets_importer.py para ingesta masiva inicial sin fricción para el personal.

[3.2.0] - 2026-09-23

Añadido

  • Función de Reinicialización Total del Sistema (POST /api/v1/admin/system/reset):
    • Módulo de Mantenimiento en Configuración Global (/admin/settings): Nueva pestaña "Mantenimiento & Reinicio" con tarjeta de "Zona de Peligro" y advertencia sobre el alcance de la purga.
    • Requisito Estricto de Seguridad Institucional: Exige obligatoriamente la validación de la contraseña del usuario Administrador en sesión antes de ejecutar la acción; retorna 401 y aborta ante claves incorrectas registrando el evento SYSTEM_RESET_FAILED.
    • Purga Referencial Completa: Vacía de forma segura y en orden estricto de claves foráneas: historiales previos (AuditLog), reservas (Reservation), hitos evaluativos (AcademicMilestone), notas (MilestoneGrade), matrículas (StudentEnrollment), asignaciones docentes (CommissionTeacher), comisiones (Commission), materias (Subject), carreras (Career), recursos de aula (ClassroomResource), aulas (Classroom), sedes/edificios (Building), ciclos lectivos (AcademicTerm) y colas de sincronización Moodle (MoodleSyncTask).
    • Preservación Estricta de Administración y Cuentas: Mantiene 100% intactas todas las cuentas de usuario (User con hashes de contraseñas), roles RBAC (Role), permisos (Permission), tipos de hitos (MilestoneType), configuraciones globales (SystemSetting) y todos los módulos de la pestaña Administración.
    • Trazabilidad Inmutable: Genera automáticamente un nuevo registro en AuditLog con la acción SYSTEM_RESET, asociando el correo del administrador ejecutor, su IP y el recuento de entidades purgadas.
    • Interfaz de Usuario y Modal Interactivo: Diálogo modal #modalResetSystem con campo de contraseña enmascarada, switch de visibilidad, casilla de confirmación explícita y botón de confirmación con estado de carga (spinner).

Corregido

  • Blindaje de Espacios y Sedes Vacíos (Presenciales y Virtuales):
    • Prevención de Excepciones TypeError: Se corrigieron accesos inseguros a propiedades nulas o no definidas (c.code.includes, r.start_time.startsWith, localeCompare) en frontend/src/routes/classrooms.js, permitiendo navegar a /classrooms/list_classrooms?view_mode=physical y /classrooms/list_classrooms?view_mode=virtual sin caídas ante bases vacías.
    • Corrección de Evaluación de Longitud en Nunjucks: Actualizadas las directivas condicionales en frontend/views/classrooms/list.html a classrooms.items|length > 0 y virtual_rooms|length > 0, garantizando el despliegue de los Empty States institucionales con botones de alta cuando no existen aulas registradas.
    • Mapeo Dinámico de Sedes: handleAddClassroom y handleClassroomsList ahora sincronizan con el catálogo /buildings, ofreciendo la creación guiada de sedes y vinculación dinámica en el alta de aulas físicas.
    • Blindaje del Fallback Offline: En caso de fallas o demoras en la API, el manejador de captura provee valores predeterminados seguros para global_virtual_metrics y virtual_rooms, impidiendo errores 500 no controlados.

[3.1.0] - 2026-09-23

Añadido

  • ABM Integral de Ciclos Lectivos (AcademicTerm):
    • Gestión End-to-End de Períodos Académicos: Implementación de ciclo de vida completo para ciclos lectivos: Alta, Edición, Establecimiento de Ciclo Actual, Toggle de Habilitación rápida y Eliminación protegida (DELETE /api/v1/admin/academic-terms/<id> y POST /api/v1/admin/academic-terms/<id>/toggle).
    • Integridad Relacional Protegida: Bloqueo de eliminación si el ciclo es el activo corriente, y fallback seguro a desactivación (is_active = False) si el ciclo tiene comisiones históricas asociadas.
    • Interfaz Enriquecida en Bedelía / Admin: Botones de acción contextuales, switches y modales interactivos de confirmación (#modalDeleteTerm) en frontend/views/admin/academic_terms/list.html.
  • ABM Completo de Espacios y Aulas (Classroom):
    • Control de Estado y Borrado Seguro: Incorporación de toggle activo/inactivo (POST /api/v1/classrooms/<id>/toggle) y endpoint de baja de aulas integrado con el frontend BFF (/classrooms/toggle_classroom y /classrooms/delete_classroom).
    • Acciones Rápidas en Vista Lista y Ficha: Botones de edición, alternancia de estado y eliminación con modales de advertencia en las vistas de cuadrícula/tabla (list.html) y detalle (view.html).
  • ABM Completo de Reservas (Reservation):
    • Eliminación Definitiva (Hard Delete): Soporte en backend para purga física de reservas (DELETE /api/v1/reservations/<id>?hard=true y POST /api/v1/reservations/<id>/delete) complementando el flujo de cancelación lógica (CANCELLED).
    • Control Operativo en Vista Detalle: Botón de "Eliminar Reserva Definitivamente" con diálogo modal de confirmación en /schedule/view.html.
  • Auditoría y Cobertura 100% de ABMs en la Plataforma:
    • Verificación y garantía de operaciones ABM completas en todos los componentes centrales: Sedes/Edificios (Building), Aulas (Classroom), Ciclos Lectivos (AcademicTerm), Carreras (Career), Materias (Subject), Comisiones (Commission) y Reservas (Reservation).
  • Circuito Integral y Simplificado de Bedelía:
    • Flujo Operativo Ágil para Bedelía:
      • Circuito intuitivo de 3 pasos: Catálogo de Aulas (/classrooms/list_classrooms) -> Creación/Edición con validación física/virtual y aforo real -> Asignación de Comisiones (/schedule/add_reservation).
      • Botón de acción rápida Asignar Aula (bi-calendar-plus) en cada fila de /admin/commissions_list, permitiendo asignar espacio y horario a cualquier comisión en 1 solo clic.
      • Sincronización bidireccional de parámetros por URL (?commission_id=... y ?classroom_id=...) precargando automáticamente en el formulario de reserva la materia, código, cupo máximo de alumnos y enlace virtual de Google Meet / Teams.
      • Selectores inteligentes en cascada en /schedule/add.html con autoselección de Edificio, Piso y Aula al navegar desde el catálogo de espacios.
    • Conexión REST en Vivo para Reservas:
      • Sustitución de listas fijas/mockeadas en frontend/src/routes/schedule.js por consulta dinámica a /commissions en vivo, permitiendo reservar aulas para cualquiera de las comisiones reales de la plataforma.
    • Soporte Multisede Consistente en Aulas:
      • Resolución robusta de building_id y flag is_virtual en frontend/src/routes/classrooms.js, eliminando hardcodes y asegurando que las aulas físicas pertenezcan a la sede seleccionada.
  • Inicialización de Base de Datos Limpia sin Datos Demo (--empty-academic / --no-demo):
    • Soporte en install.sh y Menú Interactivo: Incorporación de la opción sudo bash install.sh --empty-academic (o --no-demo) y opción [3] en el menú interactivo para crear la base de datos limpia desde cero, omitiendo la inyección de snapshots con carreras, materias, comisiones, aulas o reservas heredadas.
    • Inicializador de Esquema init_db.py: Nuevo flag --empty-academic que genera el esquema de tablas completo, los roles y permisos RBAC, los usuarios institucionales y las tipificaciones de hitos, purgando y omitiendo cualquier edificio, aula física o virtual, carrera, materia, comisión o reserva demo por defecto.
  • Personalización de Interfaz y Saludo en Dashboard (Configuración Global):
    • Nueva Pestaña de Interfaz & Dashboard (/admin/settings): Módulo en el panel de configuración global para personalizar elementos visuales del sistema.
    • Desactivación Opcional del Saludo y Selector de Rol: Switch interactivo para habilitar o deshabilitar el banner superior ¡Hola, {Usuario}! y el selector de perspectiva de roles en dashboard.html. Al deshabilitarlo, el usuario accede directamente a los indicadores y accesos operativos de su rol sin distracciones ni dudas de contexto.
    • Persistencia y Endpoint REST: Parámetro dashboard_role_banner_enabled administrado vía POST /api/v1/admin/settings/ui, respaldado por SystemSetting y registrado en AuditLog.

Corregido

  • Motor de Purga y Reinicio de Datos Académicos:
    • Solución al botón inerte de Purga: En /admin/google_sheets_import, el botón "Ejecutar Purga de Datos Seleccionados" llamaba a openPurgeModal(), el cual no ejecutaba ninguna acción por ausencia del modal #purgeConfirmModal en el DOM. Se incorporó el modal interactivo completo con desglose dinámico de elementos marcados para borrado, advertencia de preservación de usuarios y estado de carga (spinner).
    • Integridad Referencial en Purga Backend: En backend/scripts/reset_academic_data.py, se reordenó la secuencia de borrado para respetar las restricciones de clave foránea (FK): Reservation -> MilestoneGrade / AcademicMilestone -> CommissionTeacher -> StudentEnrollment -> Commission -> Subject -> Career -> ClassroomResource / Classroom. Esto previene fallos silenciosos por FK y garantiza que las carreras, asignaturas y comisiones se eliminen de manera limpia cuando son seleccionadas.
    • Preservación de Usuarios y Roles: La purga garantiza que ningún usuario (User), contraseña administrativa ni rol (Role) sea alterado o eliminado durante el reseteo académico.
  • Saneamiento de Métricas y Edición de Edificios:
    • Corrección de métricas de edificios en /buildings/list_buildings: la capacidad virtual (9999) ya no distorsiona el cómputo de bancos físicos ni los percentiles de ocupación institucional.
    • Formulario de edición de sedes (/buildings/edit/:id) corregido y persistido adecuadamente.
  • Instalador install.sh:
    • Inclusión de banderas --keep-db y --keep-users para evitar sobreescritura de contraseñas y usuarios en reinstalaciones o actualizaciones.

[3.0.0] - 2026-09-23

Añadido

  • Fase 5 — Integración Auth, Email & Moodle Backend:
    • Épica 1: Panel de Configuración Global (Perfil ADMIN):
      • Cifrado simétrico de credenciales y secretos con Fernet (CryptoService en backend/app/services/crypto_service.py).
      • Migración y extensión de SystemSetting con columnas category e is_encrypted, junto con métodos polimórficos get_decrypted_value() y get_masked_value().
      • Endpoints REST /api/v1/admin/settings/* para administración dinámica de parámetros SMTP, toggles de proveedores SSO, Google OAuth y Web Services de Moodle 4.1.
      • Nueva vista responsiva frontend/views/admin/settings/global_config.html con soporte optimizado para pantallas 720p, 1360x768 y 1080p, y enlace integrado en el menú de navegación lateral.
    • Épica 2: Infraestructura Asíncrona y Caché:
      • Servicio híbrido de caché CacheService con integración Redis y fallback en memoria/TTL.
      • Modelo MoodleSyncTask y procesador asíncrono MoodleQueueService con Exponential Backoff y Dead Letter Queue (DLQ).
      • Métricas en vivo y reintentos manuales individuales y masivos para tareas en DLQ.
    • Épica 3: Autenticación Híbrida (SSO & Local):
      • Login nativo como fallback con contingencia para cuentas con rol ADMIN.
      • Integración de Google OAuth 2.0 basada en la arquitectura de AlumnosLS con filtrado estricto por dominios institucionales (google_allowed_domains).
      • Autenticación delegada contra Moodle 4.1 vía /login/token.php, mapeo inicial de roles (Admin/Docente/Alumno) y gestión de roles 100% desacoplada en Edu-Space.
    • Épica 4: Integración Bidireccional Moodle 4.1:
      • Adaptador MoodleClient con Web Services de Moodle 4.1 (core_user_*, enrol_manual_*, core_enrol_*, core_role_*).
      • Encolado no bloqueante de sincronización al crear o editar usuarios en Edu-Space.
    • Épica 5: Motor de Notificaciones (Email Server):
      • Cliente SMTP dinámico en EmailService con desencriptación en caliente de contraseñas.
      • Plantillas HTML transaccionales para asignación de comisiones a profesores, citación a exámenes y pruebas en vivo de conectividad.
    • Pruebas y Verificación:
      • Suite de integración automatizada backend/tests/test_phase6_integration.py con 7 pruebas aprobadas al 100%. Regresión completa de 30 pruebas en verde en los módulos core.

[2.8.0] - 2026-09-23

Añadido

  • Fase 4 del Roadmap MVP — UI/UX Avanzada para Bedelía & Modo Impersonación:
    • Estadio 4.1 — Grilla Semanal Interactiva (Drag-and-Drop) con Detección de Colisiones:
      • Activación de arrastre y edición interactiva en FullCalendar (editable: true, droppable: true, eventDurationEditable: true).
      • Panel lateral integrado de comisiones sin aula asignada (unassigned_commissions) con arrastre fluido hacia la grilla semanal o diaria.
      • Endpoint REST POST /api/v1/reservations/drag-update con validación previa de la matriz integral de conflictos (ReservationService.check_full_conflicts_matrix): colisión física de aula, colisión de horario docente y aforo de estudiantes.
      • Si existe colisión, retorna HTTP 409 (status: conflict), revierte automáticamente la posición del evento en la grilla (info.revert()) y notifica al usuario con un Toast detallado del motivo del choque.
      • Si el espacio está disponible, actualiza o crea la reserva en base de datos, asienta la acción en AuditLog y muestra confirmación visual de éxito.
    • Estadio 4.2 — Modo Impersonación del Superadmin:
      • Soporte completo de cabecera X-Impersonate-User en el decorador JWT del Backend Flask (jwt_required) para administradores.
      • Endpoints administrativos POST /api/v1/admin/impersonate y POST /api/v1/admin/stop-impersonating con registro estricto en AuditLog bajo las acciones IMPERSONATE_START e IMPERSONATE_END.
      • Inyección contextual de impersonación en el Frontend BFF (authMiddleware y proxy transparente /api) mediante cookies seguras impersonate_user_id e impersonate_user_data.
      • Banner de advertencia visual permanente en la barra superior (base.html) indicando el usuario y rol impersonado, con botón de salida inmediata hacia la sesión del administrador.
      • Botón de acceso directo para impersonar (bi-incognito) en cada fila de usuario activo en /admin/users_list.
    • Estadio 4.3 — Acople del Optimizador Genético a Datos y Turnos Reales:
      • Algoritmo genético (ReservationOptimizer) adaptado a las franjas horarias y turnos institucionales reales de UniCABA (Mañana 08:00-12:00, Tarde 14:00-18:00, Vespertino/Noche 18:30-22:30).
      • Soporte de guardado masivo en base de datos (POST /api/genetic/apply-optimization y apply_optimized_reservations) con prevención de solapamientos físicos y conversión estricta de fechas ISO.
    • Suite de Pruebas Unitarias de Fase 4:
      • Archivo backend/tests/test_phase4_interactive_impersonation.py con 6 tests unitarios cubriendo los criterios de aceptación: impersonación como docente y estudiante, trazabilidad en auditoría, rechazo de impersonación para usuarios no administradores, finalización de impersonación, drag-update con bloqueo por colisión 409 y drag-update exitoso 200.
      • Regresión global de 18 tests (Fases 2, 3 y 4) aprobada al 100% (18/18 OK).

[2.7.0] - 2026-09-23

Añadido

  • Fase 3 del Roadmap MVP — Gestión de Hitos Evaluativos y Libro de Calificaciones (Gradebook):
    • Estadio 3.1 — Calendario de Evaluación y Notificaciones Preventivas:
      • Modelo relacional MilestoneGrade (milestone_grades) asociado a estudiantes (User) y reservas de tipo hito (Reservation).
      • Servicio GradebookService.get_student_upcoming_milestones: consulta inteligente de exámenes parciales, recuperatorios y entregas de TP de las comisiones en las que el alumno está matriculado.
      • Endpoint REST GET /api/v1/students/my-upcoming-milestones con cálculo de días restantes (days_remaining).
      • Cartelera y Widget de Próximos Exámenes en el Dashboard del Alumno (/dashboard?role=alumno) con badges dinámicos de cuenta regresiva (¡Hoy!, ¡Mañana!, Faltan X días).
    • Estadio 3.2 — Libro de Calificaciones (Gradebook) y Cierre de Actas:
      • Extensiones al modelo Commission: campos grades_closed (booleano), grades_closed_at (timestamp), grades_closed_by (ID usuario) y acta_number (código oficial de acta).
      • Servicio académico GradebookService (backend/app/services/gradebook_service.py):
        • get_commission_gradebook: matriz bidimensional consolidada de alumnos inscriptos y notas por hito evaluativo.
        • save_single_grade y bulk_save_grades: registro y actualización de calificaciones con validación estricta de escala (1.0 a 10.0), flag de ausente (is_absent) y soporte de retroalimentación pedagógica (feedback).
        • Bloqueo por inmutabilidad: rechazo de modificaciones cuando el acta se encuentra cerrada.
        • close_gradebook: sellado oficial del acta con generación de identificador inmutable (ACTA-YYYY-Sem-ID), registro de auditoría en AuditLog y congelamiento de calificaciones.
        • reopen_gradebook: reapertura excepcional para Bedelía/Admin con justificación administrativa obligatoria y registro en auditoría.
        • get_student_grades: consolidado para el alumno de todas sus materias cursadas, notas por evaluación, promedio general y condición académica final (Promocionado, Regular, Libre).
      • Endpoints REST de Calificaciones:
        • GET /api/v1/commissions/<id>/gradebook: estructura completa para la matriz del libro de calificaciones.
        • PUT /api/v1/commissions/<id>/gradebook/grades: guardado masivo o individual de notas vía JSON.
        • POST /api/v1/commissions/<id>/gradebook/close: cierre formal de acta.
        • POST /api/v1/commissions/<id>/gradebook/reopen: reapertura justificada de acta.
        • GET /api/v1/students/my-grades: consulta individual de notas y regularidad del estudiante.
      • Interfaz de Usuario y Vistas Frontend BFF:
        • Vista /schedule/gradebook/:id: matriz interactiva con cálculo de promedio en tiempo real en el DOM, asignación de condición en vivo, autoguardado asíncrono debounced (500ms) con indicador flotante de estado (Guardando..., ✓ Todos los cambios guardados), filtro de búsqueda instantánea por alumno/legajo, modal de cierre formal de acta y modal de reapertura.
        • Vista /schedule/my_grades (/mis-materias/mis-notas): portal del estudiante para consultar calificaciones por hito, promedios finales, condición de cursada y actas emitidas, con soporte de impresión de certificado de cursada.
        • Acceso directo integrado al Libro de Calificaciones en la tarjeta de comisión de /admin/commission_detail.
        • Acceso directo a "Mis Calificaciones" en el launchpad de navegación del alumno en /dashboard.
      • Script de migración de base de datos SQLite backend/migrate_phase3_fields.py.
    • Suite de Pruebas Unitarias de Fase 3:
      • Archivo backend/tests/test_phase3_gradebook.py con 6 tests unitarios cubriendo los criterios de aceptación de Fase 3: estructura de matriz, autoguardado de notas, validaciones de rango numérico, cierre formal de acta e inmutabilidad, consulta individual de notas y cuenta regresiva de próximos exámenes. 100% de tests aprobados (12/12 en suite global Fase 2 + Fase 3).

[2.6.1] - 2026-09-23

Modificado

  • Optimización de Espacio Vertical y Compatibilidad de Pantallas (720p / 1360x768 y 1080p):
    • Navbar Compacta: Reducción de altura a 46px eliminando desperdicio de espacio superior para maximizar el área visible de trabajo de Bedelía.
    • Botón de Toggle de Sidebar: Reingeniería visual del botón de alternancia del menú lateral con diseño circular limpio, micro-animación en hover y centrado perfecto.
    • Soporte Multipantalla: Media queries CSS especializadas para resoluciones compactas habituales en puestos de trabajo de administración y bedelía argentina (1360x768 / 1366x768) y escalado equilibrado a 1920x1080 Full HD.
    • Densidad de Información: Espaciados y márgenes optimizados para evitar scrolling innecesario en formularios y catálogos de comisiones y aulas.

[2.6.0] - 2026-09-19

Añadido

  • Fase 2 del Roadmap MVP — Co-docencia, Matriz de Conflictos y Regla Diaria:
    • Estadio 2.1 — Modelo y Gestión Integral de Co-docencia:
      • Modelo relacional CommissionTeacher (commission_teachers) con roles de cátedra (Titular, Adjunto, JTP, Ayudante) y flags de docente principal.
      • Endpoints REST de cátedra: POST /api/v1/commissions/<id>/teachers y DELETE /api/v1/commissions/<id>/teachers/<user_id> con control de duplicados y asignación dinámica.
      • Integración visual en el detalle de la comisión (/admin/commission_detail) con tarjeta interactiva para vincular/desvincular integrantes del equipo docente y badges de rol en la grilla general (/admin/commissions_list).
    • Estadio 2.2 — Matriz de Conflictos y Validación Integral:
      • Conflicto Físico Estricto: Bloqueo estricto de superposición horaria en la misma aula física (ReservationRepository.find_overlapping & check_physical_conflicts).
      • Conflicto Docente Inteligente: Detección de doble reserva simultánea para un mismo profesor (ReservationRepository.find_teacher_conflicts & check_teacher_conflicts).
      • Excepción Justificada por Co-docencia: Si un docente asignado presenta solapamiento pero la comisión cuenta con co-docentes registrados en CommissionTeacher, el motor de conflictos autoriza la reserva validando la cobertura del equipo de cátedra.
      • Conflicto de Aforo: Bloqueo estricto cuando la cantidad de asistentes esperados (expected_attendees) excede la capacidad física declarada del aula (classroom.capacity).
      • Endpoint unificado POST /api/v1/reservations/check-conflicts para pre-validación asíncrona de conflictos físicos, docentes y de capacidad antes del guardado.
    • Estadio 2.3 — Regla de Restricción Diaria del Alumno y Motor de Excepciones:
      • Servicio académico EnrollmentService (backend/app/services/enrollment_service.py) para control de cupos, inscripciones activas y análisis de días de cursada.
      • Regla Diaria: Un alumno no puede matricularse en dos materias regulares programadas para el mismo día de la semana.
      • Excepción Automática por Curso Corto: Indicador is_short_course en modelo Subject; si una de las asignaturas es un taller, seminario o curso corto, el sistema autoriza automáticamente la cursada simultánea en el mismo día.
      • Excepción Expresa de Bedelía: Parámetros allow_same_day_exception y exception_reason en el modelo StudentEnrollment, permitiendo a Bedelía inscribir alumnos con justificación administrativa expresa (cambio de plan, equivalencias, etc.).
      • Endpoints de gestión de matrículas por comisión: GET /api/v1/commissions/<id>/enrollments, POST /api/v1/commissions/<id>/enrollments, DELETE /api/v1/commissions/<id>/enrollments/<student_id> y PUT /api/v1/commissions/<id>/enrollments/<student_id>.
      • Adaptación completa de UI en /admin/commission_detail con selector de estudiantes, toggle interactivo de excepción de Bedelía, campo de motivo justificado, y tabla de estudiantes matriculados con badges de excepción.
    • Suite de Pruebas Unitarias e Integrales de Reglas de Negocio:
      • Archivo backend/tests/test_phase2_rules.py con 6 tests completos verificando: bloqueo físico, conflicto de aforo, detección docente con bypass de co-docencia, restricción diaria de cursada, excepción por curso corto y excepción por autorización manual de Bedelía. 100% de tests aprobados.
    • Mejoras UI/UX en Dashboard de Bedelía:
      • Paneles interactivos para visualizar Comisiones Sin Reserva de Aula y Aulas Disponibles con soporte de filtrado temporal (Semana/Mes) directamente consumiendo estadísticas en tiempo real del motor backend.
    • Fase 1: Auditoría y Seguridad Automatizada:
      • Control de Entorno Dev: Aislamiento de herramientas de seguridad en requirements-dev.txt.
      • Automatización Local e Integración Continua: Correcciones de evaluación en security_audit.bat para Windows y actualización de .gitea/workflows/security-audit.yaml para asegurar la correcta ejecución del stack de auditoría (Bandit, pip-audit, njsscan y Schemathesis).

[2.5.0] - 2026-09-19

Añadido

  • Auditoría y Seguridad Automatizada Completa (Python & Node.js):
    • Python SAST (bandit): Escaneo estático del backend Flask de más de 8.400 líneas. Corrección de vulnerabilidad B310 en sheets_importer.py mediante validación estricta de esquema HTTP/HTTPS para prevenir ataques de tipo SSRF. Resultado: 0 fallos detectados.
    • Python SCA (pip-audit): Análisis de dependencias con base OSV; detección de 24 CVEs históricas en paquetes desactualizados y actualización completa a versiones seguras (Flask>=3.1.3, Werkzeug>=3.1.8, requests>=2.34.2, bleach>=6.4.0, python-dotenv>=1.2.3). Resultado: 0 CVEs activas.
    • Python DAST / Fuzzing (schemathesis): Especificación OpenAPI 3.0.3 en backend/app/routes/api/openapi.py (/api/v1/openapi.json). Ejecución de 114 casos de prueba dinámicos con mutación de datos. Detección y corrección de caída 500 por payload de tipo JSON inválido en /auth/login. Resultado: 114/114 pruebas aprobadas con 0 errores de servidor.
    • Node.js SAST (njsscan): Análisis de patrones de código inseguro en el BFF Express (frontend/src). Resultado: 0 hallazgos.
    • Node.js SCA (npm audit): Auditoría continua de paquetes npm con 0 vulnerabilidades reportadas.
    • Blindaje Activo (helmet & express-rate-limit): Incorporación de cabeceras HTTP defensivas (HSTS, nosniff, SAMEORIGIN, X-Permitted-Cross-Domain-Policies) y limitadores de tasa ante fuerza bruta en /auth/login (30 req / 15 min) y /api (180 req / min).
    • Script Unificado de Auditoría (security_audit.bat): Ejecutable centralizado para correr los 5 controles en un solo comando.
    • Documento Formal de Seguridad (SECURITY_AUDIT_REPORT.md): Reporte ejecutivo de auditoría y controles continuos.

[2.4.0] - 2026-09-19

Añadido

  • Perfil Extendido de Usuarios y Tipificaciones de Documentos Oficiales (Argentina y Extranjeros):
    • Incorporación en el modelo User de los campos: first_name (Nombre), last_name (Apellido), email (Email Institucional de acceso), personal_email (Email Personal/Particular de contacto), phone (Teléfono con código de área), address (Domicilio/Dirección), document_type (Tipo de documento) y document_number (Número de documento validado).
    • Catálogo formal de reglas de negocio en backend/app/constants/document_types.py con tipificaciones oficiales de Argentina y extranjeros (DNI, CUIL, Pasaporte Argentino, Pasaporte Extranjero, DNI Extranjero, Cédula de Identidad PFA, Cédula Mercosur, Libreta Cívica y Libreta de Enrolamiento).
    • Validaciones de formato, expresiones regulares, y verificación de unicidad de documento por tipo en endpoints POST /api/v1/users y PUT /api/v1/users/<id>.
    • Búsqueda dinámica en /admin/users_list habilitada para filtrar por número de documento o email personal/institucional además de nombre.
    • Rediseño del formulario /admin/users/form estructurado en secciones: Identidad y Documentación, Contacto y Domicilio (con Teléfono, Email Personal y Dirección), y Cuenta y Rol Institucional (con Email Institucional y Clave), permitiendo al Administrador General gestionar la totalidad de los datos.
    • Script de migración SQLite backend/migrate_user_profile_fields.py para agregar las columnas e inicializar nombres desglosados de los usuarios existentes.
  • Co-Docencia y Cátedras Múltiples en Comisiones:
    • Creación del modelo relacional CommissionTeacher (commission_teachers) para asociar múltiples docentes a una misma comisión con roles académicos diferenciados (Titular, Adjunto, JTP, Ayudante).
    • Nuevos endpoints en la API REST: POST /api/v1/commissions/<id>/teachers y DELETE /api/v1/commissions/<id>/teachers/<user_id>, junto con la serialización completa de cátedras en GET /api/v1/commissions.
    • Nueva tarjeta interactiva "Equipo Docente / Cátedra" en el detalle de la comisión (/admin/commission_detail?id=...) permitiendo agregar y desvincular docentes con sus respectivos roles.
    • Actualización de la grilla de comisiones (/admin/commissions_list) para exhibir a todos los profesores asignados con badges distintivos de rol.
  • Eliminación y Gestión Segura de Asignaturas:
    • Incorporación de botón y modal interactivo de confirmación de eliminación de asignaturas en /admin/subjects_list.
    • Implementación de regla de negocio de integridad académica: eliminación física si la materia no tiene comisiones asociadas, o desactivación automática si posee historial o cursadas vinculadas.

Corregido

  • Bug Visual en Modificación de Asignaturas (/admin/subjects_list):
    • Solucionado el problema de modales recortados o cubiertos por el fondo oscuro (modal-backdrop), originado por la presencia de 206 modales inline dentro de celdas <td> en una tabla con overflow (.table-responsive). Se refactorizó hacia un único modal global #modalEditSubject instanciado fuera de la tabla e inicializado dinámicamente con JavaScript.

Añadido

  • Monitoreo y Percentiles de Asignación de Aulas Físicas (Admin & Bedelía):
    • Panel analítico "Estado y Percentiles de Asignación de Aulas Físicas" incorporado en los dashboards de Administrador (/dashboard?role=admin) y Bedelía (/dashboard?role=bedelia).
    • Cálculo dinámico en tiempo real de Aulas Asignadas en número y percentil (26 aulas · 96.3%) con enlace directo a cursadas activas.
    • Cálculo dinámico en tiempo real de Aulas Sin Asignar / Libres en número y percentil (1 aula · 3.7%) con enlace directo al formulario de asignación de espacios.
    • Barras de progreso visuales con desglose dual: Planificación Cuatrimestral (96.3% asignado vs 3.7% disponible) y Ocupación Operativa del Día (aulas con clases hoy vs aulas libres).
    • Exposición de métricas de asignación y percentiles en el endpoint de la API REST GET /api/v1/dashboard/stats.
  • Módulo de Cursadas Asignadas y Métricas Reales en Catálogo Presencial (/classrooms/list_classrooms?view_mode=physical):
    • Incorporación de la sección "Cursadas Asignadas" dentro de cada tarjeta de aula física y columna en vista de tabla, detallando asignaturas, comisiones y turnos.
    • Métricas de ocupación física real por período (Día, Semana, Mes) con porcentajes calculados dinámicamente (6%, 11%, 17%, 22% según la carga horaria del aula).
    • Botones de acción directa con ID dinámico: Ficha (/classrooms/view_classroom?id=...), Horarios en Calendario (/schedule/calendar_view?classroom_id=...) y Editar.
    • Conexión de la tabla "Próximas Clases y Reservas" en la ficha individual del aula (/classrooms/view_classroom) con las reservas reales del cuatrimestre y enlaces a cada reserva (/schedule/view_reservation?id=...).

Modificado

  • Dashboard Docente (/dashboard?role=docente):
    • Eliminado el botón flotante "Reservar Aula / Solicitar espacio para clase" (/schedule/add_reservation) a petición de los requerimientos funcionales del cuerpo docente.
    • Reorganizada la grilla superior a 3 columnas simétricas (col-md-4) para las tarjetas de Mis Clases Hoy, Mis Reservas Activas y Aulas Virtuales.

Corregido

  • Fallo Crítico de Renderizado en Nunjucks (memberLookup con .items):
    • Solucionada la incompatibilidad de nunjucks/src/jinja-compat que interceptaba la propiedad .items convirtiendo classrooms.items en una función interna en lugar de un array, lo que impedía dibujar las tarjetas de aulas presenciales en frontend/views/classrooms/list.html.
    • Implementado interceptor en memberLookup en frontend/src/app.js para preservar arrays intactos.
  • Clasificación Errónea de Reservas Físicas como Virtuales (is_virtual):
    • Corregida la propiedad @property is_virtual en Reservation (backend/app/models/reservation.py) para garantizar que si una reserva tiene aula física asignada (self.classroom and not self.classroom.is_virtual), siempre sea clasificada como presencial (is_virtual = False), evitando falsos positivos cuando la comisión posee un enlace virtual predeterminado.
  • Excepción de SQLAlchemy en Estadísticas de Dashboard:
    • Corregido el error de ejecución generado al invocar .ilike() sobre la propiedad Python @property Classroom.room_number en backend/app/routes/api/dashboard.py, migrando la clasificación de aulas presenciales y virtuales a una evaluación robusta en memoria Python (Classroom.code y Classroom.building).

[2.2.0] - 2026-09-19

Añadido

  • Herramienta de Purga y Reinicio de Datos Académicos (reset_academic_data):
    • Script CLI backend/scripts/reset_academic_data.py con argumentos de limpieza granular (--all, --reservations, --classrooms, --careers, --yes).
    • Endpoint de API POST /api/v1/admin/reset-academic-data protegido por JWT (rol admin) con registro en AuditLog.
    • Panel interactivo "Zona de Reinicio y Purga Académica" en /admin/google_sheets_import con checkboxes independientes para reservas, aulas, comisiones, asignaturas y carreras.
    • Modal modal de confirmación con advertencias de seguridad para prevenir purgas accidentales.
    • Preservación íntegra de usuarios del sistema, credenciales de acceso, roles RBAC y registros de auditoría.
  • Configuración Global Dinámica de Google Sheets:
    • Nuevo modelo SystemSetting (backend/app/models/setting.py) para almacenamiento persistente clave-valor en base de datos.
    • Endpoints GET /api/v1/admin/sheets-config y POST /api/v1/admin/sheets-config.
    • Normalizador de enlaces en GoogleSheetsImporter compatible con URLs compartidas de edición (/spreadsheets/d/.../edit) o enlaces publicados (/pub?output=csv).
    • Interfaz web con formulario de edición de URL, botón de guardado en caliente, restauración a URL oficial predeterminada y acceso directo a Google Docs.
  • Visualización de Asignaturas Reales:
    • Tabla de asignaturas recientemente sincronizadas conectada a la base de datos real en lugar de datos de muestra (mock).

Corregido

  • Fallo por Timeout en Google Sheets Academic Sync:
    • Solucionado el corte prematuro de conexión en el BFF (frontend/src/services/apiClient.js), aumentando el timeout base a 25s y el timeout específico de sincronización a 90s (anteriormente limitado a 5s en operaciones que toman ~6.7s).
    • Eliminado el enmascaramiento silencioso de errores en el BFF, permitiendo reportar fallos reales o éxitos detallados (+carreras, +aulas, +materias, +comisiones, +reservas).

[2.1.0] - 2026-09-19

Añadido

  • Ficha Detallada de Reserva (schedule.view_reservation):
    • Implementación en BFF Node.js de la ruta /schedule/view_reservation (soportando parámetros :id, ?id= o selección automática del primer registro).
    • Vistas y controladores para modificar reservas con selectores en cascada (/schedule/edit_reservation).
    • Endpoints de acción rápida en backend y BFF: POST /schedule/confirm_reservation y POST /schedule/cancel_reservation.
    • Actualización de enlaces en today.html, list.html, dashboard.html y view.html para navegar directamente con el identificador de la reserva (?id=...).
  • Creación y Asociación de Comisiones a Asignaturas (admin/commissions_list):
    • Botón destacado + Nueva Comisión en el encabezado y en el estado vacío de la tabla.
    • Modal interactivo #modalAddCommission con selección obligatoria y clara de la Asignatura / Materia Asociada (<select name="subject_id" required>), mostrando código oficial, nombre y carrera.
    • Campos completos de cursada: cuatrimestre (1C/2C/Anual), año lectivo, turno, docente a cargo, cupo máximo y días/horarios.
    • Generación y configuración automática de enlace a Google Meet institucional cuando no se ingresa un enlace personalizado.
    • Alerta de confirmación visual (?created=1) al registrar y vincular una comisión exitosamente.
    • Tabla de comisiones actualizada con visualización explícita del código de materia, nombre y badge de carrera.
  • Enriquecimiento de la API REST:
    • Endpoint GET /api/v1/reservations/<id> ampliado con objetos relacionales anidados: classroom (código, edificio, piso, capacidad, descripción, virtualidad), commission (código, código compuesto, materia), user (docente, nombre, apellido, correo), duración en minutos y enlaces virtuales.
    • Endpoint POST /api/v1/admin/commissions con validación estricta de existencia de asignatura y resolución inteligente de unicidad.

[2.0.0] - 2026-09-18

Añadido

  • Reingeniería de Arquitectura Fullstack (Desacople Monolito -> Backend + BFF):
    • Desacople completo del backend Python/Flask como una API REST pura bajo /api/v1/ retornando exclusivamente JSON.
    • Implementación del Frontend BFF en Node.js + Express con renderizado de servidor mediante Nunjucks.
    • Autenticación sin estado (Stateless) basada en tokens JWT firmados con algoritmo HS256.
    • Almacenamiento seguro del token de acceso en cookies del navegador con directivas HttpOnly, SameSite=Lax y Secure.
    • Inyección transparente del token Bearer en peticiones internas mediante cliente Axios centralizado.
  • Dashboards Personalizados por Rol Institucional:
    • Dashboard de Bedelía (/dashboard?role=bedelia): Métricas operativas de campus físico y virtual, cartelera del día y panel de aprobación de solicitudes pendientes.
    • Dashboard de Docente (/dashboard?role=docente): Sesiones del día con botones directos para ingresar a reuniones virtuales (Meet/Teams/Zoom) y formulario de solicitud de aulas.
    • Dashboard de Alumno (/dashboard?role=alumno): Brújula de cursada "¿Dónde curso hoy?" con ubicación por piso/aula o enlace virtual, junto al calendario de exámenes y entregas.
    • Dashboard de Administrador (/dashboard?role=admin): Cockpit institucional de capacidad, usuarios, auditoría RBAC y distribución de comisiones.
    • Selector dinámico de vista previa de roles en el banner superior para administradores.
  • Cartelera del Día Interactiva (/schedule/today_schedule):
    • Grilla estructurada en bloques horarios (07:00 a 21:00 hs) con métricas en tiempo real de ocupación y reservas confirmadas/pendientes.
    • Filtro dinámico para ocultar clases virtuales (hide_virtual=1) y segmentación por pisos o turnos.
  • Seguridad Enterprise (SecurityFilterChain):
    • Pipeline centralizado de cabeceras de blindaje OWASP (nosniff, SAMEORIGIN, X-XSS-Protection, Strict-Transport-Security).
    • Rate limiting dinámico contra ataques de fuerza bruta en endpoints de autenticación.

Corregido

  • Resolución de Colisión de Horarios en Clases Virtuales (Importador de Google Sheets):
    • Corrección de la búsqueda de duplicados en sheets_importer.py que limitaba indebidamente la unicidad a (classroom_id, start_time, end_time).
    • Habilitación de concurrencia ilimitada para el aula virtual (Campus Virtual · VIRTUAL) mediante discriminación por commission_id.
    • El total de reservas registradas aumentó de 363 a 643 (incorporando 280 clases virtuales que eran descartadas por falso conflicto).
    • Generación y guardado automático de enlaces institucionales de Google Meet (https://meet.google.com/edu-{materia}-{comision}).

[1.0.0] - 2026-09-04

Añadido

  • Versión Monolítica Base (legacy_admin-edu-space):
    • Aplicación monolítica en Flask con plantillas Jinja2 y persistencia SQLAlchemy (SQLite / PostgreSQL).
    • Modelado de datos inicial para sedes, aulas físicas, materias, comisiones, usuarios y reservas.
    • Sistema de roles inicial (Admin, Bedelía, Docente, Alumno) basado en sesión tradicional de Flask-Login.
    • Calendario de reservas mensual y semanal con FullCalendar.
    • Prototipo experimental de algoritmo genético para optimización de ocupación áulica.
    • Módulo de sincronización inicial con planillas de Google Sheets.