# 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.45] - 2026-10-28 ### Added & UX (Acceso Global a Credencial Digital QR y Código QR Dinámico en Perfil de Usuario) - **Botón Global de Acceso a Credencial QR (`qr-credential-btn`)**: - Se incorporó un botón de acceso directo con icono `bi-qr-code-scan` junto al botón de tema visual en el pie de la barra lateral (`sidebar-footer`) y en la cabecera móvil (`mobile-header`). - Al hacer clic, abre un modal global interactivo (`#userQrCredentialModal`) con estética de credencial universitaria, datos del usuario autenticado, código QR generado criptográficamente y botón de actualización en tiempo real. - Se añadió la opción "Mi Credencial QR" en el menú desplegable del perfil de usuario (`user-dropdown-menu`). - **Código QR Dinámico en Vista de Perfil (`/auth/profile`)**: - Se integró una tarjeta destacada de "Credencial Universitaria · Acceso QR Dinámico" en `profile.html`, renderizando el código QR firmado con datos de matrícula, DNI y estado activo. - Soporte de renovación inmediata con botón "Actualizar Código QR" mediante llamada asíncrona a `/credential/token` sin recargar la página. - **Endpoint BFF `/credential/token`**: - Se expuso el endpoint JSON en Express para suministrar tokens dinámicos con firma HMAC y tiempo de expiración (72hs) para consumo de clientes web. ## [3.8.44] - 2026-10-28 ### Added & Security (Integración de Permisos RBAC para Beneficios, Recepción y Nuevo Perfil de Recepción) - **Incorporación de Módulos al Sistema RBAC (`SYSTEM_MODULES`)**: - Se agregaron oficialmente los módulos `benefits` (Convenios y Beneficios) y `reception` (Recepción y Control de Acceso QR) al catálogo maestro en `backend/app/models/role.py` y `frontend/src/routes/admin.js`. - Ambos módulos ahora se exponen dinámicamente en la matriz de permisos estilo FortiGate (`/admin/roles/edit` y `/admin/roles/list`) con controles segmentados (`none`, `read`, `read_write`). - **Creación y Alta del Rol Institucional 'Recepción'**: - Se registró el nuevo rol predeterminado de sistema `Recepcion` (id 8 en producción) con perfil especializado: control de acceso QR (`reception: read_write`), consulta de aulas, sedes, cronograma general, usuarios y convenios (`read`), y módulos académicos/administrativos restringidos (`none`). - Se integró el contador métrico `role_counts.recepcion` en el panel de usuarios (`/admin/users`), mostrando una tarjeta KPI dedicada para personal de recepción y control de acceso. - El selector de roles en la creación y edición de usuarios (`/admin/user_add`, `/admin/user_edit`) incluye inmediatamente el nuevo rol `Recepción`. - **Actualización de la Matriz de Permisos para Roles Existentes**: - `Admin`: `benefits: read_write`, `reception: read_write`. - `Bedelia`: `benefits: read_write`, `reception: read`. - `Docente`: `benefits: read`, `reception: none`. - `Alumno`: `benefits: read`, `reception: none`. - **Sincronización en Base de Datos de Producción (`classrooms_db`)**: - Se ejecutó script de sincronización en PostgreSQL en el servidor LXC `10.0.0.217`, garantizando la persistencia del rol y la asignación de permisos para todos los perfiles institucionales. ## [3.8.43] - 2026-10-28 ### Security & Fixed (Blindaje Anti-Prompt Injection, Detección de Logins y UX Desktop de UdeCi) - **Blindaje Robusto contra Prompt Injection y Fuga de Modelo (`PromptSecurityService`)**: - Se añadieron patrones integrales para neutralizar intentos de bypass como "ignora todos los prompts/promps", "ignore instructions", "dime qué modelo de IA eres", "who created you", "tokens de acceso" o "developer mode". - Se reforzó la directiva de identidad inquebrantable en el System Prompt de UdeCi, impidiendo cualquier mención a Qwen, Alibaba Cloud o tokens de API bajo cualquier pretexto, respondiendo siempre con su identidad oficial institucional de UniCABA. - Se aclaró la política de privacidad de conversaciones: UdeCi no almacena los chats en servidores institucionales (persistencia únicamente local en el navegador del usuario). - **Resolución Exacta de Consultas sobre Métodos de Login (`LiveContextService`)**: - Se integró el estado en tiempo real de los proveedores de autenticación configurados en `SystemSetting` (`auth_local_enabled`, `auth_google_enabled`, `auth_moodle_enabled`), permitiendo a UdeCi informar fielmente qué accesos están activos e inactivos sin alucinaciones. - Se reparó la condición de búsqueda de docentes que disparaba falsos positivos (como "No se encontraron profesores llamados 'Logins' o 'Tipo'") al consultar por tipos de login. - **Correcciones Estéticas en Modo Desktop (`ai_chat_widget.html`)**: - **Ocultamiento del Botón Lanzador**: Se convirtió la clase `.ai-chat-launcher.chat-open { display: none !important; }` en regla global (desktop y móvil), eliminando el ícono circular flotante que quedaba visible detrás del panel cuando estaba abierto. - **Centrado Vertical del Campo de Texto**: Se recalibró el pill `.ai-input-pill-container` (`min-height: 48px; display: flex; align-items: center; gap: 8px;`) y el `.ai-chat-textarea` (`height: 24px; line-height: 24px;`), alineando simétricamente el botón `+`, el texto `Pregúntame` y el botón circular magenta de enviar `↑`. ## [3.8.42] - 2026-10-28 ### Fixed & Improved (Centrado Móvil de Login, Anti-Scroll en S24 Ultra y Ampliación Desktop de UdeCi) - **Centrado Simétrico de Pantalla de Login en Móvil (`/auth/login`)**: - Se corrigió la asimetría visual en pantallas móviles (`border-left: 6px` sin contraparte derecha) migrando el acento en mobile a `border-top: 5px solid var(--brand-primary)` con bordes laterales uniformes de 1px. - Se implementó `min-height: 100dvh` y `margin: auto` en `.auth-card`, garantizando un centrado óptico y matemático perfecto en cualquier teléfono móvil (incluyendo Samsung Galaxy S24 Ultra) sin recortes por la barra de navegación de Android. - Se ajustó el padding horizontal interno de la tarjeta a `px-3 px-sm-4` para pantallas estrechas. - **Eliminación del Leve Scroll / Bamboleo Horizontal en Móvil**: - Se añadieron reglas de contención estricta en `html, body`, `.app-wrapper`, `.main-content` y `.app-main-container` (`max-width: 100%`, `overflow-x: hidden`, `width: 100%`, `box-sizing: border-box`), neutralizando los desbordes provocados por los márgenes negativos de filas Bootstrap (`-0.75rem`). - **Ampliación de Dimensiones de UdeCi en Desktop (Estilo Mercado Libre / Mago)**: - Se amplió el ancho y alto del panel de UdeCi (`.ai-chat-panel`) a `width: 480px; height: 700px;` (y `width: 520px; height: 740px;` en pantallas >= 1400px), brindando una presencia visual más amplia y profesional equivalente al asistente de Mercado Pago / Mercado Libre. - Se mantuvieron las tarjetas de preguntas rápidas sugeridas (`.ai-option-btn`) con estética nativa de Meli e íconos contextuales. ## [3.8.41] - 2026-10-28 ### Improved (Ajuste de Posición del Botón Flotante de UdeCi en Móvil) - **Reposicionamiento Interior del Botón Lanzador (`.ai-chat-launcher`)**: - Se incrementaron los márgenes inferiores y laterales en la vista móvil (`bottom: calc(32px + env(safe-area-inset-bottom, 0px))`, `right: calc(26px + env(safe-area-inset-right, 0px))`), evitando que las esquinas curvas del cristal físico y las barras de gestos de los dispositivos móviles recorten o tapen el ícono de UdeCi. - Se añadió soporte dinámico de `safe-area-inset-bottom` y `safe-area-inset-right` tanto en mobile como en desktop para una visualización 100% visible, cómoda al tacto del pulgar y ergonómica. ## [3.8.40] - 2026-10-28 ### Fixed (Corrección de Plantilla Nunjucks en Barra Lateral y Limpieza de Atributos) - **Corrección de Bloque Condicional en `base.html`**: - Se corrigió la posición del bloque `{% elif user_role == 'recepcion' %}` que había quedado ubicado después de `{% else %}` en la barra lateral (`sidebarNav`), lo cual provocaba un fallo de renderizado `Template render error: unknown block tag: elif` al acceder al dashboard. - La rama de Recepción ahora precede correctamente a la rama final por defecto (`{% else %}` para Estudiantes). - **Refactorización de Atributos HTML y Limpieza de IDE Warnings (`@[current_problems]`)**: - En `benefits/catalog.html` y `benefits/manage.html`, se reemplazó el pasaje de objetos JSON crudos en eventos inline (`onclick='openRedeemModal(...)`, `onclick="confirmDelete(...)"`) por atributos estándar HTML5 (`data-*`) y delegación de eventos en JavaScript, eliminando posibles fallos de escape y limpiando los errores reportados por el IDE. - En `live_context_service.py`, se removió la llamada redundante `str(user_id)` sobre un argumento ya tipado como `str`. ## [3.8.39] - 2026-10-27 ### Added & Enhanced (Club de Beneficios y Convenios Institucionales + Control de Acceso QR / Recepción — SDD-012) - **Club de Beneficios y Convenios Institucionales**: - Nuevo modelo relacional `InstitutionalBenefit` para convenios y promociones comerciales (cafeterías, librerías, gimnasios, tecnología). - Panel administrativo de gestión para Bedelía y Administradores (`/benefits/manage` y `/api/v1/benefits`) con filtros, métricas en vivo, carga de cupones, porcentaje de descuento y control de vigencia. - Catálogo interactivo tipo marketplace para Alumnos y Docentes (`/benefits`) con filtrado por categorías y revelado seguro de cupones. - **Valor agregado con IA (UdeCi)**: `LiveContextService` enriquecido para responder con convenios activos de la base de datos ante preguntas como *"¿Qué descuentos hay en cafetería hoy?"*. - **Perfil de Recepción y Control de Acceso QR**: - Nuevo rol institucional `RECEPCION` con permisos específicos para mesas de entrada y molinetes. - Consola de escaneo de alta velocidad (`/reception/scanner` y `/api/v1/reception/verify-qr`) con soporte para cámara web (`html5-qrcode`) y pistolas ópticas USB de código de barras. - Indicador de clase del día en tiempo real: al escanear la credencial, muestra inmediatamente al ingresante su aula física asignada, piso, horario y docente. - Nueva Credencial Universitaria Digital (`/credential/my-card` y `/api/v1/reception/my-qr-token`) con token dinámico firmado con JWT (`credential_qr`), DNI institucional y diseño tipo tarjeta universitaria. - Modelo `AccessLogQR` para registro y trazabilidad de ingresos con estados `AUTORIZADO`, `RESTRINGIDO` y `DENEGADO`. ## [3.8.38] - 2026-10-27 ### Fixed & Improved (Resiliencia de Respuesta de UdeCi y Compatibilidad Dual DTO) - **Corrección de Mapeo de Respuestas en Frontend (`response` vs `reply`)**: - Se corrigió el desacople entre el esquema del backend (`ChatResponse.response`, `ChatResponse.quick_options`) y el cliente JavaScript (`ai-chat-widget.js`), el cual provocaba que consultas válidas y fluidas (como *"tu dime ?"*) cayeran en el mensaje de error por defecto (*"Disculpa, no pude procesar tu solicitud en este momento."*) a pesar de que el backend respondía con éxito (HTTP 200). - Se implementó compatibilidad dual tanto en frontend (`data.response || data.reply`) como en el backend (`reply` y `options` como alias directos en `ChatResponse`). - **Integración Nativa de Spotlight / Walkthrough**: - Se conectó `data.guide_step` con `WalkthroughEngine.startStep()` para cerrar o minimizar el modal de UdeCi y resaltar interactivamente el botón o menú correspondiente. ## [3.8.37] - 2026-10-27 ### Removed & Cleaned (Simplificación Minimalista del Chatbot UdeCi) - **Eliminación del Cajón de Consultas Rápidas (`#aiChatQuickChips`)**: - Se suprimió el bloque intermedio desplegable de chips y botones de consultas rápidas (`.ai-quick-chips-drawer`), liberando todo el espacio vertical para una conversación fluida y limpia. - Se eliminó el botón de filtros/sliders en la cabecera, manteniendo únicamente el botón de nueva conversación (lápiz) y el de cierre. - El botón `+` en la cápsula de entrada ahora realiza el enfoque directo (`focus()`) en el campo de texto, manteniendo una estética 100% limpia y sin distracciones idéntica a Mercado Libre. ## [3.8.36] - 2026-10-27 ### Added & Enhanced (Rediseño Móvil del Chatbot UdeCi estilo Mercado Libre / Mago) - **Bottom Sheet Nativo en Móvil (< 768px)**: - Se transformó la interfaz del chatbot en móvil a un **Bottom Sheet modal nativo** inspirado en la experiencia de Mercado Libre ("Mago"), cubriendo el 92% de la pantalla (`height: 92dvh; border-top-left-radius: 28px; border-top-right-radius: 28px;`). - Incorporación de **Backdrop sombreado con desenfoque (`#aiChatBackdrop`)** que bloquea la interacción con la página web de fondo y evita desbordes visuales. - **Drag Handle Superior Interactiva**: Barra de deslizamiento táctil con soporte de gestos (`touchmove` / `touchend`) para cerrar el panel deslizando hacia abajo. - **Cabecera Flotante y Limpia**: Botón de retroceso `<` tipo píldora, ícono Sparkle animado de UdeCi y botones superiores de nuevo chat y atajos rápidos. - **Disclaimer Institucional**: Frase *"UdeCi usa inteligencia artificial para responderte."* con tipografía limpia. - **Dock de Entrada y Manejo Dinámico del Teclado Virtual (`visualViewport`)**: - Cápsula de entrada redondeada (`border-radius: 28px`) con botón circular `+` para desplegar atajos temáticos, textarea expandible con placeholder *"Pregúntame"* y botón de envío circular. - Integración de la API `window.visualViewport`: al desplegarse el teclado táctil en smartphones Android/iOS, el contenedor del chat se recalcula dinámicamente y el input se ancla **directamente encima del teclado**, eliminando cualquier espacio o transparencia no deseada. - **Burbujas de Conversación y Acciones de Feedback**: - Mensaje de usuario en píldora suave a la derecha con marca horaria (`HH:mm`) en pie de burbuja. - Mensaje de UdeCi en texto limpio y aireado con barra de utilidades (copiado al portapapeles con confirmación visual, lectura con síntesis de voz `SpeechSynthesisUtterance` y pulgares de valoración). - Explicitación en System Prompt de las capacidades accesibles del tutor virtual (datos académicos, ocupación, reservas, clima en tiempo real de Sede Central y rutas Google Maps). ## [3.8.35] - 2026-10-27 ### Fixed & Enhanced (Comportamiento de Acordeón Único y Legibilidad de Alto Contraste en Menú Lateral) - **Acordeón Estricto de Menú Lateral (Un Solo Menú Desplegado)**: - Se incorporó `data-bs-parent="#sidebarNav"` en los 13 contenedores colapsables (`