# 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.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 (`