# 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.56] - 2026-11-04 ### Fixed & Enhanced (Consolidación al 04/11/2026, Eliminación de Fondos Invasivos, Optimización de Buffer Serial y Documentación Integral) - **Eliminación Total de Fondos Gráficos Invasivos en Recepción (`/reception/scanner`)**: - Se removió por completo la marca de agua `bg_course-card.png` que generaba un recuadro rosado recortado antiestético en la ficha de validación. - Se eliminó el degradado forzado `square_course_name.png` en el encabezado de resultado (`resultHeader`), devolviendo la cabecera limpia, nativa y perfectamente integrada con los temas claro y oscuro del sistema. - Se retiró el isotipo `mini_logo_icon.png` del título del lector, preservando la iconografía SVG limpia y sobria de Edu-Space. - **Corrección Crítica en Resolución de DNI (Bug de Interceptación por Puntos JWT)**: - **Falsa Detección de JWT Erradicada**: Anteriormente cualquier código con dos puntos (`count('.') == 2`), tales como DNIs con formato de miles `34.247.025` o fechas de emisión/nacimiento `09.02.89` en códigos de barras Renaper, era interceptado erróneamente por el validador JWT y abortaba con error de firma inválida. Ahora solo se procesa como JWT si posee estructura Base64URL real (`eyJ...` o 3 bloques alfanuméricos puros) y ante fallo sintáctico continúa de inmediato con los métodos de resolución de DNI. - **Soporte Universal de Prefijos DNI**: `limpiar_numero_documento` y `parsear_dni` ahora filtran prefijos habituales (`DNI:`, `DNI `, `D.N.I.`, `DOC:`) y toleran delimitadores adicionales como `;`. - **Protección de Caracteres en Nombres**: La sustitución de `Ñ` por `:` (teclados con mapa de caracteres en español) ahora se restringe exclusivamente a prefijos de protocolo institucional (`UNICABAÑ`, `ÑUSRÑ`, `ÑDNIÑ`), preservando intactos los apellidos o nombres con `Ñ` (ej. Piñero, Peña, Núñez). - **Auto-recuperación y Asociación de Documento**: Si el escaneo de DNI físico contiene nombre y apellido y no coincide con el número exacto, se resuelve por coincidencia nominal y se vincula automáticamente el documento al registro del usuario en la base de datos. - **Optimización del Buffer Serial para Códigos de Alta Densidad (serial-scanner.js)**: - Se amplió el temporizador de recolección de paquetes de caracteres en MultiSerialBarcodeScanner a 380 ms (slot.bufferTimeout = setTimeout(..., 380)), permitiendo recibir de forma íntegra sin fragmentación cadenas extensas de más de 400 caracteres transmitidas por lectores ópticos seriales (tales como códigos QR oficiales de Renaper 2026 con JWT embebido). - **Actualización Documental y Tecnológica Integral (README.md y CHANGELOG.md)**: - Sincronización completa de la documentación oficial reflejando la arquitectura real 100% nativa **FastAPI ASGI pura** (uvicorn main:app --port 5000), Pydantic v2 DTOs, OpenAPI v3 (/docs, /redoc), y erradicación definitiva de referencias legacy a Flask. - Documentación exhaustiva de todas las capacidades vigentes: Asistente Virtual Inteligente **UdeCi** (RAG embebido, inyección de contexto profundo de PostgreSQL, prompt security, UX adaptativa móvil/desktop), Servidor **MCP** institucional (/api/v1/mcp), Consola de Recepción Multi-Serial COM (Web Serial API para hasta 4 lectores simultáneos), Credencial Digital Universitaria con QR dinámico anti-screenshot (3s), Módulo de Beneficios y Convenios, y Acceso de Contingencia Admin (/adm/login). - Validación de la suite completa de pruebas automatizadas: **131 de 131 pruebas ejecutadas y aprobadas con éxito** (131 passed) en pytest. ## [3.8.55] - 2026-10-28 ### Added & Enhanced (Ergonomía de Recepción, Auto-foco Opcional, COM Contraíble, Recursos Gráficos y Contrastes Dark Mode) - **Reorganización Ergonómica de la Consola de Recepción (`/reception/scanner`)**: - **Columna Izquierda (`col-lg-5`)**: Lector óptico USB HID / pistola de código de barras junto con la tabla histórica de Últimos Ingresos Registrados en Sede, consolidando la zona de captura e inspección inmediata. - **Columna Derecha (`col-lg-7`)**: Ficha de resultado y validación en pantalla completa y panel de configuración de puertos serie COM. - **Panel de Puertos Serie COM Minimizable / Contraíble**: El bloque de gestión de hasta 4 lectores seriales ahora se encuentra contraído (`collapse`) por defecto con indicador de rotación de chevron y badge resumen `0 / 4 Activos`, expandible con un solo clic. - **Control Interactivo de Auto-foco del Cursor**: - Desactivación predeterminada del bucle de captura forzada que secuestraba el foco del cursor cada 2 segundos. - Botón selector en cabecera (`#btnToggleAutoFocus`) que permite al operador activar o desactivar la retención automática del cursor en el campo de escaneo según su flujo de trabajo. - **Integración Sutil de Recursos Gráficos Institucionales**: - `mini_logo_icon.png`: Isotipo oficial integrado en el encabezado del lector óptico. - `square_course_name.png`: Banner degradado institucional aplicado como fondo suave en la cabecera del resultado de validación. - `bg_course-card.png`: Marca de agua botánica oficial aplicada sutilmente en el cuerpo de la ficha de validación. - **Optimización Integral de Contrastes en Modo Oscuro (WCAG AA)**: - Eliminación de estilos en línea que forzaban fondos claros sobre el modo oscuro. - Ajuste de paletas de fondo (`#17162E`, `#1F1D3C`, `#0E0D1D`), bordes violetas `#8B5CF6`, tipografía `#F8FAFC` y placeholders legibles `#94A3B8`. - Estilización adaptativa de tablas `#recentLogsTable` y del contenedor de cronograma áulico `classes-section-container`. ## [3.8.54] - 2026-10-28 ### Fixed & Enhanced (Desacople Total de Modal QR vs Carnet Completo, Normalización de DNI y Visibilidad de Usuario/Acceso) - **Desacople y Eliminación de Bloqueo/Solapamiento entre `/credential/my-card` y Modal Global**: - Se desacoplaron los disparadores del modal `#userQrCredentialModal` en la vista de carnet completo (`/credential/my-card`): al hacer clic en los botones de barra o menú mientras se está en la página del carnet, se genera un scroll suave y destello visual sobre la credencial activa en pantalla en lugar de abrir un modal redundante que tape la vista. - Empaquetado local e independiente de la librería `qrcode.min.js` en `frontend/public/js/qrcode.min.js`, eliminando la dependencia frágil de CDNs externos (`cdn.jsdelivr.net`) y evitando que el spinner de generación de QR quede colgado indefinidamente. - Migración del disparador del loop de generación en el modal de `show.bs.modal` a `shown.bs.modal` para garantizar dimensiones estables en el DOM, actualizando el canvas existente mediante `qrModalInstance.makeCode(token)` sin destruir ni recrear contenedores. - Limpieza exhaustiva de eventos, temporizadores y clases CSS (`modal-open`, eliminación de backdrops huérfanos) al cerrar el modal, garantizando el desbloqueo absoluto de la pantalla y el scroll. - **Visualización de Documento (DNI) y Nombre de Usuario / Login**: - Corrección de la ficha de carnet universitario (`frontend/views/credential/card.html`): ahora muestra fehacientemente el número de documento / DNI institucional (`{{ user.document_number or user.dni or 'Sin DNI Registrado' }}`) en lugar de hacer fallback a la dirección de correo electrónico. - Inclusión de `document_number`, `document_type`, `dni` y `username` en el payload de los tokens JWT de acceso (`backend/app/services/jwt_service.py`) y en la sesión decodificada de Express (`frontend/src/middlewares/authMiddleware.js`). - Extensión de la ficha de perfil de usuario (`frontend/views/auth/profile.html`): se exponen claramente el **Número de Documento (DNI)**, el **Nombre de Usuario / Alias de Login** y el **Origen de la Cuenta / Método de Acceso** (Local, Google Workspace o Moodle Campus Virtual), con instructivo explícito sobre las vías válidas de inicio de sesión. - Propiedades `@property def username` y `@property def auth_provider_label` agregadas formalmente al modelo `User` en `backend/app/models/user.py`. - **Adaptación y Corrección en DNI Parser y Búsqueda en Base de Datos**: - Se eliminaron los llamados redundantes a `str()` en `backend/app/services/argentine_dni_parser.py` (líneas 15 y 43), erradicando las alertas de linter del IDE (Principio 10). - Se ampliaron los separadores admitidos en `parsear_dni` (comillas simples `'`, barras `|`, arrobas `@`) para lectores de códigos de barras configurados con emulación de teclado en español. - Corrección crítica en `backend/app/services/qr_security_service.py`: eliminación de la referencia no soportada `User.username == doc` en SQLAlchemy, reemplazándola por una consulta multi-criterio robusta con `func.replace(User.document_number, '.', '')`, eliminación de ceros a la izquierda (`lstrip('0')`) y coincidencia de prefijos de correo electrónico institucional, asegurando que cualquier DNI escaneado coincida inmediatamente con los alumnos registrados en el padrón. ## [3.8.53] - 2026-10-28 ### Added & Improved (Reconexión/Desconexión Robusta de Lectores COM y URL Oficial de Moodle con Guía de Contraseñas en RAG) - **Ciclo de Vida y Reconexión Automática Plug & Play de Lectores COM**: - Detección de eventos nativos de hardware `navigator.serial.addEventListener('connect', ...)` y `'disconnect'`, permitiendo la auto-reconexión inmediata al enchufar o re-enchufar escáneres USB-Serial sin necesidad de recargar la página. - Reutilización inteligente de puertos COM autorizados: el botón rápido "Conectar Lector COM" reasigna puertos ya concedidos por el navegador antes de forzar el modal del sistema operativo. - Cierre y desconexión segura sin bloqueo de streams en Windows (`reader.cancel()`, `reader.releaseLock()` y `port.close()`), previniendo errores de "puerto ocupado". - Barra de acciones globales en `/reception/scanner`: botón prominente *"Conectar Lector COM"*, *"Reconectar Autorizados"* y *"Desconectar Todos"*. - Timeout automático de seguridad (120ms) en el buffer de chunks para escáneres que no transmitan terminadores `\r`/`\n`. - **Actualización de Moodle en Base de Conocimiento RAG y Chatbot UdeCi**: - Configuración de la URL oficial estricta del Campus Virtual de UniCABA: `https://campus.udelaciudad.edu.ar` (con hipervínculo descriptivo `[Campus Virtual UniCABA](https://campus.udelaciudad.edu.ar)`). - Especificación explícita de que **Admin Edu-Space NO establece, almacena ni gestiona las contraseñas de Moodle ni de Google Workspace**. - Incorporación en RAG y Regla 11 del System Prompt de UdeCi de las 3 modalidades de acceso institucionales: 1. *Google Workspace (@unicaba.edu.ar)*: Correo y contraseña administrada por Google. 2. *Campus Virtual Moodle*: Acceso con DNI/usuario y contraseña emitida por Moodle / Campus Virtual de forma independiente (con enlace al recuperador oficial `https://campus.udelaciudad.edu.ar/login/forgot_password.php`). 3. *Acceso Local*: Cuentas administrativas o de emergencia locales en Edu-Space. ## [3.8.52] - 2026-10-28 ### Added & Enhanced (Soporte Multi-Lector de hasta 4 Puertos COM y Reconocimiento Universal de DNI Argentino) - **Soporte Multi-Lector Serie COM (Hasta 4 Lectores Simultáneos)**: - Se extendió el motor de lectura serie a la clase `MultiSerialBarcodeScanner` en `frontend/public/js/serial-scanner.js`, administrando 4 ranuras de hardware independientes (`Lector 1 (Paso Principal)`, `Lector 2 (Molinete / Acceso)`, `Lector 3 (Mesa Bedelía)`, `Lector 4 (Auxiliar / Puesto 2)`). - Cada ranura dispone de control individual de apertura (`requestPort`), configuración de velocidad en baudios (9600 predeterminado / 115200), LED indicador con pulso en vivo (`bg-success`), botón conectar/desconectar y reconexión automática en bloque con `reconnectAuthorizedComPorts()`. - La interfaz de recepción destaca visualmente la ranura que originó cada escaneo (`flashSlotCard`) y notifica en el badge flotante la terminal emisora (ej: `¡Nuevo Escaneo! Lector 2 (Molinete)`). - **Módulo de Reconocimiento y Parseo de DNI Argentino (`argentine_dni_parser.py`)**: - Implementación del algoritmo oficial de extracción y normalización de documentos de identidad argentinos para códigos de barras PDF417 y QR emitidos por Renaper y la App Mi Argentina: - *Formato 2026*: DNI en posición 3 con ejemplar alfabético (`00749743816"TELLO"CARLOS FACUNDO"34247025"G"...`). - *Formato 2009 con comilla inicial*: Posición fija de documento, apellido, nombre y sexo (`"20979166 "A"1"CASTIGLIONI"...`). - *Formato 2009 con prefijos de género antiguos*: Manejo de prefijos `F` / `M` (`"f5592570 "A"1"SAUCEDO"...` ➔ DNI `5592570`). - *Formato App Mi Argentina*: Con sexo numérico `1=M`, `2=F`, `3=X` y DNI numérico (`305336518"CIRILLI"...` / `680051210"TELLO"...`). - *Formato 2012*: Sexo en posición 3 y DNI en posición 4 (`00225303383"RIO"MARTINA"F"46585482"...`). - *Tolerancia de delimitadores*: Compatibilidad idéntica con delimitadores de comilla doble (`"`) y arroba (`@`). - **Integración Académica en Tiempo Real en `QRSecurityService`**: - Al escanear un DNI físico o credencial digital Renaper, el backend extrae el número de documento y busca de forma transparente al alumno, docente o bedel en el padrón (`document_number`, `username` o `email`). - Si el usuario existe, se validan sus permisos y se computan sus clases del día en la sede física. - Si no existe en la base de datos de UniCABA, el sistema responde informando claramente los datos leídos del documento físico (ej: *"DNI argentino 34247025 (TELLO CARLOS FACUNDO) no se encuentra registrado en el padrón de UniCABA"*). - **Suite de Pruebas Automatizadas**: - Se añadieron 9 pruebas unitarias en `backend/tests/test_dni_parser.py` validando todos los formatos y ejemplos provistos, alcanzando 17/17 pruebas superadas en el backend. ## [3.8.51] - 2026-10-28 ### Added & Improved (Alerta Visual Ámbar sin Clases Hoy e Interacciones de Detección de Nuevo Escaneo en Recepción) - **Diferenciación Cromática por Cursada del Día (`/reception/scanner`)**: - Se implementó un esquema de color diferenciado cuando el alumno/titular está activo/regular pero **no tiene clases presenciales programadas para la fecha**: - **Cuadro con Cursada Hoy**: Borde verde `border-success`, cabecera verde esmeralda y badge "Tiene Cursada". - **Cuadro sin Cursada Hoy**: Borde ámbar `border-warning`, fondo suave `#FFFDF5`, cabecera ámbar de advertencia (`bg-warning text-dark fw-bold`), badge distintivo "Sin Cursada Hoy" y alerta explicativa `alert-warning` con icono de calendario tachado indicando que no tiene aula física asignada. - **Interacción Dinámica para la Detección Inmediata de Nuevos Escaneos**: - **Efecto de Destello / Pulso Visual**: Cada nuevo escaneo recibido re-dispara una animación CSS de resplandor (`animate-scan-success`, `animate-scan-warning` o `animate-scan-danger`) forzando reflow del DOM, lo que permite a la operadora notar el escaneo al instante incluso por visión periférica. - **Badge Flotante Animado**: Muestra el indicador `¡Nuevo Escaneo Registrado!` (`animate-pulse-badge`) en la cabecera durante los primeros 2.5 segundos de cada lectura. - **Feedback Auditivo Diferenciado (Web Audio API)**: - *Tono Armónico Doble Ascendente (587Hz -> 880Hz)*: Cuando el alumno o docente tiene clases programadas hoy con aula asignada. - *Tono Suave Medio (440Hz -> 554Hz)*: Cuando el alumno ingresa pero no tiene clases hoy (aviso para control de Bedelía). - *Tono Grave de Alerta (220Hz)*: Ante accesos denegados, credenciales expiradas o no registradas. ## [3.8.50] - 2026-10-28 ### Added & Changed (Depuración de Sedes Físicas en Recepción, Eliminación de Cámara y Especificación SDD-013 Web Serial COM) - **Depuración de Sedes en la Consola de Recepción**: - Se filtró estrictamente el selector de sedes (`/reception/scanner`) para mostrar únicamente sedes físicas/presenciales, excluyendo completamente al Campus Virtual por tratarse de un puesto de control físico. - Se configuró la sede física **Edificio Central** (`CENTRAL`) como el punto de control predeterminado seleccionado al abrir la consola de acceso. - **Eliminación Total del Escaneo por Cámara Web**: - Se removió el lector de cámara, la librería `html5-qrcode` y los botones interactivos asociados, reconvirtiendo la columna de escaneo en un panel dedicado de alta velocidad para pistolas ópticas y lectores por puerto serie. - **Especificación e Integración SDD-013 (Lector Óptico por Puerto Serie COM)**: - Creación de la especificación SDD-013 (`specs/013-escaner-qr-puerto-com-serial/` con `spec.md`, `plan.md`, `tasks.md`) bajo sintaxis EARS en español. - Implementación del módulo frontend `serial-scanner.js` utilizando la **Web Serial API** (`navigator.serial`) para motores Chromium (Google Chrome, Microsoft Edge, Opera, Brave) en entornos Windows. - Permite la captura directa de lecturas de código de barras y QR desde puertos COM físicos/virtuales sin depender del foco del cursor ni de la emulación de teclado, con reconexión automática y bufferizado por delimitador de línea. ## [3.8.49] - 2026-10-28 ### Added & Fixed (Anti-Captura Estricto en QR Dinámico, Corrección de Zona Horaria de Buenos Aires y Registro Óptico) - **Corrección Integral del Desfasaje Horario en Registros de Ingreso**: - Se corrigió el desfasaje de 3 horas en la visualización de ingresos en la Consola de Recepción (`/reception/scanner`), donde los registros se mostraban en hora UTC (16:18 hs) en lugar de la hora local argentina (13:18 hs). - Se implementó la función `to_argentina_time` en el backend (`reception.py`) para convertir los datetimes a la zona horaria oficial `America/Argentina/Buenos_Aires` (UTC-3), poblando el nuevo atributo `scanned_time` ("HH:MM hs"). - En el frontend (`reception.js` y `scanner.html`), se adaptaron tanto el render inicial de Nunjucks como las actualizaciones AJAX periódicas para formatear la hora en la zona horaria institucional de Buenos Aires. - **Ventana Estricta Anti-Captura de Pantalla en el QR Dinámico**: - Se ajustó el periodo de gracia y expiración del token JWT dinámico (`valid_seconds`) reduciéndolo de 60 segundos al valor estricto de seguridad de 6 segundos (por defecto `renewal_seconds + 3`). - Esto garantiza que cualquier captura de pantalla o fotografía tomada al código QR expire a los pocos segundos, siendo categóricamente rechazada por el backend si han transcurrido 10 segundos o más (`jwt.ExpiredSignatureError`). - Se priorizó la validación criptográfica estricta de JWT en `QRSecurityService.decode_and_resolve_user` con mensaje claro de advertencia al operador: *"La credencial digital ha expirado (anti-captura activo). Renueve el código en la pantalla del usuario."* ## [3.8.48] - 2026-10-28 ### Added & Fixed (Optimización de Respuestas de UdeCi, Control Óptico en Recepción y Normalización de Teclado Español) - **Fidelidad Fáctica y Listados Directos de Comisiones y Docentes en UdeCi**: - Se optimizó `LiveContextService` para inyectar la nómina completa y verídica de comisiones activas (código, asignatura, turno, docente asignado e inscriptos) ante consultas explícitas (*"qué comisiones hay"*, *"dame un listado"*, *"lista todas"*), evitando que el asistente evada la respuesta refiriendo al usuario al menú. - Se corrigió la búsqueda de docentes y comisiones en `LiveContextService`, resolviendo asignaciones reales (ej. Alejandro David Vázquez en *Gestión de sistemas de información* y *Seguridad de la Información*) y eliminando alucinaciones sobre profesores inexistentes o ficticios. - Se actualizaron las directivas del System Prompt de UdeCi reforzando la certeza de que los datos en vivo provienen 100% de la base de datos PostgreSQL institucional, prohibiendo contradicciones o falsas admisiones de datos mock ante dudas del usuario. - **Forzado Permanente del Foco en la Consola de Recepción**: - En `reception/scanner.html`, se implementó captura y forzado activo permanente del cursor en `#scannerInput` con temporizador cíclico (2s), foco inmediato al cargar y tras cada escaneo, y re-enfoque ante clics en zonas vacías de la pantalla para pistolas ópticas USB HID. - Se incorporó un indicador visual con animación de pulso (*Lector Listo*) que confirma el estado activo del cursor. - **Compatibilidad con Pistolas Ópticas en Distribución de Teclado en Español**: - Se solucionó el fallo de lectura donde los lectores ópticos configurados con emulación de teclado US traducían los dos puntos (`:`) a la letra `Ñ` en sistemas operativos en español (generando cadenas como `UNICABAÑUSRÑ144ÑDNIÑ`). - `QRSecurityService.decode_and_resolve_user` normaliza de forma bidireccional los delimitadores `Ñ` / `:` y analiza mediante expresiones regulares tanto tokens JWT como identificadores institucionales directos (`USR:`, `DNI:`), validando y autorizando inmediatamente el ingreso. - **Ruta Predeterminada y Dashboard para el Perfil de Recepción**: - Se configuró `/reception/scanner` como página de inicio y panel predeterminado para usuarios con rol `RECEPCION` en el login local, login de Moodle, autenticación de Google Workspace, impersonación, redirección de raíz `/` y `/dashboard`. - El logotipo y cabecera de la aplicación dirigen automáticamente a la consola de recepción cuando el usuario activo posee dicho rol. ## [3.8.47] - 2026-10-28 ### Fixed & UX (Depuración de Botón Redundante y Aislamiento Total de Fondo en Modal QR) - **Eliminación del Botón Redundante "Rotar Ahora"**: - Se eliminó el botón manual innecesario `btnRefreshGlobalQr` del modal de credencial (`user_qr_modal.html`), simplificando la interfaz ya que la rotación opera de manera 100% automatizada e imperceptible cada 3 segundos. - El botón "Ver Carnet Completo" ahora se presenta como acción primaria limpia y centrada. - **Aislamiento Total de Interacción y Bloqueo de Scroll de Fondo**: - Se implementó bloqueo estricto de desplazamiento en el elemento raíz `html.modal-open` y `body.modal-open` (`overflow: hidden !important; touch-action: none; overscroll-behavior: none;`). - Se añadieron trampas de eventos táctiles y de rueda del ratón (`wheel`, `touchmove`) en el contenedor del modal con `passive: false` para interceptar y prevenir cualquier fuga de desplazamiento hacia la página subyacente. - Se ajustó el `z-index` de `.modal-backdrop.show` a `1075 !important;` y `#userQrCredentialModal` a `1080 !important;`, garantizando que la cortina oscura cubra de forma impenetrable la cabecera móvil (1030), el sidebar (1060) y widgets flotantes. - Se integró el repliegue automático del menú lateral móvil (`closeMobileSidebar()`) al dispararse el evento `show.bs.modal`, previniendo solapamientos o interacciones accidentales detrás del modal. ## [3.8.46] - 2026-10-28 ### Added & Security (Rotación Dinámica de Código QR cada 3 Segundos y Configuración Global) - **Rotación Dinámica de Código QR Anti-Captura (3 Segundos)**: - Se implementó la renovación automática del código QR cada 3 segundos en el modal global (`user_qr_modal.html`), en el perfil de usuario (`profile.html`) y en la credencial completa (`card.html`). - Se incorporó una barra de progreso animada con gradiente y contador en vivo en milisegundos que exhibe visualmente la rotación activa y la protección anti-screenshot / anti-fraude. - El bucle de rotación se pausa automáticamente cuando el modal se cierra o la pestaña pasa a segundo plano (`visibilitychange`), optimizando recursos de red y CPU. - **Configuración Global Parametrizada (`SystemSetting`)**: - Se agregaron las variables de configuración `qr_renewal_interval_seconds` (por defecto: 3s) y `qr_token_grace_period_seconds` (por defecto: 60s) en backend `SystemSetting`. - Se creó una nueva pestaña en el panel de Configuración Global (`/admin/settings` -> *Credencial QR & Acceso*) con formulario de ajuste, selector de accesos directos (3s, 5s, 10s, 30s) y explicación técnica de la ventana de gracia criptográfica. - Endpoints expuestos: `POST /api/v1/settings/security-qr` y `GET /api/v1/settings/all`. - **Servicio Criptográfico `QRSecurityService` y Endpoint de Recepción**: - `QRSecurityService.generate_qr_token` ahora admite `valid_seconds`, generando un JWT firmado con identificador único (`jti`), marca temporal (`iat`) y ventana de expiración controlada por la configuración de gracia. - El endpoint `/api/v1/reception/my-qr-token` entrega en su payload el parámetro `renewal_interval_seconds` para que los clientes web ajusten su ciclo de renovación de forma dinámica. - **Suite de Pruebas Automatizadas**: - Se incorporaron pruebas unitarias y de integración en `tests/test_benefits_and_reception.py` verificando la entrega del parámetro y la actualización de los valores de configuración en caliente (118/118 pruebas superadas con éxito). ## [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 (`
`) 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 `