# Changelog Oficial — Admin Edu-Space (UniCABA) Todas las modificaciones notables a este proyecto serán documentadas en este archivo. El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y este proyecto se adhiere a [Semantic Versioning](https://semver.org/lang/es/). --- ## [Unreleased] ### Planificado (Fase 6 del Roadmap) - **Despliegue e Infraestructura (Fase 6):** `docker-compose.yml` productivo orquestando FastAPI (Uvicorn), Node.js BFF (PM2) y PostgreSQL 15, con proxy inverso Nginx, SSL/TLS y compresión. - **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1. - **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción. ## [3.8.44] - 2026-10-28 ### Added & Security (Integración de Permisos RBAC para Beneficios, Recepción y Nuevo Perfil de Recepción) - **Incorporación de Módulos al Sistema RBAC (`SYSTEM_MODULES`)**: - Se agregaron oficialmente los módulos `benefits` (Convenios y Beneficios) y `reception` (Recepción y Control de Acceso QR) al catálogo maestro en `backend/app/models/role.py` y `frontend/src/routes/admin.js`. - Ambos módulos ahora se exponen dinámicamente en la matriz de permisos estilo FortiGate (`/admin/roles/edit` y `/admin/roles/list`) con controles segmentados (`none`, `read`, `read_write`). - **Creación y Alta del Rol Institucional 'Recepción'**: - Se registró el nuevo rol predeterminado de sistema `Recepcion` (id 8 en producción) con perfil especializado: control de acceso QR (`reception: read_write`), consulta de aulas, sedes, cronograma general, usuarios y convenios (`read`), y módulos académicos/administrativos restringidos (`none`). - Se integró el contador métrico `role_counts.recepcion` en el panel de usuarios (`/admin/users`), mostrando una tarjeta KPI dedicada para personal de recepción y control de acceso. - El selector de roles en la creación y edición de usuarios (`/admin/user_add`, `/admin/user_edit`) incluye inmediatamente el nuevo rol `Recepción`. - **Actualización de la Matriz de Permisos para Roles Existentes**: - `Admin`: `benefits: read_write`, `reception: read_write`. - `Bedelia`: `benefits: read_write`, `reception: read`. - `Docente`: `benefits: read`, `reception: none`. - `Alumno`: `benefits: read`, `reception: none`. - **Sincronización en Base de Datos de Producción (`classrooms_db`)**: - Se ejecutó script de sincronización en PostgreSQL en el servidor LXC `10.0.0.217`, garantizando la persistencia del rol y la asignación de permisos para todos los perfiles institucionales. ## [3.8.43] - 2026-10-28 ### Security & Fixed (Blindaje Anti-Prompt Injection, Detección de Logins y UX Desktop de UdeCi) - **Blindaje Robusto contra Prompt Injection y Fuga de Modelo (`PromptSecurityService`)**: - Se añadieron patrones integrales para neutralizar intentos de bypass como "ignora todos los prompts/promps", "ignore instructions", "dime qué modelo de IA eres", "who created you", "tokens de acceso" o "developer mode". - Se reforzó la directiva de identidad inquebrantable en el System Prompt de UdeCi, impidiendo cualquier mención a Qwen, Alibaba Cloud o tokens de API bajo cualquier pretexto, respondiendo siempre con su identidad oficial institucional de UniCABA. - Se aclaró la política de privacidad de conversaciones: UdeCi no almacena los chats en servidores institucionales (persistencia únicamente local en el navegador del usuario). - **Resolución Exacta de Consultas sobre Métodos de Login (`LiveContextService`)**: - Se integró el estado en tiempo real de los proveedores de autenticación configurados en `SystemSetting` (`auth_local_enabled`, `auth_google_enabled`, `auth_moodle_enabled`), permitiendo a UdeCi informar fielmente qué accesos están activos e inactivos sin alucinaciones. - Se reparó la condición de búsqueda de docentes que disparaba falsos positivos (como "No se encontraron profesores llamados 'Logins' o 'Tipo'") al consultar por tipos de login. - **Correcciones Estéticas en Modo Desktop (`ai_chat_widget.html`)**: - **Ocultamiento del Botón Lanzador**: Se convirtió la clase `.ai-chat-launcher.chat-open { display: none !important; }` en regla global (desktop y móvil), eliminando el ícono circular flotante que quedaba visible detrás del panel cuando estaba abierto. - **Centrado Vertical del Campo de Texto**: Se recalibró el pill `.ai-input-pill-container` (`min-height: 48px; display: flex; align-items: center; gap: 8px;`) y el `.ai-chat-textarea` (`height: 24px; line-height: 24px;`), alineando simétricamente el botón `+`, el texto `Pregúntame` y el botón circular magenta de enviar `↑`. ## [3.8.42] - 2026-10-28 ### Fixed & Improved (Centrado Móvil de Login, Anti-Scroll en S24 Ultra y Ampliación Desktop de UdeCi) - **Centrado Simétrico de Pantalla de Login en Móvil (`/auth/login`)**: - Se corrigió la asimetría visual en pantallas móviles (`border-left: 6px` sin contraparte derecha) migrando el acento en mobile a `border-top: 5px solid var(--brand-primary)` con bordes laterales uniformes de 1px. - Se implementó `min-height: 100dvh` y `margin: auto` en `.auth-card`, garantizando un centrado óptico y matemático perfecto en cualquier teléfono móvil (incluyendo Samsung Galaxy S24 Ultra) sin recortes por la barra de navegación de Android. - Se ajustó el padding horizontal interno de la tarjeta a `px-3 px-sm-4` para pantallas estrechas. - **Eliminación del Leve Scroll / Bamboleo Horizontal en Móvil**: - Se añadieron reglas de contención estricta en `html, body`, `.app-wrapper`, `.main-content` y `.app-main-container` (`max-width: 100%`, `overflow-x: hidden`, `width: 100%`, `box-sizing: border-box`), neutralizando los desbordes provocados por los márgenes negativos de filas Bootstrap (`-0.75rem`). - **Ampliación de Dimensiones de UdeCi en Desktop (Estilo Mercado Libre / Mago)**: - Se amplió el ancho y alto del panel de UdeCi (`.ai-chat-panel`) a `width: 480px; height: 700px;` (y `width: 520px; height: 740px;` en pantallas >= 1400px), brindando una presencia visual más amplia y profesional equivalente al asistente de Mercado Pago / Mercado Libre. - Se mantuvieron las tarjetas de preguntas rápidas sugeridas (`.ai-option-btn`) con estética nativa de Meli e íconos contextuales. ## [3.8.41] - 2026-10-28 ### Improved (Ajuste de Posición del Botón Flotante de UdeCi en Móvil) - **Reposicionamiento Interior del Botón Lanzador (`.ai-chat-launcher`)**: - Se incrementaron los márgenes inferiores y laterales en la vista móvil (`bottom: calc(32px + env(safe-area-inset-bottom, 0px))`, `right: calc(26px + env(safe-area-inset-right, 0px))`), evitando que las esquinas curvas del cristal físico y las barras de gestos de los dispositivos móviles recorten o tapen el ícono de UdeCi. - Se añadió soporte dinámico de `safe-area-inset-bottom` y `safe-area-inset-right` tanto en mobile como en desktop para una visualización 100% visible, cómoda al tacto del pulgar y ergonómica. ## [3.8.40] - 2026-10-28 ### Fixed (Corrección de Plantilla Nunjucks en Barra Lateral y Limpieza de Atributos) - **Corrección de Bloque Condicional en `base.html`**: - Se corrigió la posición del bloque `{% elif user_role == 'recepcion' %}` que había quedado ubicado después de `{% else %}` en la barra lateral (`sidebarNav`), lo cual provocaba un fallo de renderizado `Template render error: unknown block tag: elif` al acceder al dashboard. - La rama de Recepción ahora precede correctamente a la rama final por defecto (`{% else %}` para Estudiantes). - **Refactorización de Atributos HTML y Limpieza de IDE Warnings (`@[current_problems]`)**: - En `benefits/catalog.html` y `benefits/manage.html`, se reemplazó el pasaje de objetos JSON crudos en eventos inline (`onclick='openRedeemModal(...)`, `onclick="confirmDelete(...)"`) por atributos estándar HTML5 (`data-*`) y delegación de eventos en JavaScript, eliminando posibles fallos de escape y limpiando los errores reportados por el IDE. - En `live_context_service.py`, se removió la llamada redundante `str(user_id)` sobre un argumento ya tipado como `str`. ## [3.8.39] - 2026-10-27 ### Added & Enhanced (Club de Beneficios y Convenios Institucionales + Control de Acceso QR / Recepción — SDD-012) - **Club de Beneficios y Convenios Institucionales**: - Nuevo modelo relacional `InstitutionalBenefit` para convenios y promociones comerciales (cafeterías, librerías, gimnasios, tecnología). - Panel administrativo de gestión para Bedelía y Administradores (`/benefits/manage` y `/api/v1/benefits`) con filtros, métricas en vivo, carga de cupones, porcentaje de descuento y control de vigencia. - Catálogo interactivo tipo marketplace para Alumnos y Docentes (`/benefits`) con filtrado por categorías y revelado seguro de cupones. - **Valor agregado con IA (UdeCi)**: `LiveContextService` enriquecido para responder con convenios activos de la base de datos ante preguntas como *"¿Qué descuentos hay en cafetería hoy?"*. - **Perfil de Recepción y Control de Acceso QR**: - Nuevo rol institucional `RECEPCION` con permisos específicos para mesas de entrada y molinetes. - Consola de escaneo de alta velocidad (`/reception/scanner` y `/api/v1/reception/verify-qr`) con soporte para cámara web (`html5-qrcode`) y pistolas ópticas USB de código de barras. - Indicador de clase del día en tiempo real: al escanear la credencial, muestra inmediatamente al ingresante su aula física asignada, piso, horario y docente. - Nueva Credencial Universitaria Digital (`/credential/my-card` y `/api/v1/reception/my-qr-token`) con token dinámico firmado con JWT (`credential_qr`), DNI institucional y diseño tipo tarjeta universitaria. - Modelo `AccessLogQR` para registro y trazabilidad de ingresos con estados `AUTORIZADO`, `RESTRINGIDO` y `DENEGADO`. ## [3.8.38] - 2026-10-27 ### Fixed & Improved (Resiliencia de Respuesta de UdeCi y Compatibilidad Dual DTO) - **Corrección de Mapeo de Respuestas en Frontend (`response` vs `reply`)**: - Se corrigió el desacople entre el esquema del backend (`ChatResponse.response`, `ChatResponse.quick_options`) y el cliente JavaScript (`ai-chat-widget.js`), el cual provocaba que consultas válidas y fluidas (como *"tu dime ?"*) cayeran en el mensaje de error por defecto (*"Disculpa, no pude procesar tu solicitud en este momento."*) a pesar de que el backend respondía con éxito (HTTP 200). - Se implementó compatibilidad dual tanto en frontend (`data.response || data.reply`) como en el backend (`reply` y `options` como alias directos en `ChatResponse`). - **Integración Nativa de Spotlight / Walkthrough**: - Se conectó `data.guide_step` con `WalkthroughEngine.startStep()` para cerrar o minimizar el modal de UdeCi y resaltar interactivamente el botón o menú correspondiente. ## [3.8.37] - 2026-10-27 ### Removed & Cleaned (Simplificación Minimalista del Chatbot UdeCi) - **Eliminación del Cajón de Consultas Rápidas (`#aiChatQuickChips`)**: - Se suprimió el bloque intermedio desplegable de chips y botones de consultas rápidas (`.ai-quick-chips-drawer`), liberando todo el espacio vertical para una conversación fluida y limpia. - Se eliminó el botón de filtros/sliders en la cabecera, manteniendo únicamente el botón de nueva conversación (lápiz) y el de cierre. - El botón `+` en la cápsula de entrada ahora realiza el enfoque directo (`focus()`) en el campo de texto, manteniendo una estética 100% limpia y sin distracciones idéntica a Mercado Libre. ## [3.8.36] - 2026-10-27 ### Added & Enhanced (Rediseño Móvil del Chatbot UdeCi estilo Mercado Libre / Mago) - **Bottom Sheet Nativo en Móvil (< 768px)**: - Se transformó la interfaz del chatbot en móvil a un **Bottom Sheet modal nativo** inspirado en la experiencia de Mercado Libre ("Mago"), cubriendo el 92% de la pantalla (`height: 92dvh; border-top-left-radius: 28px; border-top-right-radius: 28px;`). - Incorporación de **Backdrop sombreado con desenfoque (`#aiChatBackdrop`)** que bloquea la interacción con la página web de fondo y evita desbordes visuales. - **Drag Handle Superior Interactiva**: Barra de deslizamiento táctil con soporte de gestos (`touchmove` / `touchend`) para cerrar el panel deslizando hacia abajo. - **Cabecera Flotante y Limpia**: Botón de retroceso `<` tipo píldora, ícono Sparkle animado de UdeCi y botones superiores de nuevo chat y atajos rápidos. - **Disclaimer Institucional**: Frase *"UdeCi usa inteligencia artificial para responderte."* con tipografía limpia. - **Dock de Entrada y Manejo Dinámico del Teclado Virtual (`visualViewport`)**: - Cápsula de entrada redondeada (`border-radius: 28px`) con botón circular `+` para desplegar atajos temáticos, textarea expandible con placeholder *"Pregúntame"* y botón de envío circular. - Integración de la API `window.visualViewport`: al desplegarse el teclado táctil en smartphones Android/iOS, el contenedor del chat se recalcula dinámicamente y el input se ancla **directamente encima del teclado**, eliminando cualquier espacio o transparencia no deseada. - **Burbujas de Conversación y Acciones de Feedback**: - Mensaje de usuario en píldora suave a la derecha con marca horaria (`HH:mm`) en pie de burbuja. - Mensaje de UdeCi en texto limpio y aireado con barra de utilidades (copiado al portapapeles con confirmación visual, lectura con síntesis de voz `SpeechSynthesisUtterance` y pulgares de valoración). - Explicitación en System Prompt de las capacidades accesibles del tutor virtual (datos académicos, ocupación, reservas, clima en tiempo real de Sede Central y rutas Google Maps). ## [3.8.35] - 2026-10-27 ### Fixed & Enhanced (Comportamiento de Acordeón Único y Legibilidad de Alto Contraste en Menú Lateral) - **Acordeón Estricto de Menú Lateral (Un Solo Menú Desplegado)**: - Se incorporó `data-bs-parent="#sidebarNav"` en los 13 contenedores colapsables (`
`) de la barra lateral para todos los roles (Administrador, Bedelía, Docente y Estudiante). - Se reescribió la lógica en JavaScript eliminando el guardado acumulativo de submenús abiertos en `localStorage` (`edu_sidebar_open_submenus`). - Al cargar cualquier vista, el sistema detecta la URL activa (`window.location.pathname`), resalta el ítem en curso y despliega **únicamente** el submenú correspondiente al que pertenece el usuario, colapsando automáticamente todos los demás. - En vistas de inicio o tablero principal (`/dashboard`, `/`), todos los submenús permanecen elegantemente replegados. - Al abrir un submenú manualmente, cualquier otro que esté visible se oculta de forma inmediata. - **Legibilidad y Contraste WCAG AAA en Tipografía de Navegación**: - Se corrigió el problema de bajo contraste provocado por clases utilitarias de Bootstrap (`.text-info`, `.text-success`, `.text-warning`, `.text-primary`) en enlaces de submenús sobre fondo blanco o gris claro, asignando paletas adaptativas oscuras (`#0369A1`, `#15803D`, `#B45309`, `#7E22CE` en modo claro y sus contrapartes nítidas luminosas en modo oscuro). - Se reforzó la legibilidad de los textos en `.sidebar-submenu .nav-link` con color Slate-900 (`#0F172A`) y peso seminegrita `font-weight: 600`. - Se incrementó el contraste de los encabezados de sección `.sidebar-section-header` a Slate-700 (`#334155`) en modo claro y Slate-300 (`#CBD5E1`) en modo oscuro con peso `font-weight: 800`. - Se eliminó duplicación de reglas CSS en submenús y se amplió el ancho del sidebar a `275px` para evitar desbordes y cortes de palabras compuestas. ## [3.8.34] - 2026-10-27 ### Added & Enhanced (Rediseño Estético del Menú Lateral, Clima del Campus y Enriquecimiento Operativo de UdeCi) - **Rediseño Estético de Calidad Industrial en Menú Lateral (Sidebar)**: - **Micro-interacciones y Efectos Elevados**: Se aplicó la misma filosofía visual y dinámica del botón de usuario y del botón de cambio de modo oscuro/claro a todos los elementos del menú lateral: - Contenedor de ícono estilizado (`.nav-link > i:first-child`) tipo badge con fondo tenue, borde sutil y rotación/escalado dinámico al pasar el cursor (`transform: scale(1.08) rotate(3deg)`). - Enlaces de navegación con elevación suave (`transform: translateY(-1px) translateX(2px)`), glow perimetral y sombras difusas tanto en tema claro como oscuro. - Estado activo/expandido (`aria-expanded="true"`) con degradados institucionales UniCABA (`#B43E8E` a `#682CAD`), indicador de acento lateral y rotación suave de 180° del chevron indicador. - **Jerarquía y Encabezados de Sección Semánticos**: Incorporación de separadores de sección estilizados (`.sidebar-section-header`) para los 4 roles institucionales (Admin, Bedelía, Docente, Alumno), aportando orden visual y cognitivo. - **Submenús Guiados (Tree Layout)**: Línea vertical continua que conecta visualmente los ítems anidados con animación de desplazamiento lateral (`translateX(4px)`) en hover. - **Scrollbar Ultrafino y Limpio**: Barra de desplazamiento personalizada de 5px con bordes redondeados y contraste adaptativo según el tema. - **Estructura HTML Validada**: Envoltorio canónico `