Files
admin-edu-space/CHANGELOG.md
T

172 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.53] - 2026-10-28

Added & Improved (Reconexión/Desconexión Robusta de Lectores COM y URL Oficial de Moodle con Guía de Contraseñas en RAG)

  • Ciclo de Vida y Reconexión Automática Plug & Play de Lectores COM:
    • Detección de eventos nativos de hardware navigator.serial.addEventListener('connect', ...) y 'disconnect', permitiendo la auto-reconexión inmediata al enchufar o re-enchufar escáneres USB-Serial sin necesidad de recargar la página.
    • Reutilización inteligente de puertos COM autorizados: el botón rápido "Conectar Lector COM" reasigna puertos ya concedidos por el navegador antes de forzar el modal del sistema operativo.
    • Cierre y desconexión segura sin bloqueo de streams en Windows (reader.cancel(), reader.releaseLock() y port.close()), previniendo errores de "puerto ocupado".
    • Barra de acciones globales en /reception/scanner: botón prominente "Conectar Lector COM", "Reconectar Autorizados" y "Desconectar Todos".
    • Timeout automático de seguridad (120ms) en el buffer de chunks para escáneres que no transmitan terminadores \r/\n.
  • Actualización de Moodle en Base de Conocimiento RAG y Chatbot UdeCi:
    • Configuración de la URL oficial estricta del Campus Virtual de UniCABA: https://campus.udelaciudad.edu.ar (con hipervínculo descriptivo [Campus Virtual UniCABA](https://campus.udelaciudad.edu.ar)).
    • Especificación explícita de que Admin Edu-Space NO establece, almacena ni gestiona las contraseñas de Moodle ni de Google Workspace.
    • Incorporación en RAG y Regla 11 del System Prompt de UdeCi de las 3 modalidades de acceso institucionales:
      1. Google Workspace (@unicaba.edu.ar): Correo y contraseña administrada por Google.
      2. Campus Virtual Moodle: Acceso con DNI/usuario y contraseña emitida por Moodle / Campus Virtual de forma independiente (con enlace al recuperador oficial https://campus.udelaciudad.edu.ar/login/forgot_password.php).
      3. Acceso Local: Cuentas administrativas o de emergencia locales en Edu-Space.

[3.8.52] - 2026-10-28

Added & Enhanced (Soporte Multi-Lector de hasta 4 Puertos COM y Reconocimiento Universal de DNI Argentino)

  • Soporte Multi-Lector Serie COM (Hasta 4 Lectores Simultáneos):
    • Se extendió el motor de lectura serie a la clase MultiSerialBarcodeScanner en frontend/public/js/serial-scanner.js, administrando 4 ranuras de hardware independientes (Lector 1 (Paso Principal), Lector 2 (Molinete / Acceso), Lector 3 (Mesa Bedelía), Lector 4 (Auxiliar / Puesto 2)).
    • Cada ranura dispone de control individual de apertura (requestPort), configuración de velocidad en baudios (9600 predeterminado / 115200), LED indicador con pulso en vivo (bg-success), botón conectar/desconectar y reconexión automática en bloque con reconnectAuthorizedComPorts().
    • La interfaz de recepción destaca visualmente la ranura que originó cada escaneo (flashSlotCard) y notifica en el badge flotante la terminal emisora (ej: ¡Nuevo Escaneo! Lector 2 (Molinete)).
  • Módulo de Reconocimiento y Parseo de DNI Argentino (argentine_dni_parser.py):
    • Implementación del algoritmo oficial de extracción y normalización de documentos de identidad argentinos para códigos de barras PDF417 y QR emitidos por Renaper y la App Mi Argentina:
      • Formato 2026: DNI en posición 3 con ejemplar alfabético (00749743816"TELLO"CARLOS FACUNDO"34247025"G"...).
      • Formato 2009 con comilla inicial: Posición fija de documento, apellido, nombre y sexo ("20979166 "A"1"CASTIGLIONI"...).
      • Formato 2009 con prefijos de género antiguos: Manejo de prefijos F / M ("f5592570 "A"1"SAUCEDO"... ➔ DNI 5592570).
      • Formato App Mi Argentina: Con sexo numérico 1=M, 2=F, 3=X y DNI numérico (305336518"CIRILLI"... / 680051210"TELLO"...).
      • Formato 2012: Sexo en posición 3 y DNI en posición 4 (00225303383"RIO"MARTINA"F"46585482"...).
      • Tolerancia de delimitadores: Compatibilidad idéntica con delimitadores de comilla doble (") y arroba (@).
  • Integración Académica en Tiempo Real en QRSecurityService:
    • Al escanear un DNI físico o credencial digital Renaper, el backend extrae el número de documento y busca de forma transparente al alumno, docente o bedel en el padrón (document_number, username o email).
    • Si el usuario existe, se validan sus permisos y se computan sus clases del día en la sede física.
    • Si no existe en la base de datos de UniCABA, el sistema responde informando claramente los datos leídos del documento físico (ej: "DNI argentino 34247025 (TELLO CARLOS FACUNDO) no se encuentra registrado en el padrón de UniCABA").
  • Suite de Pruebas Automatizadas:
    • Se añadieron 9 pruebas unitarias en backend/tests/test_dni_parser.py validando todos los formatos y ejemplos provistos, alcanzando 17/17 pruebas superadas en el backend.

[3.8.51] - 2026-10-28

Added & Improved (Alerta Visual Ámbar sin Clases Hoy e Interacciones de Detección de Nuevo Escaneo en Recepción)

  • Diferenciación Cromática por Cursada del Día (/reception/scanner):
    • Se implementó un esquema de color diferenciado cuando el alumno/titular está activo/regular pero no tiene clases presenciales programadas para la fecha:
      • Cuadro con Cursada Hoy: Borde verde border-success, cabecera verde esmeralda y badge "Tiene Cursada".
      • Cuadro sin Cursada Hoy: Borde ámbar border-warning, fondo suave #FFFDF5, cabecera ámbar de advertencia (bg-warning text-dark fw-bold), badge distintivo "Sin Cursada Hoy" y alerta explicativa alert-warning con icono de calendario tachado indicando que no tiene aula física asignada.
  • Interacción Dinámica para la Detección Inmediata de Nuevos Escaneos:
    • Efecto de Destello / Pulso Visual: Cada nuevo escaneo recibido re-dispara una animación CSS de resplandor (animate-scan-success, animate-scan-warning o animate-scan-danger) forzando reflow del DOM, lo que permite a la operadora notar el escaneo al instante incluso por visión periférica.
    • Badge Flotante Animado: Muestra el indicador ¡Nuevo Escaneo Registrado! (animate-pulse-badge) en la cabecera durante los primeros 2.5 segundos de cada lectura.
    • Feedback Auditivo Diferenciado (Web Audio API):
      • Tono Armónico Doble Ascendente (587Hz -> 880Hz): Cuando el alumno o docente tiene clases programadas hoy con aula asignada.
      • Tono Suave Medio (440Hz -> 554Hz): Cuando el alumno ingresa pero no tiene clases hoy (aviso para control de Bedelía).
      • Tono Grave de Alerta (220Hz): Ante accesos denegados, credenciales expiradas o no registradas.

[3.8.50] - 2026-10-28

Added & Changed (Depuración de Sedes Físicas en Recepción, Eliminación de Cámara y Especificación SDD-013 Web Serial COM)

  • Depuración de Sedes en la Consola de Recepción:
    • Se filtró estrictamente el selector de sedes (/reception/scanner) para mostrar únicamente sedes físicas/presenciales, excluyendo completamente al Campus Virtual por tratarse de un puesto de control físico.
    • Se configuró la sede física Edificio Central (CENTRAL) como el punto de control predeterminado seleccionado al abrir la consola de acceso.
  • Eliminación Total del Escaneo por Cámara Web:
    • Se removió el lector de cámara, la librería html5-qrcode y los botones interactivos asociados, reconvirtiendo la columna de escaneo en un panel dedicado de alta velocidad para pistolas ópticas y lectores por puerto serie.
  • Especificación e Integración SDD-013 (Lector Óptico por Puerto Serie COM):
    • Creación de la especificación SDD-013 (specs/013-escaner-qr-puerto-com-serial/ con spec.md, plan.md, tasks.md) bajo sintaxis EARS en español.
    • Implementación del módulo frontend serial-scanner.js utilizando la Web Serial API (navigator.serial) para motores Chromium (Google Chrome, Microsoft Edge, Opera, Brave) en entornos Windows.
    • Permite la captura directa de lecturas de código de barras y QR desde puertos COM físicos/virtuales sin depender del foco del cursor ni de la emulación de teclado, con reconexión automática y bufferizado por delimitador de línea.

[3.8.49] - 2026-10-28

Added & Fixed (Anti-Captura Estricto en QR Dinámico, Corrección de Zona Horaria de Buenos Aires y Registro Óptico)

  • Corrección Integral del Desfasaje Horario en Registros de Ingreso:
    • Se corrigió el desfasaje de 3 horas en la visualización de ingresos en la Consola de Recepción (/reception/scanner), donde los registros se mostraban en hora UTC (16:18 hs) en lugar de la hora local argentina (13:18 hs).
    • Se implementó la función to_argentina_time en el backend (reception.py) para convertir los datetimes a la zona horaria oficial America/Argentina/Buenos_Aires (UTC-3), poblando el nuevo atributo scanned_time ("HH:MM hs").
    • En el frontend (reception.js y scanner.html), se adaptaron tanto el render inicial de Nunjucks como las actualizaciones AJAX periódicas para formatear la hora en la zona horaria institucional de Buenos Aires.
  • Ventana Estricta Anti-Captura de Pantalla en el QR Dinámico:
    • Se ajustó el periodo de gracia y expiración del token JWT dinámico (valid_seconds) reduciéndolo de 60 segundos al valor estricto de seguridad de 6 segundos (por defecto renewal_seconds + 3).
    • Esto garantiza que cualquier captura de pantalla o fotografía tomada al código QR expire a los pocos segundos, siendo categóricamente rechazada por el backend si han transcurrido 10 segundos o más (jwt.ExpiredSignatureError).
    • Se priorizó la validación criptográfica estricta de JWT en QRSecurityService.decode_and_resolve_user con mensaje claro de advertencia al operador: "La credencial digital ha expirado (anti-captura activo). Renueve el código en la pantalla del usuario."

[3.8.48] - 2026-10-28

Added & Fixed (Optimización de Respuestas de UdeCi, Control Óptico en Recepción y Normalización de Teclado Español)

  • Fidelidad Fáctica y Listados Directos de Comisiones y Docentes en UdeCi:
    • Se optimizó LiveContextService para inyectar la nómina completa y verídica de comisiones activas (código, asignatura, turno, docente asignado e inscriptos) ante consultas explícitas ("qué comisiones hay", "dame un listado", "lista todas"), evitando que el asistente evada la respuesta refiriendo al usuario al menú.
    • Se corrigió la búsqueda de docentes y comisiones en LiveContextService, resolviendo asignaciones reales (ej. Alejandro David Vázquez en Gestión de sistemas de información y Seguridad de la Información) y eliminando alucinaciones sobre profesores inexistentes o ficticios.
    • Se actualizaron las directivas del System Prompt de UdeCi reforzando la certeza de que los datos en vivo provienen 100% de la base de datos PostgreSQL institucional, prohibiendo contradicciones o falsas admisiones de datos mock ante dudas del usuario.
  • Forzado Permanente del Foco en la Consola de Recepción:
    • En reception/scanner.html, se implementó captura y forzado activo permanente del cursor en #scannerInput con temporizador cíclico (2s), foco inmediato al cargar y tras cada escaneo, y re-enfoque ante clics en zonas vacías de la pantalla para pistolas ópticas USB HID.
    • Se incorporó un indicador visual con animación de pulso (Lector Listo) que confirma el estado activo del cursor.
  • Compatibilidad con Pistolas Ópticas en Distribución de Teclado en Español:
    • Se solucionó el fallo de lectura donde los lectores ópticos configurados con emulación de teclado US traducían los dos puntos (:) a la letra Ñ en sistemas operativos en español (generando cadenas como UNICABAÑUSRÑ144ÑDNIÑ).
    • QRSecurityService.decode_and_resolve_user normaliza de forma bidireccional los delimitadores Ñ / : y analiza mediante expresiones regulares tanto tokens JWT como identificadores institucionales directos (USR:<id>, DNI:<doc>), validando y autorizando inmediatamente el ingreso.
  • Ruta Predeterminada y Dashboard para el Perfil de Recepción:
    • Se configuró /reception/scanner como página de inicio y panel predeterminado para usuarios con rol RECEPCION en el login local, login de Moodle, autenticación de Google Workspace, impersonación, redirección de raíz / y /dashboard.
    • El logotipo y cabecera de la aplicación dirigen automáticamente a la consola de recepción cuando el usuario activo posee dicho rol.

[3.8.47] - 2026-10-28

Fixed & UX (Depuración de Botón Redundante y Aislamiento Total de Fondo en Modal QR)

  • Eliminación del Botón Redundante "Rotar Ahora":
    • Se eliminó el botón manual innecesario btnRefreshGlobalQr del modal de credencial (user_qr_modal.html), simplificando la interfaz ya que la rotación opera de manera 100% automatizada e imperceptible cada 3 segundos.
    • El botón "Ver Carnet Completo" ahora se presenta como acción primaria limpia y centrada.
  • Aislamiento Total de Interacción y Bloqueo de Scroll de Fondo:
    • Se implementó bloqueo estricto de desplazamiento en el elemento raíz html.modal-open y body.modal-open (overflow: hidden !important; touch-action: none; overscroll-behavior: none;).
    • Se añadieron trampas de eventos táctiles y de rueda del ratón (wheel, touchmove) en el contenedor del modal con passive: false para interceptar y prevenir cualquier fuga de desplazamiento hacia la página subyacente.
    • Se ajustó el z-index de .modal-backdrop.show a 1075 !important; y #userQrCredentialModal a 1080 !important;, garantizando que la cortina oscura cubra de forma impenetrable la cabecera móvil (1030), el sidebar (1060) y widgets flotantes.
    • Se integró el repliegue automático del menú lateral móvil (closeMobileSidebar()) al dispararse el evento show.bs.modal, previniendo solapamientos o interacciones accidentales detrás del modal.

[3.8.46] - 2026-10-28

Added & Security (Rotación Dinámica de Código QR cada 3 Segundos y Configuración Global)

  • Rotación Dinámica de Código QR Anti-Captura (3 Segundos):
    • Se implementó la renovación automática del código QR cada 3 segundos en el modal global (user_qr_modal.html), en el perfil de usuario (profile.html) y en la credencial completa (card.html).
    • Se incorporó una barra de progreso animada con gradiente y contador en vivo en milisegundos que exhibe visualmente la rotación activa y la protección anti-screenshot / anti-fraude.
    • El bucle de rotación se pausa automáticamente cuando el modal se cierra o la pestaña pasa a segundo plano (visibilitychange), optimizando recursos de red y CPU.
  • Configuración Global Parametrizada (SystemSetting):
    • Se agregaron las variables de configuración qr_renewal_interval_seconds (por defecto: 3s) y qr_token_grace_period_seconds (por defecto: 60s) en backend SystemSetting.
    • Se creó una nueva pestaña en el panel de Configuración Global (/admin/settings -> Credencial QR & Acceso) con formulario de ajuste, selector de accesos directos (3s, 5s, 10s, 30s) y explicación técnica de la ventana de gracia criptográfica.
    • Endpoints expuestos: POST /api/v1/settings/security-qr y GET /api/v1/settings/all.
  • Servicio Criptográfico QRSecurityService y Endpoint de Recepción:
    • QRSecurityService.generate_qr_token ahora admite valid_seconds, generando un JWT firmado con identificador único (jti), marca temporal (iat) y ventana de expiración controlada por la configuración de gracia.
    • El endpoint /api/v1/reception/my-qr-token entrega en su payload el parámetro renewal_interval_seconds para que los clientes web ajusten su ciclo de renovación de forma dinámica.
  • Suite de Pruebas Automatizadas:
    • Se incorporaron pruebas unitarias y de integración en tests/test_benefits_and_reception.py verificando la entrega del parámetro y la actualización de los valores de configuración en caliente (118/118 pruebas superadas con éxito).

[3.8.45] - 2026-10-28

Added & UX (Acceso Global a Credencial Digital QR y Código QR Dinámico en Perfil de Usuario)

  • Botón Global de Acceso a Credencial QR (qr-credential-btn):
    • Se incorporó un botón de acceso directo con icono bi-qr-code-scan junto al botón de tema visual en el pie de la barra lateral (sidebar-footer) y en la cabecera móvil (mobile-header).
    • Al hacer clic, abre un modal global interactivo (#userQrCredentialModal) con estética de credencial universitaria, datos del usuario autenticado, código QR generado criptográficamente y botón de actualización en tiempo real.
    • Se añadió la opción "Mi Credencial QR" en el menú desplegable del perfil de usuario (user-dropdown-menu).
  • Código QR Dinámico en Vista de Perfil (/auth/profile):
    • Se integró una tarjeta destacada de "Credencial Universitaria · Acceso QR Dinámico" en profile.html, renderizando el código QR firmado con datos de matrícula, DNI y estado activo.
    • Soporte de renovación inmediata con botón "Actualizar Código QR" mediante llamada asíncrona a /credential/token sin recargar la página.
  • Endpoint BFF /credential/token:
    • Se expuso el endpoint JSON en Express para suministrar tokens dinámicos con firma HMAC y tiempo de expiración (72hs) para consumo de clientes web.

[3.8.44] - 2026-10-28

Added & Security (Integración de Permisos RBAC para Beneficios, Recepción y Nuevo Perfil de Recepción)

  • Incorporación de Módulos al Sistema RBAC (SYSTEM_MODULES):
    • Se agregaron oficialmente los módulos benefits (Convenios y Beneficios) y reception (Recepción y Control de Acceso QR) al catálogo maestro en backend/app/models/role.py y frontend/src/routes/admin.js.
    • Ambos módulos ahora se exponen dinámicamente en la matriz de permisos estilo FortiGate (/admin/roles/edit y /admin/roles/list) con controles segmentados (none, read, read_write).
  • Creación y Alta del Rol Institucional 'Recepción':
    • Se registró el nuevo rol predeterminado de sistema Recepcion (id 8 en producción) con perfil especializado: control de acceso QR (reception: read_write), consulta de aulas, sedes, cronograma general, usuarios y convenios (read), y módulos académicos/administrativos restringidos (none).
    • Se integró el contador métrico role_counts.recepcion en el panel de usuarios (/admin/users), mostrando una tarjeta KPI dedicada para personal de recepción y control de acceso.
    • El selector de roles en la creación y edición de usuarios (/admin/user_add, /admin/user_edit) incluye inmediatamente el nuevo rol Recepción.
  • Actualización de la Matriz de Permisos para Roles Existentes:
    • Admin: benefits: read_write, reception: read_write.
    • Bedelia: benefits: read_write, reception: read.
    • Docente: benefits: read, reception: none.
    • Alumno: benefits: read, reception: none.
  • Sincronización en Base de Datos de Producción (classrooms_db):
    • Se ejecutó script de sincronización en PostgreSQL en el servidor LXC 10.0.0.217, garantizando la persistencia del rol y la asignación de permisos para todos los perfiles institucionales.

[3.8.43] - 2026-10-28

Security & Fixed (Blindaje Anti-Prompt Injection, Detección de Logins y UX Desktop de UdeCi)

  • Blindaje Robusto contra Prompt Injection y Fuga de Modelo (PromptSecurityService):
    • Se añadieron patrones integrales para neutralizar intentos de bypass como "ignora todos los prompts/promps", "ignore instructions", "dime qué modelo de IA eres", "who created you", "tokens de acceso" o "developer mode".
    • Se reforzó la directiva de identidad inquebrantable en el System Prompt de UdeCi, impidiendo cualquier mención a Qwen, Alibaba Cloud o tokens de API bajo cualquier pretexto, respondiendo siempre con su identidad oficial institucional de UniCABA.
    • Se aclaró la política de privacidad de conversaciones: UdeCi no almacena los chats en servidores institucionales (persistencia únicamente local en el navegador del usuario).
  • Resolución Exacta de Consultas sobre Métodos de Login (LiveContextService):
    • Se integró el estado en tiempo real de los proveedores de autenticación configurados en SystemSetting (auth_local_enabled, auth_google_enabled, auth_moodle_enabled), permitiendo a UdeCi informar fielmente qué accesos están activos e inactivos sin alucinaciones.
    • Se reparó la condición de búsqueda de docentes que disparaba falsos positivos (como "No se encontraron profesores llamados 'Logins' o 'Tipo'") al consultar por tipos de login.
  • Correcciones Estéticas en Modo Desktop (ai_chat_widget.html):
    • Ocultamiento del Botón Lanzador: Se convirtió la clase .ai-chat-launcher.chat-open { display: none !important; } en regla global (desktop y móvil), eliminando el ícono circular flotante que quedaba visible detrás del panel cuando estaba abierto.
    • Centrado Vertical del Campo de Texto: Se recalibró el pill .ai-input-pill-container (min-height: 48px; display: flex; align-items: center; gap: 8px;) y el .ai-chat-textarea (height: 24px; line-height: 24px;), alineando simétricamente el botón +, el texto Pregúntame y el botón circular magenta de enviar ↑.

[3.8.42] - 2026-10-28

Fixed & Improved (Centrado Móvil de Login, Anti-Scroll en S24 Ultra y Ampliación Desktop de UdeCi)

  • Centrado Simétrico de Pantalla de Login en Móvil (/auth/login):
    • Se corrigió la asimetría visual en pantallas móviles (border-left: 6px sin contraparte derecha) migrando el acento en mobile a border-top: 5px solid var(--brand-primary) con bordes laterales uniformes de 1px.
    • Se implementó min-height: 100dvh y margin: auto en .auth-card, garantizando un centrado óptico y matemático perfecto en cualquier teléfono móvil (incluyendo Samsung Galaxy S24 Ultra) sin recortes por la barra de navegación de Android.
    • Se ajustó el padding horizontal interno de la tarjeta a px-3 px-sm-4 para pantallas estrechas.
  • Eliminación del Leve Scroll / Bamboleo Horizontal en Móvil:
    • Se añadieron reglas de contención estricta en html, body, .app-wrapper, .main-content y .app-main-container (max-width: 100%, overflow-x: hidden, width: 100%, box-sizing: border-box), neutralizando los desbordes provocados por los márgenes negativos de filas Bootstrap (-0.75rem).
  • Ampliación de Dimensiones de UdeCi en Desktop (Estilo Mercado Libre / Mago):
    • Se amplió el ancho y alto del panel de UdeCi (.ai-chat-panel) a width: 480px; height: 700px; (y width: 520px; height: 740px; en pantallas >= 1400px), brindando una presencia visual más amplia y profesional equivalente al asistente de Mercado Pago / Mercado Libre.
    • Se mantuvieron las tarjetas de preguntas rápidas sugeridas (.ai-option-btn) con estética nativa de Meli e íconos contextuales.

[3.8.41] - 2026-10-28

Improved (Ajuste de Posición del Botón Flotante de UdeCi en Móvil)

  • Reposicionamiento Interior del Botón Lanzador (.ai-chat-launcher):
    • Se incrementaron los márgenes inferiores y laterales en la vista móvil (bottom: calc(32px + env(safe-area-inset-bottom, 0px)), right: calc(26px + env(safe-area-inset-right, 0px))), evitando que las esquinas curvas del cristal físico y las barras de gestos de los dispositivos móviles recorten o tapen el ícono de UdeCi.
    • Se añadió soporte dinámico de safe-area-inset-bottom y safe-area-inset-right tanto en mobile como en desktop para una visualización 100% visible, cómoda al tacto del pulgar y ergonómica.

[3.8.40] - 2026-10-28

Fixed (Corrección de Plantilla Nunjucks en Barra Lateral y Limpieza de Atributos)

  • Corrección de Bloque Condicional en base.html:
    • Se corrigió la posición del bloque {% elif user_role == 'recepcion' %} que había quedado ubicado después de {% else %} en la barra lateral (sidebarNav), lo cual provocaba un fallo de renderizado Template render error: unknown block tag: elif al acceder al dashboard.
    • La rama de Recepción ahora precede correctamente a la rama final por defecto ({% else %} para Estudiantes).
  • Refactorización de Atributos HTML y Limpieza de IDE Warnings (@[current_problems]):
    • En benefits/catalog.html y benefits/manage.html, se reemplazó el pasaje de objetos JSON crudos en eventos inline (onclick='openRedeemModal(...), onclick="confirmDelete(...)") por atributos estándar HTML5 (data-*) y delegación de eventos en JavaScript, eliminando posibles fallos de escape y limpiando los errores reportados por el IDE.
    • En live_context_service.py, se removió la llamada redundante str(user_id) sobre un argumento ya tipado como str.

[3.8.39] - 2026-10-27

Added & Enhanced (Club de Beneficios y Convenios Institucionales + Control de Acceso QR / Recepción — SDD-012)

  • Club de Beneficios y Convenios Institucionales:
    • Nuevo modelo relacional InstitutionalBenefit para convenios y promociones comerciales (cafeterías, librerías, gimnasios, tecnología).
    • Panel administrativo de gestión para Bedelía y Administradores (/benefits/manage y /api/v1/benefits) con filtros, métricas en vivo, carga de cupones, porcentaje de descuento y control de vigencia.
    • Catálogo interactivo tipo marketplace para Alumnos y Docentes (/benefits) con filtrado por categorías y revelado seguro de cupones.
    • Valor agregado con IA (UdeCi): LiveContextService enriquecido para responder con convenios activos de la base de datos ante preguntas como "¿Qué descuentos hay en cafetería hoy?".
  • Perfil de Recepción y Control de Acceso QR:
    • Nuevo rol institucional RECEPCION con permisos específicos para mesas de entrada y molinetes.
    • Consola de escaneo de alta velocidad (/reception/scanner y /api/v1/reception/verify-qr) con soporte para cámara web (html5-qrcode) y pistolas ópticas USB de código de barras.
    • Indicador de clase del día en tiempo real: al escanear la credencial, muestra inmediatamente al ingresante su aula física asignada, piso, horario y docente.
    • Nueva Credencial Universitaria Digital (/credential/my-card y /api/v1/reception/my-qr-token) con token dinámico firmado con JWT (credential_qr), DNI institucional y diseño tipo tarjeta universitaria.
    • Modelo AccessLogQR para registro y trazabilidad de ingresos con estados AUTORIZADO, RESTRINGIDO y DENEGADO.

[3.8.38] - 2026-10-27

Fixed & Improved (Resiliencia de Respuesta de UdeCi y Compatibilidad Dual DTO)

  • Corrección de Mapeo de Respuestas en Frontend (response vs reply):
    • Se corrigió el desacople entre el esquema del backend (ChatResponse.response, ChatResponse.quick_options) y el cliente JavaScript (ai-chat-widget.js), el cual provocaba que consultas válidas y fluidas (como "tu dime ?") cayeran en el mensaje de error por defecto ("Disculpa, no pude procesar tu solicitud en este momento.") a pesar de que el backend respondía con éxito (HTTP 200).
    • Se implementó compatibilidad dual tanto en frontend (data.response || data.reply) como en el backend (reply y options como alias directos en ChatResponse).
  • Integración Nativa de Spotlight / Walkthrough:
    • Se conectó data.guide_step con WalkthroughEngine.startStep() para cerrar o minimizar el modal de UdeCi y resaltar interactivamente el botón o menú correspondiente.

[3.8.37] - 2026-10-27

Removed & Cleaned (Simplificación Minimalista del Chatbot UdeCi)

  • Eliminación del Cajón de Consultas Rápidas (#aiChatQuickChips):
    • Se suprimió el bloque intermedio desplegable de chips y botones de consultas rápidas (.ai-quick-chips-drawer), liberando todo el espacio vertical para una conversación fluida y limpia.
    • Se eliminó el botón de filtros/sliders en la cabecera, manteniendo únicamente el botón de nueva conversación (lápiz) y el de cierre.
    • El botón + en la cápsula de entrada ahora realiza el enfoque directo (focus()) en el campo de texto, manteniendo una estética 100% limpia y sin distracciones idéntica a Mercado Libre.

[3.8.36] - 2026-10-27

Added & Enhanced (Rediseño Móvil del Chatbot UdeCi estilo Mercado Libre / Mago)

  • Bottom Sheet Nativo en Móvil (< 768px):
    • Se transformó la interfaz del chatbot en móvil a un Bottom Sheet modal nativo inspirado en la experiencia de Mercado Libre ("Mago"), cubriendo el 92% de la pantalla (height: 92dvh; border-top-left-radius: 28px; border-top-right-radius: 28px;).
    • Incorporación de Backdrop sombreado con desenfoque (#aiChatBackdrop) que bloquea la interacción con la página web de fondo y evita desbordes visuales.
    • Drag Handle Superior Interactiva: Barra de deslizamiento táctil con soporte de gestos (touchmove / touchend) para cerrar el panel deslizando hacia abajo.
    • Cabecera Flotante y Limpia: Botón de retroceso < tipo píldora, ícono Sparkle animado de UdeCi y botones superiores de nuevo chat y atajos rápidos.
    • Disclaimer Institucional: Frase "UdeCi usa inteligencia artificial para responderte." con tipografía limpia.
  • Dock de Entrada y Manejo Dinámico del Teclado Virtual (visualViewport):
    • Cápsula de entrada redondeada (border-radius: 28px) con botón circular + para desplegar atajos temáticos, textarea expandible con placeholder "Pregúntame" y botón de envío circular.
    • Integración de la API window.visualViewport: al desplegarse el teclado táctil en smartphones Android/iOS, el contenedor del chat se recalcula dinámicamente y el input se ancla directamente encima del teclado, eliminando cualquier espacio o transparencia no deseada.
  • Burbujas de Conversación y Acciones de Feedback:
    • Mensaje de usuario en píldora suave a la derecha con marca horaria (HH:mm) en pie de burbuja.
    • Mensaje de UdeCi en texto limpio y aireado con barra de utilidades (copiado al portapapeles con confirmación visual, lectura con síntesis de voz SpeechSynthesisUtterance y pulgares de valoración).
    • Explicitación en System Prompt de las capacidades accesibles del tutor virtual (datos académicos, ocupación, reservas, clima en tiempo real de Sede Central y rutas Google Maps).

[3.8.35] - 2026-10-27

Fixed & Enhanced (Comportamiento de Acordeón Único y Legibilidad de Alto Contraste en Menú Lateral)

  • Acordeón Estricto de Menú Lateral (Un Solo Menú Desplegado):
    • Se incorporó data-bs-parent="#sidebarNav" en los 13 contenedores colapsables (<div class="collapse" id="...">) de la barra lateral para todos los roles (Administrador, Bedelía, Docente y Estudiante).
    • Se reescribió la lógica en JavaScript eliminando el guardado acumulativo de submenús abiertos en localStorage (edu_sidebar_open_submenus).
    • Al cargar cualquier vista, el sistema detecta la URL activa (window.location.pathname), resalta el ítem en curso y despliega únicamente el submenú correspondiente al que pertenece el usuario, colapsando automáticamente todos los demás.
    • En vistas de inicio o tablero principal (/dashboard, /), todos los submenús permanecen elegantemente replegados.
    • Al abrir un submenú manualmente, cualquier otro que esté visible se oculta de forma inmediata.
  • Legibilidad y Contraste WCAG AAA en Tipografía de Navegación:
    • Se corrigió el problema de bajo contraste provocado por clases utilitarias de Bootstrap (.text-info, .text-success, .text-warning, .text-primary) en enlaces de submenús sobre fondo blanco o gris claro, asignando paletas adaptativas oscuras (#0369A1, #15803D, #B45309, #7E22CE en modo claro y sus contrapartes nítidas luminosas en modo oscuro).
    • Se reforzó la legibilidad de los textos en .sidebar-submenu .nav-link con color Slate-900 (#0F172A) y peso seminegrita font-weight: 600.
    • Se incrementó el contraste de los encabezados de sección .sidebar-section-header a Slate-700 (#334155) en modo claro y Slate-300 (#CBD5E1) en modo oscuro con peso font-weight: 800.
    • Se eliminó duplicación de reglas CSS en submenús y se amplió el ancho del sidebar a 275px para evitar desbordes y cortes de palabras compuestas.

[3.8.34] - 2026-10-27

Added & Enhanced (Rediseño Estético del Menú Lateral, Clima del Campus y Enriquecimiento Operativo de UdeCi)

  • Rediseño Estético de Calidad Industrial en Menú Lateral (Sidebar):
    • Micro-interacciones y Efectos Elevados: Se aplicó la misma filosofía visual y dinámica del botón de usuario y del botón de cambio de modo oscuro/claro a todos los elementos del menú lateral:
      • Contenedor de ícono estilizado (.nav-link > i:first-child) tipo badge con fondo tenue, borde sutil y rotación/escalado dinámico al pasar el cursor (transform: scale(1.08) rotate(3deg)).
      • Enlaces de navegación con elevación suave (transform: translateY(-1px) translateX(2px)), glow perimetral y sombras difusas tanto en tema claro como oscuro.
      • Estado activo/expandido (aria-expanded="true") con degradados institucionales UniCABA (#B43E8E a #682CAD), indicador de acento lateral y rotación suave de 180° del chevron indicador.
    • Jerarquía y Encabezados de Sección Semánticos: Incorporación de separadores de sección estilizados (.sidebar-section-header) para los 4 roles institucionales (Admin, Bedelía, Docente, Alumno), aportando orden visual y cognitivo.
    • Submenús Guiados (Tree Layout): Línea vertical continua que conecta visualmente los ítems anidados con animación de desplazamiento lateral (translateX(4px)) en hover.
    • Scrollbar Ultrafino y Limpio: Barra de desplazamiento personalizada de 5px con bordes redondeados y contraste adaptativo según el tema.
    • Estructura HTML Validada: Envoltorio canónico <ul class="sidebar-nav"> garantizando conformidad semántica W3C.
  • Nuevas Funcionalidades Operativas y de Asistencia para UdeCi:
    • Clima en Vivo del Campus Universitario: Integración de WeatherService con la API pública de Open-Meteo para las coordenadas exactas de UniCABA Sede Central (Perón 802, CABA), con temperatura, sensación térmica, humedad, condiciones meteorológicas y velocidad del viento, respaldado con caché de 15 minutos.
    • Hipervínculos Interactivos y Navegación Google Maps: Actualización del renderizador markdown en ai-chat-widget.js para parsear enlaces en formato [Texto](URL) y URLs directas en hipervínculos con estilos tipo badge de alto contraste y apertura segura (target="_blank" rel="noopener noreferrer").
    • Métricas Operativas de Comisiones y Docentes:
      • Cálculo en tiempo real de comisiones sin profesor asignado.
      • Detección precisa de la comisión con mayor cantidad de estudiantes matriculados.
      • Búsqueda y confirmación nominal de docentes registrados (e.g. Sergio Donzelli).
    • Conocimiento Institucional y Alcance RAG: Incorporación de 4 nuevos fragmentos canónicos en RAGService cubriendo cómo llegar a la universidad (medios de transporte, subtes líneas B, C, D y Metrobus), clima del campus, alcance/capacidades del tutor virtual y normas de uso institucional responsable.

[3.8.33] - 2026-10-27

Security & Privacy Hardening (Aislamiento de Calificaciones por Rol y Supresión de Datos Mock en UdeCi)

  • Privacidad Estricta de Calificaciones y Matrícula (Zero Classmate Leakage):
    • Endpoints Backend RBAC: Se incorporó require_roles(["ADMIN", "BEDELIA", "DOCENTE"]) en /api/v1/commissions/{id}/gradebook, /api/v1/commissions/{id}/enrollments y /api/v1/commissions/{id}/gradebook/grades, bloqueando con 403 Forbidden cualquier intento de un alumno de acceder a la sábana general de notas o nómina de compañeros.
    • Redirección Frontend en BFF: Si un alumno intenta acceder a /schedule/gradebook o /schedule/gradebook/:id, es redirigido inmediatamente a /schedule/my_grades ("Mis Calificaciones e Hitos").
    • Detalle de Materia (my_subjects/detail): Suprimida la consulta de nómina de alumnos matriculados para el rol alumno, garantizando total confidencialidad. Se incorporaron accesos rápidos a "Mis Calificaciones e Hitos", "Clases de Hoy" y "Cronograma Semanal".
  • Eliminación Total de Datos Mock y Directiva Anti-Alucinación en UdeCi:
    • Restricción no negociable en el System Prompt de UdeCi prohibiendo expresamente inventar materias ("Introducción a la Programación", "Matemática Discreta", "Laboratorio de Computación"), códigos o notas ficticias.
    • El modelo utiliza única y exclusivamente el ESTADO EN VIVO DEL SISTEMA con temperature: 0.0 para respuestas estrictamente verídicas y deterministas.
    • Prohibida la sugerencia o mención del "Gradebook" a alumnos, orientándolos siempre hacia "Mis Calificaciones e Hitos" (/schedule/my_grades).
  • Verificación de Accesos y Normalización de Perfiles:
    • Normalización robusta insensible a mayúsculas/minúsculas de roles (admin, bedelia, docente, alumno) en base.html y my_subjects.js.
    • Integración completa con el modo de impersonación para que el sidebar y el widget de IA adopten fielmente las herramientas del usuario impersonado.

[3.8.32] - 2026-10-27

Added & Enhanced (Consultas de Calificaciones, Hitos Evaluativos y Próximas Clases Presenciales en UdeCi)

  • Consultas Académicas de Alumnos:
    • Calificaciones y Estado Académico: UdeCi extrae e informa el desglose completo de notas obtenidas por el alumno en cada parcial, trabajo práctico o entrega, su promedio acumulado y su condición académica (Regular, Promociona, Cursando, Desaprobado) directamente del Libro de Calificaciones (GradebookService.get_student_grades).
    • Próxima Clase Presencial: Detección inteligente de la próxima reserva física futura (Reservation con aula no virtual), informando día de la semana en español, fecha (dd/mm/aaaa), horario (HH:MM a HH:MM hs), asignatura, comisión y ubicación física exacta (edificio, piso y aula).
    • Hitos Evaluativos Programados: Listado de fechas, temas y lugares de exámenes o entregas futuras y finalizadas.
  • Consultas Pedagógicas de Docentes:
    • Notas y Calificaciones de Alumnos: El docente puede consultar las notas de sus comisiones o de un alumno específico por nombre (GradebookService.get_commission_gradebook), conociendo promedios de curso, alumnos calificados y desglose de notas por hito.
    • Hitos y Fechas de Examen: Detalle de todos los hitos evaluativos programados para sus comisiones (título, tipo, fecha y hora, aula física o enlace virtual y temario).
  • Acciones Rápidas Actualizadas (ROLE_CHIPS):
    • Alumno: "📍 Próxima Presencial", "📊 Mis Notas", "📚 Mis Materias".
    • Docente: "📝 Notas de Alumnos", "📅 Hitos y Exámenes", "📍 Mis Comisiones".

[3.8.31] - 2026-10-27

Added & Enhanced (Acceso Contextual Profundo del Asistente UdeCi a Entidades Reales por Rol y Usuario)

  • Acceso en Tiempo Real a Contenidos del Sistema (LiveContextService):
    • UdeCi ahora consulta dinámicamente la base de datos relacional y alimenta el prompt con información fidedigna de las carreras activas (Career), asignaturas (Subject), ciclos lectivos (AcademicTerm), sedes (Building) y aulas (Classroom).
    • Experiencia Personalizada para Alumnos: Si el usuario autenticado es un alumno, el asistente conoce sus materias y comisiones inscriptas (StudentEnrollment), sus horarios semanales, si tiene clases hoy y en qué aula física o enlace virtual cursará (Reservation), así como sus próximos exámenes o hitos evaluativos (AcademicMilestone).
    • Experiencia Personalizada para Docentes: El asistente lista las comisiones y materias a su cargo (Commission), cantidad de inscriptos, estado de actas de calificaciones y sus clases asignadas para el día.
    • Balance Operativo para Bedelía: Reporta reservas del día (confirmadas vs pendientes), ocupación física de aulas y total de comisiones activas.
    • Gobierno del Sistema para Administradores: Desglose total de usuarios activos por rol institucional (alumnos, docentes, bedelía, admin) y métricas globales.
  • Búsqueda Dinámica por Consulta (query):
    • Detección de palabras clave y coincidencias instantáneas de asignaturas y aulas en la base de datos para responder de inmediato con código, comisiones, horarios y docentes.
  • Transmisión de Identidad del Usuario en Frontend (ai-chat-widget.js):
    • Envío automático de user_id y user_email junto con user_name y user_role en la carga útil de /api/chat.
  • Esquema Pydantic v2 Actualizado (ChatRequest):
    • Inclusión de los campos opcionales user_id y user_email validados fuertemente.
  • Corrección de Resiliencia en Modelos (Commission.teacher_name):
    • Retorno seguro de teacher.name en caso de que first_name o last_name no estén desagregados, previniendo visualizaciones de cadenas nulas.

[3.8.30] - 2026-10-27

Fixed & Enhanced (Optimización de UI/UX Mobile para Chatbot UdeCi y Dashboard)

  • Experiencia de Usuario de UdeCi en Dispositivos Móviles:
    • El panel conversacional se transforma en un modal/hoja de pantalla completa (100dvh, position: fixed; inset: 0) en pantallas <= 768px, eliminando desbordes y superposiciones.
    • Ocultamiento automático del botón lanzador (#aiChatLauncher.chat-open) mientras el chat está abierto para liberar espacio útil.
    • Bloqueo de scroll del fondo (body.ai-chat-mobile-open) mientras el chat está activo, restaurándose automáticamente al cerrar o presionar Escape.
    • Configurado font-size: 16px en el área de texto de entrada para anular el molesto auto-zoom de iOS Safari.
    • Espaciado seguro para la barra de navegación de móviles con env(safe-area-inset-bottom).
    • Auto-minimizado del chat al disparar un paso de asistencia guiada (Walkthrough), permitiendo ver el elemento iluminado en pantalla de inmediato.
  • Armonización y Corrección del Dashboard en Móviles:
    • Eliminada la regla global perjudicial que forzaba a .btn-group a apilarse verticalmente en columnas con márgenes desmedidos.
    • Convertidos los selectores de período y vistas (#bedeliaPctPeriodSwitcher, #adminPctPeriodSwitcher, #bedeliaScheduleSwitcher, #commFilterPeriodSwitcher, #classFilterPeriodSwitcher) en controles segmentados con desplazamiento horizontal táctil suave (-webkit-overflow-scrolling: touch;).
    • Rediseñadas las pestañas de estado de comisiones y aulas (#commStatusPills, #classStatusPills) como tarjetas táctiles de ancho completo con recuentos alineados.
    • Proporciones compactas y tipografía responsiva para las tarjetas de KPIs en el Dashboard, reduciendo la altura vertical y facilitando la visualización inmediata.
    • Adaptación de leyendas de gráficos circulares para evitar truncamientos y desbordes en pantallas estrechas.

[3.8.29] - 2026-10-27

Fixed & Enhanced (Personalización por Usuario, Nombres Reales de UI, Roles Exclusivos y Spotlight Dinámico)

  • Personalización y Saludo con Nombre Real del Usuario:
    • Inyección de data-user-name en el widget ai_chat_widget.html obtenido de la sesión autenticada (current_user_name).
    • Envío de user_name en la petición /api/chat y adaptación en generate_system_prompt_for_role para saludar y dirigirse siempre al usuario por su nombre real.
  • Diferenciación Estricta de Roles (admin, bedelia, docente, alumno):
    • Separado el rol admin del rol bedelia en backend (generate_system_prompt_for_role) y frontend (getUserRole()).
    • El administrador recibe instrucciones específicas sobre "Gobierno & Sistema", "Usuarios", "Roles RBAC", "Configuración Global" e "Integración de IA", mientras que bedelía es guiada en el flujo académico de 9 pasos.
  • Coincidencia Exacta con la Interfaz Real de Usuario (UI Match):
    • Eliminados nombres genéricos ficticios; UdeCi ahora referencia las secciones y botones exactos de la interfaz (Menú lateral ➔ Espacios & Sedes ➔ Sedes / Edificios, Nuevo Edificio, Agregar Aula Física, Menú lateral ➔ Reservas & Calendario, etc.).
    • Servidor MCP (mcp_server.py) y GuideService actualizados con las rutas reales (/buildings/list_buildings, /classrooms/list_classrooms, /admin/academic_terms_list) y selectores precisos del DOM.
  • Motor de Spotlight & Walkthrough Interactivo con Auto-Despliegue:
    • walkthrough-engine.js implementa revealElementIfHidden(el), desplegando automáticamente submenús colapsados de Bootstrap (#menuEspacios, etc.) y sidebars en móviles antes de posicionar el foco.
    • Soporte de pasos multietapa contextualizados por la ruta actual (current_path).

[3.8.28] - 2026-10-27

Fixed & Hardened (Blindaje Anti-Prompt Injection, Contexto Vivo de Base de Datos y Refinamiento UX/UI de UdeCi)

  • Protección Robusta Anti-Prompt Injection & Guardrails:
    • Implementado PromptSecurityService en backend/app/services/prompt_security.py con normalización Unicode sin diacríticos y filtros regex contra jailbreaks (DAN, Developer Mode, anulación de directivas, fugas de system prompt o credenciales).
    • Sanitización de delimitadores especiales de control LLM (<|im_start|>, <|im_end|>, [INST], etc.).
    • Intercepción preventiva en /api/chat sin invocar el LLM cuando la consulta viola directivas de seguridad.
  • Contexto Vivo de Entidades del Sistema (LiveContextService):
    • Creado LiveContextService (backend/app/services/live_context_service.py) que consulta directamente las sedes, aulas y ciclos lectivos activos de la base de datos relacional.
    • Inyección en tiempo real en el System Prompt de UdeCi, permitiendo responder con nombres y datos reales de sedes y aulas en lugar de respuestas genéricas de falta de acceso.
  • Navegación Visual Amigable en lugar de URLs Canónicas:
    • Prohibido a nivel de System Prompt el uso de URLs técnicas crudas (/buildings, /admin/google_sheets_import, etc.).
    • Actualizados los fragmentos oficiales de conocimiento en rag_service.py para guiar al usuario mediante las opciones del menú (Menú lateral ➔ Sedes / Edificios, Menú lateral ➔ Integraciones ➔ Importar Google Sheets, etc.).
  • Refinamiento de UX/UI y Contraste Sólido (Cero Transparencia en Dark Mode):
    • Eliminado el elemento #aiQuickBar y sus chips fijos invasivos.
    • Eliminado el fallback forzado de las 4 opciones repetitivas en cada respuesta (_extract_options_from_reply ahora sólo expone opciones cuando son relevantes y contextuales).
    • Eliminadas transparencias en Modo Oscuro del chat widget: establecido fondo 100% sólido y opaco (#0f172a y #1e293b) garantizando máxima legibilidad.
  • Auditoría de Seguridad Automatizada (security_audit.bat):
    • Corregida la sintaxis del script batch y agregada la Fase 6 de QA de Seguridad (test_prompt_security.py y test_mcp_and_walkthrough.py).
    • Ejecutada exitosamente con resultado PASS (Bandit 0, pip-audit 0, njsscan 0, npm audit 0, Pytest 9/9 passed).

[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.