146 KiB
146 KiB
Changelog Oficial — Admin Edu-Space (UniCABA)
Todas las modificaciones notables a este proyecto serán documentadas en este archivo. El formato está basado en Keep a Changelog y este proyecto se adhiere a Semantic Versioning.
[Unreleased]
Planificado (Fase 6 del Roadmap)
- Despliegue e Infraestructura (Fase 6):
docker-compose.ymlproductivo 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.38] - 2026-10-27
Fixed & Improved (Resiliencia de Respuesta de UdeCi y Compatibilidad Dual DTO)
- Corrección de Mapeo de Respuestas en Frontend (
responsevsreply):- 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 (replyyoptionscomo alias directos enChatResponse).
- Se corrigió el desacople entre el esquema del backend (
- Integración Nativa de Spotlight / Walkthrough:
- Se conectó
data.guide_stepconWalkthroughEngine.startStep()para cerrar o minimizar el modal de UdeCi y resaltar interactivamente el botón o menú correspondiente.
- Se conectó
[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.
- Se suprimió el bloque intermedio desplegable de chips y botones de consultas rápidas (
[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.
- 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 (
- 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.
- Cápsula de entrada redondeada (
- 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
SpeechSynthesisUtterancey 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).
- Mensaje de usuario en píldora suave a la derecha con marca horaria (
[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.
- Se incorporó
- 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,#7E22CEen modo claro y sus contrapartes nítidas luminosas en modo oscuro). - Se reforzó la legibilidad de los textos en
.sidebar-submenu .nav-linkcon color Slate-900 (#0F172A) y peso seminegritafont-weight: 600. - Se incrementó el contraste de los encabezados de sección
.sidebar-section-headera Slate-700 (#334155) en modo claro y Slate-300 (#CBD5E1) en modo oscuro con pesofont-weight: 800. - Se eliminó duplicación de reglas CSS en submenús y se amplió el ancho del sidebar a
275pxpara evitar desbordes y cortes de palabras compuestas.
- Se corrigió el problema de bajo contraste provocado por clases utilitarias de Bootstrap (
[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 (#B43E8Ea#682CAD), indicador de acento lateral y rotación suave de 180° del chevron indicador.
- Contenedor de ícono estilizado (
- 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.
- 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:
- Nuevas Funcionalidades Operativas y de Asistencia para UdeCi:
- Clima en Vivo del Campus Universitario: Integración de
WeatherServicecon 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.jspara 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
RAGServicecubriendo 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.
- Clima en Vivo del Campus Universitario: Integración de
[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}/enrollmentsy/api/v1/commissions/{id}/gradebook/grades, bloqueando con403 Forbiddencualquier 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/gradebooko/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 rolalumno, garantizando total confidencialidad. Se incorporaron accesos rápidos a "Mis Calificaciones e Hitos", "Clases de Hoy" y "Cronograma Semanal".
- Endpoints Backend RBAC: Se incorporó
- 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 SISTEMAcontemperature: 0.0para 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) enbase.htmlymy_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.
- Normalización robusta insensible a mayúsculas/minúsculas de roles (
[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 (
Reservationcon 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.
- 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 (
- 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).
- Notas y Calificaciones de Alumnos: El docente puede consultar las notas de sus comisiones o de un alumno específico por nombre (
- 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.
- UdeCi ahora consulta dinámicamente la base de datos relacional y alimenta el prompt con información fidedigna de las carreras activas (
- 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_idyuser_emailjunto conuser_nameyuser_roleen la carga útil de/api/chat.
- Envío automático de
- Esquema Pydantic v2 Actualizado (
ChatRequest):- Inclusión de los campos opcionales
user_idyuser_emailvalidados fuertemente.
- Inclusión de los campos opcionales
- Corrección de Resiliencia en Modelos (
Commission.teacher_name):- Retorno seguro de
teacher.nameen caso de quefirst_nameolast_nameno estén desagregados, previniendo visualizaciones de cadenas nulas.
- Retorno seguro de
[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 presionarEscape. - Configurado
font-size: 16pxen 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.
- El panel conversacional se transforma en un modal/hoja de pantalla completa (
- Armonización y Corrección del Dashboard en Móviles:
- Eliminada la regla global perjudicial que forzaba a
.btn-groupa 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.
- Eliminada la regla global perjudicial que forzaba a
[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-nameen el widgetai_chat_widget.htmlobtenido de la sesión autenticada (current_user_name). - Envío de
user_nameen la petición/api/chaty adaptación engenerate_system_prompt_for_rolepara saludar y dirigirse siempre al usuario por su nombre real.
- Inyección de
- Diferenciación Estricta de Roles (
admin,bedelia,docente,alumno):- Separado el rol
admindel rolbedeliaen 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.
- Separado el rol
- 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) yGuideServiceactualizados con las rutas reales (/buildings/list_buildings,/classrooms/list_classrooms,/admin/academic_terms_list) y selectores precisos del DOM.
- Eliminados nombres genéricos ficticios; UdeCi ahora referencia las secciones y botones exactos de la interfaz (
- Motor de Spotlight & Walkthrough Interactivo con Auto-Despliegue:
walkthrough-engine.jsimplementarevealElementIfHidden(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
PromptSecurityServiceenbackend/app/services/prompt_security.pycon 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/chatsin invocar el LLM cuando la consulta viola directivas de seguridad.
- Implementado
- 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.
- Creado
- 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.pypara guiar al usuario mediante las opciones del menú (Menú lateral ➔ Sedes / Edificios,Menú lateral ➔ Integraciones ➔ Importar Google Sheets, etc.).
- Prohibido a nivel de System Prompt el uso de URLs técnicas crudas (
- Refinamiento de UX/UI y Contraste Sólido (Cero Transparencia en Dark Mode):
- Eliminado el elemento
#aiQuickBary sus chips fijos invasivos. - Eliminado el fallback forzado de las 4 opciones repetitivas en cada respuesta (
_extract_options_from_replyahora sólo expone opciones cuando son relevantes y contextuales). - Eliminadas transparencias en Modo Oscuro del chat widget: establecido fondo 100% sólido y opaco (
#0f172ay#1e293b) garantizando máxima legibilidad.
- Eliminado el elemento
- 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.pyytest_mcp_and_walkthrough.py). - Ejecutada exitosamente con resultado PASS (Bandit 0, pip-audit 0, njsscan 0, npm audit 0, Pytest 9/9 passed).
- Corregida la sintaxis del script batch y agregada la Fase 6 de QA de Seguridad (
[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
EduSpaceMCPServerenbackend/mcp_server.pycompatible 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.pymontado en/api/v1/mcpy/api/mcp.
- Implementado
- Filosofía Didáctica: "Enseñar a Pescar, No Dar el Pescado":
GuideService(backend/app/services/guide_service.py): Inyección estructurada deGuideStepDTO(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#B43E8Een Modo Claro ([data-bs-theme="light"]) y neón fucsia#d946efen 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).
- Halo luminoso animado (
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.
- Detección de página actual y banner de redirección con persistencia de paso pendiente en
- 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.
- Creada suite
[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-idydata-user-emailvinculados 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 (
aiChatClearBtnsolo borra el historial del usuario activo).
- Se eliminó la clave de almacenamiento global compartida (
- Backend Core & Inferencia Simultánea (
routers/ai_chat.py&schemas/ai_chat.py):- Se agregó el campo
conversation_idaChatRequestyChatResponse. - Se inyecta el identificador único
"user": user_identifieren 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.
- Se agregó el campo
- Calidad y Verificación:
- Nueva prueba unitaria y de concurrencia
test_individual_user_chat_conversations_isolationenbackend/tests/test_rag_udeci.py. - 95 pruebas automatizadas pasando al 100% (
95 passed).
- Nueva prueba unitaria y de concurrencia
- Frontend (
[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.1para forzar apego estricto al contexto recuperado y evitar alucinaciones. - Nuevo endpoint administrativo
POST /api/chat/rag/reindexpara recarga de la base de conocimiento oficial.
- Nuevo modelo relacional
- 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).
- Detección y renderizado automático de botones interactivos dentro de las burbujas de respuesta (
- Calidad y Verificación Automatizada:
- Creada suite
backend/tests/test_rag_udeci.pycon 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.
- Creada suite
- Especificación SDD-010: Formalizados artefactos en
[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,ChatResponseyAISettingsSchemacon validación de expresiones regulares, longitudes y rangos de temperatura/timeout.
- DTOs declarativos
- Router FastAPI Asíncrono (
backend/routers/ai_chat.py):- Implementados endpoints
/api/chat/,/api/v1/chat/,/test-connectiony/configmontados enmain.py. - Cliente HTTP no bloqueante con
httpx.AsyncClienty 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.
- Implementados endpoints
- Configuración Global Administrativa (
/admin/settings):- Agregada pestaña dedicada "Asistente IA & LLM Local" (
#tab-ai) englobal_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.
- Agregada pestaña dedicada "Asistente IA & LLM Local" (
- Widget de Chatbot Flotante Interactivo en Frontend:
- Componente parcial
frontend/views/partials/ai_chat_widget.htmlinyectado enbase.htmlpara todos los usuarios autenticados. - Lógica cliente
frontend/public/js/ai-chat-widget.jscon persistencia ensessionStorage, detección de rol, formateo de Markdown, indicador animado de escritura y scroll automático. - Proxy transparente
/api/chaten Node.js BFF (frontend/src/app.js).
- Componente parcial
- 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).
- Creada suite
- Especificación SDD-009: Formalizada la especificación completa en
[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 adaptativosbg-body).
- Pastillas y botones selectores de días (
- Resueltos problemas de bajo contraste en elementos clave de la vista en modo oscuro (
[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.
- Transformados los modales de alta (
[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 decareer_idsy preservandocareer_idprincipal por compatibilidad relacional. - Sincronización robusta en Backend FastAPI (
POST /subjectsyPUT /subjects/{id}), actualizando la relación Many-to-ManySubject.careers(tablasubject_careers). - Suite de pruebas ampliada con
test_subject_multiple_careers_create_and_update(80 tests 100% pasando).
- Reemplazado el selector simple de carrera por un componente de selección múltiple interactivo y responsivo tanto en la creación (
[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 (
modalAddCommissionymodalEditCommission) 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 consubject_nameysubject_codepara máxima interoperabilidad, y el endpointGET /commissionsahora devuelvesubjects,careersyacademic_terms.
- Corregida la visualización en
- 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.
- Docentes: Acceso exclusivo a sus materias y comisiones asignadas (
[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) concareer_name,career_namesycareer_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.
- Implementado selector interactivo de carrera (
- 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):
- Ocupación de Aulas Físicas (Hoy): Aulas Asignadas (Verde) vs Aulas Libres (Amarillo).
- 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.htmlpara neutralizar el contraste chocante de.table-lighten tema oscuro ([data-bs-theme="dark"]), reemplazando el fondo blanco/gris claro por tonalidades oscuras semánticas (#1e293b), texto claro#f1f5f9y 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.
- Implementada regla CSS global en
- 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).
- Traducida al español al 100% la plantilla
- 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.
- En
[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 Hoyen verde vsCon Cursada Activaen magenta#B43E8E). - Incorporada mini-matriz interactiva de Aulas Presenciales en vivo con badges de estatus (
Librecon botón de asignación directa oOcupadacon detalle de comisión y horario).
- 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 (
- 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).
- 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 (
- Enriquecimiento Visual y Detalle en Últimos Eventos de Auditoría:
- Enriquecido el serializador del backend (
dashboard_service.py) mapeandoaction_labelymodule_labelen 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.
- Enriquecido el serializador del backend (
- 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_classroomsustituyé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.
- Traducidos al español y modernizados los formularios de alta de aulas (
[3.8.16] - 2026-10-26
Fixed
- Restauración y UX Nativa del Menú en Dispositivos Celulares / Móviles:
- Corregida la visibilidad de
.mobile-headeren pantallas menores a 992px resolviendo el conflicto de especificidad entre@mediay 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: -290pxconwidth: 280pxyoverflow-x: hidden !important).
- Corregida la visibilidad de
- Visibilidad Completa de Opciones de Sesión en Modo Colapsado:
- Reemplazada la clase
.sidebar-submenupor.user-menu-listen 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.
- Reemplazada la clase
- 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-truncateen el sidebar (v3.8.16en 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.
- Reestructurado el indicador de versión en un badge vertical compacto con
- 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.
- Creado endpoint dedicado
[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) ymax-height: calc(100vh - 24px); overflow-y: auto;para garantizar cero recortes de elementos en pantallas reducidas (1366x768 / 1280x720).
- Reubicado el botón de cambio de tema (
Fixed
- Ocultación Total de Cabecera Móvil en Escritorio (
.mobile-header):- Restringida la barra
.mobile-headerexclusivamente a pantallas< 992pxmedianted-lg-noneydisplay: none !important;en CSS, eliminando la interferencia visual y de espacio que afectaba la UI y UX en vista desktop.
- Restringida la barra
- Cero Diagnósticos en Pyright / SQLAlchemy (
reservation_repository.py):- Corregida la condición
only_virtualreemplazando 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].
- Corregida la condición
- Auditoría de Seguridad y SAST / SCA / DAST (
security_audit.bat):- Actualizado
security_audit.batpara escanearbackend\routersjunto conbackend\appen Bandit y consultar la ruta OpenAPI/openapi.jsonde FastAPI. - Resueltas vulnerabilidades transitivas de npm mediante
npm audit fix(0 vulnerabilidades). - Suite de seguridad 100% aprobada (
SECURITY AUDIT SUITE COMPLETED SUCCESSFULLY [PASS]).
- Actualizado
- Balance de Etiquetas HTML en Vistas:
- Reparado el cierre de contenedor en
classrooms/view.htmly de tarjeta/cabecera enschedule/today.html, logrando un balance perfecto de 52/52 plantillas sin discrepancias (diff=0).
- Reparado el cierre de contenedor en
[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) yonly_virtualen 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.
- Incorporado soporte de parámetros
- 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.
- En el Dashboard (
- 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).
- Removido el colapso forzado (
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.
- Implementadas clases de estilo dedicadas en modo oscuro y claro (
- 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.htmlyadmin_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).
- Retirado el botón de cambio de tema de las pantallas de autenticación (
- Internacionalización y Textos en Español:
- Mapeo de roles en backend y frontend para mostrar consistentemente
Administradoren lugar deAdminoSystem Administrator. - Traducido "Classroom Management System" por "Sistema de Gestión de Espacios Áulicos" y textos residuales en inglés.
- Mapeo de roles en backend y frontend para mostrar consistentemente
- Balance de Estructura HTML:
- Sincronizados y verificados al 100% los tags
<div>en todas las plantillas del frontend, garantizando cero desbordes de contenedor.
- Sincronizados y verificados al 100% los tags
[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_usersen/api/v1/admin/usersahora aceptaroletanto numérico (ID de rol) como textual (ej.Docente,Alumno,Admin), insensible a mayúsculas, y retornarole_countsestructurado 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 enacademic.py,classrooms.pyyreservations.py, asegurando 0 errores y 0 advertencias en el Language Server.
- Removidas llamadas redundantes a
[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.
- Removidos 3 tags
- Resiliencia en Filtrado y Paginación de Asignaturas y Comisiones (
/admin/subjects_listy/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/subjectsy/api/v1/commissionsaceptanOptional[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 objetoparamspara no enviar claves vacías a la API.
- Solucionado el error HTTP 422 Unprocessable Entity en FastAPI provocado cuando el frontend o los formularios enviaban parámetros vacíos (
- 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/subjectsy/api/v1/commissions. - Añadido endpoint
/api/v1/users/teacherspara selectores de docentes sin transferir la lista de miles de usuarios. - Corregida la consulta SQL relacional en
ReservationRepositoryutilizandonot_(Classroom.code.ilike('%VIRTUAL%'))yClassroom.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).
- Implementada paginación server-side con metadatos estructurados en
[3.8.11] - 2026-10-26
Fixed
- Exclusión de Reservas Pasadas en Fichas y Tarjetas de Aulas (
view_classroomylist_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 lasassigned_commissionsytotal_classesexclusivamente 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.
- En la ficha del aula (
[3.8.10] - 2026-10-26
Fixed
- Sincronización y Consistencia de Salas Virtuales y Aulas (
/classroomsvs/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-roomsen 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()conreservationsserializadas 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 enlist.html. - Reemplazadas fechas estáticas congeladas de septiembre de 2026 en
frontend/src/routes/classrooms.jspor 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.
- Resuelta la discrepancia visual donde el Dashboard reportaba 19 salas virtuales mientras que la vista de Aulas (
[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) enbackend/app/schemas/optimizer_dto.py.
- Implementado
Fixed
- Enrutamiento y Proxy Inverso en Frontend BFF (
frontend/src/app.js):- Configurado middleware proxy transparente para
/api/genetichacia 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_timeyend_timea formato naive UTC para evitar discrepancias de comparación en SQLite/PostgreSQL.
- Configurado middleware proxy transparente para
[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 defrontend/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.htmladaptándola a métodos válidos en Nunjucks (.slice(0, 16)). - Verificado el escaneo y compilación de la totalidad de las plantillas
.htmlsin fallos de renderizado.
- Eliminada la definición redundante de
[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ónico34247025y 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.jsleyendoerror.response?.data?.detailpara 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.pycubriendo autenticación exitosa, deshabilitada, credenciales inválidas y fallback multi-credencial.
- Corregido el nombre de usuario de Carlos Tello en Moodle (
[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.jsyflatpickr/dist/l10n/es.js) con formato regionald/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) medianteparse_flexible_date(val)con tolerancia aDD/MM/AAAA,DD-MM-AAAAe ISOAAAA-MM-DD. - Inyección de
inferred_date_displaycon formatoDD/MM/AAAAen 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_datesytest_sync_with_row_date_ddmmaaaa).
- Integración de Flatpickr (
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-inputy.date-input-pickercon máscara y placeholderDD/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.
- Reemplazados todos los inputs
[3.8.5] - 2026-10-21
Added
- Aislamiento de Login de Emergencia ADMIN en
/adm/login(Spec 006):- Enrutador dedicado
/admy vista/adm/loginen Frontend BFF con rate limiting (authLimiter). - Endpoint REST
POST /api/v1/auth/adm-loginen 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
/admhacia/adm/login. - Nueva plantilla Nunjucks sobria y segura
frontend/views/auth/admin_login.html.
- Enrutador dedicado
- 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.
- Detección reactiva de proveedores activos en
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 ensubjectsy securizado el conteo ento_dict()con verificaciónisinstance(subs, (list, set, tuple))satisfaciendo el protocoloSized.backend/app/models/subject.py: Removidas anotaciones de lista en relacionescommissionsycareers, permitiendo a SQLAlchemy 2.0 y Pyright inferir descriptoresInstrumentedAttributecon métodos nativos (.any()).backend/routers/academic.py: Resueltos los accesos aSubject.careers.any(...)en filtros de asignaturas y comisiones.backend/app/services/sheets_importer.py: Corregidas las normalizaciones demanual_dt,date_from_dt,date_to_dtyrow_specific_dateevaluandoisinstance(d, datetime)previo aisinstance(d, date)para eliminar incompatibilidad de comparación entredateydatetime.- Verificados Pyright con
0 errors, 0 warnings, 0 informationsy 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 Requesten backend y alerta en UI sidate_from > date_to.
Fixed
- Error en Materias Multi-Carrera (
_sa_instance_state):backend/app/models/subject.pyybackend/app/models/career.py: Tipado explícitoList['Career']yList['Subject']conuselist=Trueen la relación Many-to-Manysubject_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 destr()redundante en sincronización de permisos de roles.backend/app/services/dashboard_service.py: Asegurado casteo aintpara claves de diccionariossetdefaultresolviendo 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 areconfigureensys.stdout/sys.stderry acceso seguro a identificadores de modelos.backend/app/models/setting.py: Decorados métodos auxiliares con@classmethode 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) ybackend/app/forms/(5 archivos de Flask-WTF). - Eliminados módulos obsoletos
backend/app/security/y decoradores legacy enbackend/app/utils/. - Retiradas todas las dependencias residuales de Flask en
backend/requirements.txtybackend/setup.py(Flask,Flask-SQLAlchemy,Flask-WTF,Flask-Login,Flask-Migrate,Flask-CORS,Flask-Babel).
- Eliminados por completo los directorios
Added
- Capa de Persistencia Nativa SQLAlchemy 2.0 Desacoplada:
backend/database.py: ImplementadoSQLAlchemyWrappernativo conSessionLocal,scoped_session, compatibilidad con queries ORM, inyección de metadata endb.Tabley auto-registro encreate_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 proveeAppCompatWrapperyTestClientWrappersobreFastAPI TestClient.backend/routers/admin.py: Soporte nativo para extracción de JWT en endpoints de impersonación (stop-impersonating) y respuesta enriquecida conmodulesyactionsen 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,/healthy bajo/api/v1/versionenbackend/routers/version.py. - Agregado endpoint
/api/v1/reservations/drag-updateenbackend/routers/reservations.pypara reprogramación visual interactiva en la grilla horaria.
- Creados routers modulares en
Removed
- Retiro Completo del Puente WSGIMiddleware:
- Eliminado el montaje residual
app.mount("/", WSGIMiddleware(...))debackend/main.py. - El servidor ASGI Uvicorn ejecuta ahora 100% FastAPI nativo con 118 rutas expuestas directamente en OpenAPI Swagger UI (
/docs).
- Eliminado el montaje residual
Changed
- Relaciones Relacionales y Tipado Defensivo:
backend/app/models/subject.py: Forzado explícitouselist=TrueenSubject.commissionsgarantizando que siempre se evalúe como colección de comisiones.backend/routers/academic.py: Cómputo robusto decommissions_countprotegiendo 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 exportarCommissionTeacherresolviendo error de importación enadmin.py.backend/app/models/subject.py: Añadido__init__explícito aCommissionTeachery declaradas relaciones relacionales bajoTYPE_CHECKING(career_obj,careers,commissionsenSubject, ysubjectenCommission) con__allow_unmapped__ = True.backend/app/models/audit_log.py: Desacoplado__init__desuper().__init__()sin kwargs satisfaciendoobject.__init__.backend/app/models/career.py: Tipado desubjects: List['Subject']bajoTYPE_CHECKINGpara permitir cómputos de longitud seguros.backend/app/models/classroom.py: Tipadasbuilding_entityyreservationsbajoTYPE_CHECKING.backend/app/models/genetic_algorithm.py: Tipados seguros parasubject_requirements,start_date/end_dateopcionales y reemplazo decurrent_app.loggerpor logger desacoplado del módulo.backend/app/models/milestone.py: Declaradotype_obj: Optional['MilestoneType']bajoTYPE_CHECKING.backend/app/models/role.py:users: List['User']tipado y__init__explícito enPermission.backend/app/repositories/base_repository.py: Consulta estándardb.session.query(self.model_class)enget_all().backend/app/services/user_service.py: Instanciado singletonuser_service = UserService()a nivel de módulo.backend/app/services/cache_service.py: Silenciado de advertencia de módulo condicionalredis.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 enQuery.filter().backend/app/services/optimizer_service.py: Acceso seguro a_get_current_objecty verificación de existencia de job en callbacks.backend/app/services/sheets_importer.py: Diccionario de estadísticas fuertemente tipadostats: 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 loadingjoinedload("commission.subject").backend/app/utils/jwt_decorators.py: Validadosubde usuario antes del casting entero y asegurada la llamadaJWTService.decode_token().- Reemplazo exhaustivo de
datetime.utcnow()deprecado pordatetime.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()eint()en repositorios, esquemas DTO y rutas.
- Sincronización Resiliente con Moodle 4.1 (
core_user_update_users):backend/app/services/moodle_client.py:update_usersdetecta automáticamente usuarios sin ID interno de Moodle en payload, consulta la API de Moodle poremail/usernamepara obtener su ID numérico o redirige con fallback transparente a creación (create_users), eliminando la excepciónMoodle 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.
- 57 pruebas automatizadas (
[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) enbackend/app/routes/api/dashboard.pyantes de los bloques de ejecución y captura. - Eliminación de advertencias de variables posiblemente no inicializadas (
uninitialized) ensync_google_sheets(filter_career,filter_subject,filter_day). - Reemplazo de llamadas deprecadas
datetime.utcnow()pordatetime.now(timezone.utc)conforme a los estándares de Python 3.12/3.14.
- Inicialización unificada de variables de estadísticas (
[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: SolucionadoTypeError: 'classmethod' object is not callableal invocarSystemSetting.get_decrypted_value()yget_masked_value(), extrayendo la función subyacente congetattr(cls_func, '__func__', cls_func)y removiendo el decorador@classmethodredundante en los helpers privados.
- Rutas de Perfil y Preferencias de Tema Visual:
backend/schemas/auth.py&backend/routers/auth.py: Agregados esquemas PydanticProfileUpdateRequest,ThemeUpdateRequesty endpointsGET /api/v1/auth/profile,POST /api/v1/auth/profile,POST /api/v1/auth/theme.backend/app/services/user_service.py: Enriquecidoget_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 paraGET /profile,POST /profileyPOST /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 relacionalesrole_objyreservationsbajoTYPE_CHECKINGy__allow_unmapped__ = Truepara total compatibilidad con SQLAlchemy 2.0 y el Language Server.backend/app/models/reservation.py: Declaradosuser,classroom,commissionbajoTYPE_CHECKINGy__allow_unmapped__ = True. Migración completa dedatetime.utcnow()deprecado adatetime.now(timezone.utc)sin tzinfo local.backend/app/services/jwt_service.py: Acceso tipado seguro auser.role_objcon fallback agetattryuser.role.backend/database.py: Tipado explícito deget_db()retornandoGenerator[Any, None, None].backend/dependencies.py: Eliminado uso erróneo dejoinedload("role_obj")con string literal que disparaba error estático y runtime; carga segura anticipada para prevenirDetachedInstanceError.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 redundantesstr(), saneado acceso ar.usercon validación nula y tipado dinámico.backend/main.pyybackend/wsgi.py: Casts explícitos en adaptadoresWSGIMiddlewareyASGIMiddlewaredea2wsgisatisfaciendo firmas estrictas de Starlette.backend/app/__init__.py: Silenciado warning de stubs faltantes enflask_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) ybackend/database.py(persistencia relacional). - Routers FastAPI de Alto Rendimiento:
routers/version.py: Endpoint/api/v1/versionidentificando el motor FastAPI ASGI.routers/auth.py: Autenticación híbrida (Local con fallback admin, Google OAuth 2.0 institucional, Moodle delegado, cookies JWTHttpOnly, 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.pyy/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/redocy OpenAPI v3 en/openapi.json. - Puente ASGI/WSGI de Cero Regresión: Integración con
a2wsgipara 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).
- Arquitectura en 4 Capas Desacoplada: Implementados
[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/(PydanticBaseModel) ystorage.py(acceso a DB). Prohibición de lógica de negocio en el frontend o archivos únicos. - Contratos Fuertes y Pydantic: Uso mandatorio de
Fieldpara 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 error422 Unprocessable Entitydetalladas. - Semántica HTTP y Excepciones: Uso estricto de códigos
201 Createden POST,200 OK,204 No Contenten DELETE y excepciones controladasHTTPException(404 con mensaje explícito, 400, 409) prohibiendo el retorno denullo 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).
- Arquitectura Modular en 4 Capas: Desacople estricto en
- 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.mdyMEMORY.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.mdy 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.
- Incorporada directiva mandatoria en
- 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_methodparaget_decrypted_valueyget_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.
- Implementado descriptor híbrido
- Tipado estricto en
scripts/moodle_replicator.py:- Corregido casteo a
intenlocal_course_idyrole_iden las líneas 586 y 607, satisfaciendo la firma deenrol_user(local_uid: int, local_course_id: int, role_id: int).
- Corregido casteo a
- 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 durantetearDown.
- Añadida espera explícita del worker asíncrono en
- 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-keyyPOST /api/v1/admin/settings/moodle/api-key/regenerate. - Alias de sincronización
POST /api/v1/admin/settings/moodle/syncconsumible 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 serviciomoodle_api: añadidas funcionesenrol_manual_unenrol_users,core_enrol_unenrol_user_enrolment,core_role_assign_rolesycore_role_unassign_roles. - Blindaje de seguridad en Moodle mediante restricción de IP (
iprestriction = 10.0.0.0/24) en los tokens del serviciomoodle_api.
Changed & Fixed
- Eliminadas las 6 tareas residuales pendientes de prueba en la tabla
moodle_sync_tasksdeclassrooms_db. - Resolución de type narrowings (
loaderenmoodle_replicator.pyyrole_objenadmin.py) y configuración integral de paths de scripts y venv enpyrightconfig.json.
[3.5.4] - 2026-10-16
Added
- Integración completa bidireccional con el Web Service
moodle_apide Moodle Local (10.0.0.207) usando token dedicado810428346d3601c68a37a315fcba8d4391629f46. - Soporte para autenticación delegada Moodle (
/api/v1/auth/moodle) con fallback dinámico entremoodle_apiymoodle_mobile_app, y matching por número de documento (DNI) y prefijo de usuario. - Endpoint administrativo
POST /api/v1/admin/moodle/sync-from-moodlepara sincronización directa de usuarios, roles y catálogo de cursos desde Moodle hacia la base de datosclassrooms_db. - Métodos
get_courses(),get_categories()ysync_from_moodle_to_app()enMoodleClient. - Otorgamiento de capability
moodle/webservice:createtokenal rol autenticado de Moodle en10.0.0.207y 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.pymediante configuración de.vscode/settings.jsony 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 aDocente(role_id=2) y estudiantes (student) asignados aAlumno(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).
- Mapeo directo y coherente de roles académicos: docentes de Moodle (
- Desmatriculación Total de la Cuenta Admin en Moodle Local (
10.0.0.207):- Removidas todas las asociaciones y enrolamientos espurios de la cuenta
adminen 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).
- Removidas todas las asociaciones y enrolamientos espurios de la cuenta
[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 comousernameypassword. - Mecanismo en
get_or_create_userpara forzar la actualización de contraseña y correo de cuentas existentes evitando bloqueos por credenciales obsoletas.
- Solucionada la desincronización de contraseña del usuario
- 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 depython-requests.
- Configurado estrictamente el encabezado
- Pre-caché y Optimización de Extracción:
- Carga automática de correos previamente cacheados desde
participantes_export.jsonpara reducir en un 80% las consultas HTTP a producción y evitar timeouts.
- Carga automática de correos previamente cacheados desde
[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 delogintokenpre-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}) comousernameypasswordpara 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 mediantecore_user_create_usersycore_user_update_userscon 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).
- Autenticación automatizada en Moodle Producción (
- Especificación SDD (
specs/002-moodle-export-sync/):spec.mdcon 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.mdcon las reglas mandatorias del flujo SDD y sintaxis EARS.
- Incorporación de la skill formal de SDD (
- 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\uFEFFy 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 printpara 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).
- Nuevo endpoint en Frontend BFF (
- Verificación de Calidad:
- 52 pruebas automatizadas en verde (
52 passed) en pytest.
- 52 pruebas automatizadas en verde (
[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' })yexpress.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).
- Ajuste de los analizadores de cuerpo en el Frontend BFF Express (
- 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.
- Reemplazo de la pantalla genérica de error por una interfaz estructurada con código de ticket único (
- 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.
- Registro de eventos exitosos (
[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).
- Registro sistemático de eventos de inicio de sesión exitosos (
- 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.
- Auditoría de altas, modificaciones, bajas y alternancia de estado en edificios (
- 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 modeloAuditLogpara 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/:idy/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_idyfloor) para agilizar la creación de espacios desde la vista de edificios.
- Soporte de preselección automática por URL (
[3.4.6] - 2026-10-08
Corregido & Mejorado (Reservas, Relaciones Edificios/Aulas, Fechas y Filtros)
- Módulo de Reservas (
/schedule/add_reservationy/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_jsonycommission_data_jsonsin escape de entidades HTML ("), y matching ultra tolerante de pisos físicos y virtuales.
- 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
- Calendario Académico (
/schedule/calendar_viewy/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.
- Limpieza exhaustiva de datos mockeados y hardcodeados (
- 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.
- Eliminación de la autogeneración no deseada de enlaces de Google Meet / Zoom (
- 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.
- Formateo amigable en español institucional para las reservas y clases programadas (ej.
- Gestión de Edificios, Aulas y Pisos Dinámicos (
/buildings/list_buildingsy/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_listyclassrooms_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.
- 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
- Filtros en Gestión de Comisiones (
/admin/commissions_list):- Corrección de
UnboundLocalErrorenbackend/app/routes/api/admin.pydentro deget_commissionscausado por importación interna tardía deCareer, que provocaba error 500 al filtrar por carrera (career_id=180, 181, 182). Grilla ahora filtra correctamente sobre materias compartidas (subject_careers).
- Corrección de
[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 Forbiddena usuarios con rolBedelia,Docenteo Administradores con roles formateados en minúsculas en los endpoints/api/genetic/commissions,/api/genetic/algorithm-status,/api/genetic/preview-optimization,/api/genetic/optimizey/api/genetic/apply-optimization. - Creación del helper de verificación de permisos
check_optimizer_permission(user, requires_write)enbackend/app/routes/genetic_algorithm.pyadmitiendo a Administradores, Bedelía, Docentes y permisos RBAC personalizados.
- Resolución del bloqueo que devolvía
- Enriquecimiento del Listado de Comisiones para Asignación Áulica:
GET /api/genetic/commissionsahora exponesubject_name,subject_code,career_name,scheduleyshiftpara 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_optimizerconrequireAuthe inyección de datos de sesión enfrontend/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,SemanayMes, 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.
- Panel de Percentiles de Ocupación de Aulas Físicas: switcher con
- Soporte completo en backend (
backend/app/routes/api/dashboard.py): cálculo detomorrow_dt, estadísticas enfilter_stats['tomorrow'],tomorrow_schedule_listy soporte de sincronización de datos con frontend BFF.
- Incorporación del botón de filtro temporal "Mañana" (
[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.
- El botón "Inspeccionar Sheet Online" no importa directamente; extrae y presenta una grilla interactiva completa (
- Backend & BFF Endpoints:
POST /api/v1/dashboard/sheets-inspectretorna metadatos ypreview_rowscon inferencia de fechas, estados de validación y carreras compartidas.POST /api/v1/dashboard/sync-sheetsprocesa opcionalmenteselected_rowscon 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
forde 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.
- Corrección del bug que duplicaba visualmente una misma reserva por cada hora que abarcaba la cursada (eliminación del bucle
- 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.
- Fecha:
- Creación de la función utilitaria
formatReservationDatesen 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.htmlyview.html.
- Reemplazo del formato ISO crudo con 'T' y segundos (
[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
availableCareersyavailableSubjectsenhandleGoogleSheetsImport(frontend/src/routes/admin.js). - Eliminación del error 500 al acceder por GET a
/admin/google_sheets_importo/admin/import.
- Declaración e inicialización con ámbito de función de
- 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.pypara 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 enclassrooms. - Agregado del arreglo
virtual_roomscon 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.
- Corrección de la lógica de obtención de datos en
Refactorizado
- Modularización de Vistas por Roles (
dashboard.htmlcomo Layout Padre):- División de la plantilla monolítica
dashboard.htmlen 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.htmlmediante directivas{% include %}de Nunjucks.
- División de la plantilla monolítica
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_careersen 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_idprincipal y exponiendo coleccionescareersenSubjectyCommission. - Desglose de badges en UI para cada carrera vinculada tanto en
/admin/subjects_listcomo 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).
- Implementación de la tabla asociativa relacional
- 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
/pubhtmlcon 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.
- Extracción y normalización automática de carreras múltiples separadas por guion en la planilla (ej.
- Habilitación y Reactivación de Operador Institucional de Bedelía:
- Desbloqueo y activación de la cuenta
bedelia@edu-space.compara gestión operativa continua con credenciales institucionales.
- Desbloqueo y activación de la cuenta
[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:
- Sede / Edificio (
/buildings/list_buildings): Creación y administración del inmueble universitario. - Aula (
/classrooms/list_classrooms): Alta de espacios físicos y aulas virtuales con control de aforo y recursos. - Ciclo Lectivo (
/admin/academic_terms_list): Creación del período lectivo y activación del cuatrimestre corriente. - Carrera / Titulación (
/admin/careers_list): Creación y administración del programa académico institucional. - Asignatura / Materia (
/admin/subjects_list): Alta en plan de estudios asociada obligatoriamente a la Carrera. - 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. - Asociar Profesores (
/admin/commission_detail): Asignación del cuerpo docente y co-docentes con roles de cátedra. - Asociar Alumnos (
/admin/commission_detail): Matriculación con validación de restricciones horarias y excepciones de Bedelía. - Reserva de Espacios (
/schedule/add_reservationo Drag & Drop en/schedule/calendar_view): Asignación de aula y franja horaria en 1 clic con chequeo de conflictos.
- Sede / Edificio (
- Formalización del circuito paso a paso para reemplazar el archivo Excel manual de uso diario:
- 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).
- Estandarización de número de versión en Backend (
- 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.
- Resolución del error 500 (
- 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.
- Constitución del Sistema (
- Mantenimiento del Importador de Google Sheets:
- Preservación del servicio
sheets_importer.pypara ingesta masiva inicial sin fricción para el personal.
- Preservación del servicio
[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 (
Usercon 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
AuditLogcon la acciónSYSTEM_RESET, asociando el correo del administrador ejecutor, su IP y el recuento de entidades purgadas. - Interfaz de Usuario y Modal Interactivo: Diálogo modal
#modalResetSystemcon 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).
- Módulo de Mantenimiento en Configuración Global (
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) enfrontend/src/routes/classrooms.js, permitiendo navegar a/classrooms/list_classrooms?view_mode=physicaly/classrooms/list_classrooms?view_mode=virtualsin caídas ante bases vacías. - Corrección de Evaluación de Longitud en Nunjucks: Actualizadas las directivas condicionales en
frontend/views/classrooms/list.htmlaclassrooms.items|length > 0yvirtual_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:
handleAddClassroomyhandleClassroomsListahora 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_metricsyvirtual_rooms, impidiendo errores 500 no controlados.
- Prevención de Excepciones TypeError: Se corrigieron accesos inseguros a propiedades nulas o no definidas (
[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>yPOST /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) enfrontend/views/admin/academic_terms/list.html.
- 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 (
- 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_classroomy/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).
- Control de Estado y Borrado Seguro: Incorporación de toggle activo/inactivo (
- 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=trueyPOST /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.
- Eliminación Definitiva (Hard Delete): Soporte en backend para purga física de reservas (
- 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).
- Verificación y garantía de operaciones ABM completas en todos los componentes centrales: Sedes/Edificios (
- 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.htmlcon autoselección de Edificio, Piso y Aula al navegar desde el catálogo de espacios.
- Circuito intuitivo de 3 pasos: Catálogo de Aulas (
- Conexión REST en Vivo para Reservas:
- Sustitución de listas fijas/mockeadas en
frontend/src/routes/schedule.jspor consulta dinámica a/commissionsen vivo, permitiendo reservar aulas para cualquiera de las comisiones reales de la plataforma.
- Sustitución de listas fijas/mockeadas en
- Soporte Multisede Consistente en Aulas:
- Resolución robusta de
building_idy flagis_virtualenfrontend/src/routes/classrooms.js, eliminando hardcodes y asegurando que las aulas físicas pertenezcan a la sede seleccionada.
- Resolución robusta de
- Flujo Operativo Ágil para Bedelía:
- Inicialización de Base de Datos Limpia sin Datos Demo (
--empty-academic/--no-demo):- Soporte en
install.shy Menú Interactivo: Incorporación de la opciónsudo 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-academicque 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.
- Soporte en
- 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 endashboard.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_enabledadministrado víaPOST /api/v1/admin/settings/ui, respaldado porSystemSettingy registrado enAuditLog.
- Nueva Pestaña de Interfaz & Dashboard (
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 aopenPurgeModal(), el cual no ejecutaba ninguna acción por ausencia del modal#purgeConfirmModalen 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.
- Solución al botón inerte de Purga: En
- 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.
- Corrección de métricas de edificios en
- Instalador
install.sh:- Inclusión de banderas
--keep-dby--keep-userspara evitar sobreescritura de contraseñas y usuarios en reinstalaciones o actualizaciones.
- Inclusión de banderas
[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 (
CryptoServiceenbackend/app/services/crypto_service.py). - Migración y extensión de
SystemSettingcon columnascategoryeis_encrypted, junto con métodos polimórficosget_decrypted_value()yget_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.htmlcon soporte optimizado para pantallas 720p, 1360x768 y 1080p, y enlace integrado en el menú de navegación lateral.
- Cifrado simétrico de credenciales y secretos con Fernet (
- Épica 2: Infraestructura Asíncrona y Caché:
- Servicio híbrido de caché
CacheServicecon integración Redis y fallback en memoria/TTL. - Modelo
MoodleSyncTasky procesador asíncronoMoodleQueueServicecon Exponential Backoff y Dead Letter Queue (DLQ). - Métricas en vivo y reintentos manuales individuales y masivos para tareas en DLQ.
- Servicio híbrido de caché
- É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
MoodleClientcon 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.
- Adaptador
- Épica 5: Motor de Notificaciones (Email Server):
- Cliente SMTP dinámico en
EmailServicecon 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.
- Cliente SMTP dinámico en
- Pruebas y Verificación:
- Suite de integración automatizada
backend/tests/test_phase6_integration.pycon 7 pruebas aprobadas al 100%. Regresión completa de 30 pruebas en verde en los módulos core.
- Suite de integración automatizada
- Épica 1: Panel de Configuración Global (Perfil ADMIN):
[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-updatecon 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
AuditLogy muestra confirmación visual de éxito.
- Activación de arrastre y edición interactiva en FullCalendar (
- Estadio 4.2 — Modo Impersonación del Superadmin:
- Soporte completo de cabecera
X-Impersonate-Useren el decorador JWT del Backend Flask (jwt_required) para administradores. - Endpoints administrativos
POST /api/v1/admin/impersonateyPOST /api/v1/admin/stop-impersonatingcon registro estricto enAuditLogbajo las accionesIMPERSONATE_STARTeIMPERSONATE_END. - Inyección contextual de impersonación en el Frontend BFF (
authMiddlewarey proxy transparente/api) mediante cookies segurasimpersonate_user_ideimpersonate_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.
- Soporte completo de cabecera
- 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ñana08:00-12:00,Tarde14:00-18:00,Vespertino/Noche18:30-22:30). - Soporte de guardado masivo en base de datos (
POST /api/genetic/apply-optimizationyapply_optimized_reservations) con prevención de solapamientos físicos y conversión estricta de fechas ISO.
- Algoritmo genético (
- Suite de Pruebas Unitarias de Fase 4:
- Archivo
backend/tests/test_phase4_interactive_impersonation.pycon 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).
- Archivo
- Estadio 4.1 — Grilla Semanal Interactiva (Drag-and-Drop) con Detección de Colisiones:
[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-milestonescon 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).
- Modelo relacional
- Estadio 3.2 — Libro de Calificaciones (Gradebook) y Cierre de Actas:
- Extensiones al modelo
Commission: camposgrades_closed(booleano),grades_closed_at(timestamp),grades_closed_by(ID usuario) yacta_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_gradeybulk_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 enAuditLogy 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.
- Vista
- Script de migración de base de datos SQLite
backend/migrate_phase3_fields.py.
- Extensiones al modelo
- Suite de Pruebas Unitarias de Fase 3:
- Archivo
backend/tests/test_phase3_gradebook.pycon 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).
- Archivo
- Estadio 3.1 — Calendario de Evaluación y Notificaciones Preventivas:
[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>/teachersyDELETE /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).
- Modelo relacional
- 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-conflictspara pre-validación asíncrona de conflictos físicos, docentes y de capacidad antes del guardado.
- Conflicto Físico Estricto: Bloqueo estricto de superposición horaria en la misma aula física (
- 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_courseen modeloSubject; 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_exceptionyexception_reasonen el modeloStudentEnrollment, 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>yPUT /api/v1/commissions/<id>/enrollments/<student_id>. - Adaptación completa de UI en
/admin/commission_detailcon 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.
- Servicio académico
- Suite de Pruebas Unitarias e Integrales de Reglas de Negocio:
- Archivo
backend/tests/test_phase2_rules.pycon 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.
- Archivo
- 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.batpara Windows y actualización de.gitea/workflows/security-audit.yamlpara asegurar la correcta ejecución del stack de auditoría (Bandit, pip-audit, njsscan y Schemathesis).
- Control de Entorno Dev: Aislamiento de herramientas de seguridad en
- Estadio 2.1 — Modelo y Gestión Integral de Co-docencia:
[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 ensheets_importer.pymediante 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 enbackend/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.
- Python SAST (
[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
Userde 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) ydocument_number(Número de documento validado). - Catálogo formal de reglas de negocio en
backend/app/constants/document_types.pycon 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/usersyPUT /api/v1/users/<id>. - Búsqueda dinámica en
/admin/users_listhabilitada para filtrar por número de documento o email personal/institucional además de nombre. - Rediseño del formulario
/admin/users/formestructurado 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.pypara agregar las columnas e inicializar nombres desglosados de los usuarios existentes.
- Incorporación en el modelo
- 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>/teachersyDELETE /api/v1/commissions/<id>/teachers/<user_id>, junto con la serialización completa de cátedras enGET /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.
- Creación del modelo relacional
- 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.
- Incorporación de botón y modal interactivo de confirmación de eliminación de asignaturas en
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 conoverflow(.table-responsive). Se refactorizó hacia un único modal global#modalEditSubjectinstanciado fuera de la tabla e inicializado dinámicamente con JavaScript.
- Solucionado el problema de modales recortados o cubiertos por el fondo oscuro (
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.
- Panel analítico "Estado y Percentiles de Asignación de Aulas Físicas" incorporado en los dashboards de Administrador (
- 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.
- Eliminado el botón flotante "Reservar Aula / Solicitar espacio para clase" (
Corregido
- Fallo Crítico de Renderizado en Nunjucks (
memberLookupcon.items):- Solucionada la incompatibilidad de
nunjucks/src/jinja-compatque interceptaba la propiedad.itemsconvirtiendoclassrooms.itemsen una función interna en lugar de un array, lo que impedía dibujar las tarjetas de aulas presenciales enfrontend/views/classrooms/list.html. - Implementado interceptor en
memberLookupenfrontend/src/app.jspara preservar arrays intactos.
- Solucionada la incompatibilidad de
- Clasificación Errónea de Reservas Físicas como Virtuales (
is_virtual):- Corregida la propiedad
@property is_virtualenReservation(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.
- Corregida la propiedad
- 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_numberenbackend/app/routes/api/dashboard.py, migrando la clasificación de aulas presenciales y virtuales a una evaluación robusta en memoria Python (Classroom.codeyClassroom.building).
- Corregido el error de ejecución generado al invocar
[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.pycon argumentos de limpieza granular (--all,--reservations,--classrooms,--careers,--yes). - Endpoint de API
POST /api/v1/admin/reset-academic-dataprotegido por JWT (roladmin) con registro enAuditLog. - Panel interactivo "Zona de Reinicio y Purga Académica" en
/admin/google_sheets_importcon 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.
- Script CLI
- 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-configyPOST /api/v1/admin/sheets-config. - Normalizador de enlaces en
GoogleSheetsImportercompatible 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.
- Nuevo modelo
- 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).
- Solucionado el corte prematuro de conexión en el BFF (
[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_reservationyPOST /schedule/cancel_reservation. - Actualización de enlaces en
today.html,list.html,dashboard.htmlyview.htmlpara navegar directamente con el identificador de la reserva (?id=...).
- Implementación en BFF Node.js de la ruta
- Creación y Asociación de Comisiones a Asignaturas (
admin/commissions_list):- Botón destacado
+ Nueva Comisiónen el encabezado y en el estado vacío de la tabla. - Modal interactivo
#modalAddCommissioncon 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.
- Botón destacado
- 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/commissionscon validación estricta de existencia de asignatura y resolución inteligente de unicidad.
- Endpoint
[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=LaxySecure. - Inyección transparente del token
Beareren peticiones internas mediante cliente Axios centralizado.
- Desacople completo del backend Python/Flask como una API REST pura bajo
- 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.
- Dashboard de Bedelía (
- 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.
- Pipeline centralizado de cabeceras de blindaje OWASP (
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.pyque 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 porcommission_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}).
- Corrección de la búsqueda de duplicados en
[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.