fix(qr-modal): remove redundant rotate button and isolate background scroll and interactions (v3.8.47)

This commit is contained in:
2026-10-28 12:31:37 -03:00
parent 2d1fefa856
commit e84a236d54
8 changed files with 100 additions and 23 deletions
+11
View File
@@ -11,6 +11,17 @@ El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1
- **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. - **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. - **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción.
## [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 ## [3.8.46] - 2026-10-28
### Added & Security (Rotación Dinámica de Código QR cada 3 Segundos y Configuración Global) ### 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)**: - **Rotación Dinámica de Código QR Anti-Captura (3 Segundos)**:
+5 -5
View File
@@ -9,11 +9,11 @@ Memoria del proyecto entre sesiones para la rama `dev`.
- Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables. - Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables.
- Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación. - Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación.
- Reinicialización segura del sistema con contraseña de Administrador. - Reinicialización segura del sistema con contraseña de Administrador.
- **Sprint Activo: Rotación Dinámica de Código QR (3s) y Configuración Global (v3.8.46)**: - **Sprint Activo: Depuración de UX y Aislamiento Total de Modal QR (v3.8.47)**:
- **Rotación Dinámica de Código QR Anti-Captura (3 Segundos)**: 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 el carnet completo (`card.html`) con barra de progreso animada y contador en vivo. - **Depuración de UI**: Eliminación del botón manual redundante "Rotar Ahora" en el modal global de credencial (`user_qr_modal.html`), dejando "Ver Carnet Completo" como botón principal centrado.
- **Configuración Global Parametrizada (`SystemSetting`)**: Variables `qr_renewal_interval_seconds` (default 3s) y `qr_token_grace_period_seconds` (default 60s) configurables en el panel de Configuración Global (`/admin/settings` -> *Credencial QR & Acceso*) y respaldadas por `POST /api/v1/settings/security-qr`. - **Aislamiento de Fondo y Bloqueo de Scroll**: Reglas `html.modal-open, body.modal-open` con `overflow: hidden !important`, `overscroll-behavior: none` y `touch-action: none`. Trampas de eventos `wheel` y `touchmove` en el contenedor del modal con `passive: false` para eliminar cualquier fuga de scroll hacia el fondo.
- **Criptografía y Recepción**: `QRSecurityService.generate_qr_token` con soporte de `valid_seconds`, payload dinámico en `/api/v1/reception/my-qr-token` y 118/118 tests automatizados pasando exitosamente. - **Elevación de Z-Index y Cierre de Menú Móvil**: `.modal-backdrop.show` elevado a `1075 !important` y `#userQrCredentialModal` a `1080 !important`, cubriendo impenetrable la cabecera móvil (1030) y sidebar (1060). Despliegue de `closeMobileSidebar()` automático al abrir cualquier modal.
- **Versión Consolidada**: `v3.8.46`. - **Versión Consolidada**: `v3.8.47`.
## Decisiones (y por qué) ## Decisiones (y por qué)
- **Flujo Secuencial de Bedelía (9 Pasos)**: Estandarizar la carga operativa en: 1) Sede -> 2) Aula -> 3) Ciclo Lectivo -> 4) Carrera -> 5) Materia (vinculada a Carrera) -> 6) Comisión (asociada a Materia, Carrera y Ciclo) -> 7) Profesores -> 8) Alumnos -> 9) Reserva de Espacio. Esto asegura consistencia e integridad relacional. - **Flujo Secuencial de Bedelía (9 Pasos)**: Estandarizar la carga operativa en: 1) Sede -> 2) Aula -> 3) Ciclo Lectivo -> 4) Carrera -> 5) Materia (vinculada a Carrera) -> 6) Comisión (asociada a Materia, Carrera y Ciclo) -> 7) Profesores -> 8) Alumnos -> 9) Reserva de Espacio. Esto asegura consistencia e integridad relacional.
+1 -1
View File
@@ -7,7 +7,7 @@ from typing import Any
from database import db, get_db, engine, SessionLocal, session from database import db, get_db, engine, SessionLocal, session
from config.config import Config from config.config import Config
__version__ = "3.8.46" __version__ = "3.8.47"
class DummyContext: class DummyContext:
def __enter__(self): def __enter__(self):
+1 -1
View File
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
setup( setup(
name="edu-space-admin", name="edu-space-admin",
version="3.8.46", version="3.8.47",
description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)", description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)",
author="Edu-Space Development Team", author="Edu-Space Development Team",
author_email="admin@edu-space.com", author_email="admin@edu-space.com",
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"name": "frontend", "name": "frontend",
"version": "3.8.46", "version": "3.8.47",
"description": "", "description": "",
"main": "index.js", "main": "index.js",
"scripts": { "scripts": {
+3 -3
View File
@@ -86,9 +86,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
}); });
// Versiones institucionales del sistema // Versiones institucionales del sistema
const APP_VERSION = '3.8.46'; const APP_VERSION = '3.8.47';
const FRONTEND_VERSION = '3.8.46'; const FRONTEND_VERSION = '3.8.47';
const BACKEND_VERSION = '3.8.46'; const BACKEND_VERSION = '3.8.47';
env.addGlobal('app_version', APP_VERSION); env.addGlobal('app_version', APP_VERSION);
env.addGlobal('frontend_version', FRONTEND_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION);
+17
View File
@@ -37,6 +37,17 @@
overflow-x: hidden; overflow-x: hidden;
position: relative; position: relative;
} }
html.modal-open,
body.modal-open {
overflow: hidden !important;
height: 100% !important;
touch-action: none;
overscroll-behavior: none;
}
.modal-backdrop.show {
z-index: 1075 !important;
opacity: 0.65 !important;
}
body { body {
font-family: 'Inter', sans-serif; font-family: 'Inter', sans-serif;
min-height: 100vh; min-height: 100vh;
@@ -2235,6 +2246,12 @@
if (mobileBackdrop) mobileBackdrop.classList.remove("show"); if (mobileBackdrop) mobileBackdrop.classList.remove("show");
document.body.style.overflow = ""; document.body.style.overflow = "";
} }
window.closeMobileSidebar = closeMobileSidebar;
// Al abrir cualquier modal (ej: QR, confirmaciones), replegar el menú móvil inmediatamente
document.addEventListener("show.bs.modal", function() {
closeMobileSidebar();
});
if (mobileBtn) { if (mobileBtn) {
mobileBtn.addEventListener("click", function(e) { mobileBtn.addEventListener("click", function(e) {
+61 -12
View File
@@ -1,5 +1,24 @@
<style>
/* Asegurar aislamiento modal total e impedir scroll o clics detrás */
#userQrCredentialModal {
z-index: 1080 !important;
overscroll-behavior: contain;
}
.modal-backdrop.show {
z-index: 1075 !important;
opacity: 0.65 !important;
}
html.modal-open,
body.modal-open {
overflow: hidden !important;
height: 100% !important;
touch-action: none;
overscroll-behavior: none;
}
</style>
<!-- Modal Global de Credencial Digital QR del Usuario (UniCABA) --> <!-- Modal Global de Credencial Digital QR del Usuario (UniCABA) -->
<div class="modal fade" id="userQrCredentialModal" tabindex="-1" aria-labelledby="userQrCredentialModalLabel" aria-hidden="true"> <div class="modal fade" id="userQrCredentialModal" tabindex="-1" aria-labelledby="userQrCredentialModalLabel" aria-hidden="true" data-bs-backdrop="true" data-bs-keyboard="true">
<div class="modal-dialog modal-dialog-centered" style="max-width: 440px;"> <div class="modal-dialog modal-dialog-centered" style="max-width: 440px;">
<div class="modal-content border-0 shadow-lg overflow-hidden" style="border-radius: 18px;"> <div class="modal-content border-0 shadow-lg overflow-hidden" style="border-radius: 18px;">
<!-- Encabezado con estética de Carnet Universitario --> <!-- Encabezado con estética de Carnet Universitario -->
@@ -78,16 +97,11 @@
</div> </div>
</div> </div>
<!-- Botones de Acción --> <!-- Botón de Acción -->
<div class="d-grid gap-2"> <div class="d-grid">
<div class="btn-group"> <a href="/credential/my-card" class="btn btn-primary py-2 rounded-3 shadow-xs d-flex align-items-center justify-content-center">
<button type="button" class="btn btn-outline-secondary btn-sm py-2" onclick="refreshGlobalQrModal()" id="btnRefreshGlobalQr"> <i class="bi bi-person-badge me-2"></i>Ver Carnet Completo
<i class="bi bi-arrow-clockwise me-1" id="globalRefreshQrIcon"></i>Rotar Ahora </a>
</button>
<a href="/credential/my-card" class="btn btn-primary btn-sm py-2">
<i class="bi bi-person-badge me-1"></i>Ver Carnet Completo
</a>
</div>
</div> </div>
</div> </div>
@@ -243,10 +257,45 @@
document.addEventListener('DOMContentLoaded', function() { document.addEventListener('DOMContentLoaded', function() {
var modalEl = document.getElementById('userQrCredentialModal'); var modalEl = document.getElementById('userQrCredentialModal');
if (modalEl) { if (modalEl) {
// Impedir que eventos de scroll de rueda o táctiles se propaguen a la página de fondo
modalEl.addEventListener('wheel', function(e) {
if (e.target === modalEl) {
e.preventDefault();
}
}, { passive: false });
modalEl.addEventListener('touchmove', function(e) {
if (e.target === modalEl) {
e.preventDefault();
}
}, { passive: false });
modalEl.addEventListener('show.bs.modal', function() { modalEl.addEventListener('show.bs.modal', function() {
// Bloqueo total de scroll en el elemento raíz (html) y cuerpo (body)
document.documentElement.classList.add('modal-open');
document.body.classList.add('modal-open');
document.documentElement.style.overflow = 'hidden';
document.body.style.overflow = 'hidden';
// Si el sidebar móvil estuviera desplegado, cerrarlo para evitar solapamientos
if (typeof window.closeMobileSidebar === 'function') {
window.closeMobileSidebar();
} else {
var sb = document.querySelector('.sidebar.mobile-open');
if (sb) sb.classList.remove('mobile-open');
var bd = document.getElementById('sidebarBackdrop');
if (bd) bd.classList.remove('show');
}
startAutoRefreshLoop(); startAutoRefreshLoop();
}); });
modalEl.addEventListener('hide.bs.modal', function() {
modalEl.addEventListener('hidden.bs.modal', function() {
// Restaurar scroll de página
document.documentElement.classList.remove('modal-open');
document.body.classList.remove('modal-open');
document.documentElement.style.overflow = '';
document.body.style.overflow = '';
stopAutoRefreshLoop(); stopAutoRefreshLoop();
}); });
} }