Files
admin-edu-space/CHANGELOG.md
T

1361 lines
155 KiB
Markdown

# Changelog Oficial — Admin Edu-Space (UniCABA)
Todas las modificaciones notables a este proyecto serán documentadas en este archivo.
El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y este proyecto se adhiere a [Semantic Versioning](https://semver.org/lang/es/).
---
## [Unreleased]
### Planificado (Fase 6 del Roadmap)
- **Despliegue e Infraestructura (Fase 6):** `docker-compose.yml` productivo orquestando FastAPI (Uvicorn), Node.js BFF (PM2) y PostgreSQL 15, con proxy inverso Nginx, SSL/TLS y compresión.
- **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1.
- **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción.
## [3.8.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.