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.
- **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
### 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)**:
+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.
- 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.
- **Sprint Activo: Rotación Dinámica de Código QR (3s) y Configuración Global (v3.8.46)**:
- **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.
- **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`.
- **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.
- **Versión Consolidada**: `v3.8.46`.
- **Sprint Activo: Depuración de UX y Aislamiento Total de Modal QR (v3.8.47)**:
- **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.
- **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.
- **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.47`.
## 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.
+1 -1
View File
@@ -7,7 +7,7 @@ from typing import Any
from database import db, get_db, engine, SessionLocal, session
from config.config import Config
__version__ = "3.8.46"
__version__ = "3.8.47"
class DummyContext:
def __enter__(self):
+1 -1
View File
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
setup(
name="edu-space-admin",
version="3.8.46",
version="3.8.47",
description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)",
author="Edu-Space Development Team",
author_email="admin@edu-space.com",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "frontend",
"version": "3.8.46",
"version": "3.8.47",
"description": "",
"main": "index.js",
"scripts": {
+3 -3
View File
@@ -86,9 +86,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
});
// Versiones institucionales del sistema
const APP_VERSION = '3.8.46';
const FRONTEND_VERSION = '3.8.46';
const BACKEND_VERSION = '3.8.46';
const APP_VERSION = '3.8.47';
const FRONTEND_VERSION = '3.8.47';
const BACKEND_VERSION = '3.8.47';
env.addGlobal('app_version', APP_VERSION);
env.addGlobal('frontend_version', FRONTEND_VERSION);
+17
View File
@@ -37,6 +37,17 @@
overflow-x: hidden;
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 {
font-family: 'Inter', sans-serif;
min-height: 100vh;
@@ -2235,6 +2246,12 @@
if (mobileBackdrop) mobileBackdrop.classList.remove("show");
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) {
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) -->
<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-content border-0 shadow-lg overflow-hidden" style="border-radius: 18px;">
<!-- Encabezado con estética de Carnet Universitario -->
@@ -78,16 +97,11 @@
</div>
</div>
<!-- Botones de Acción -->
<div class="d-grid gap-2">
<div class="btn-group">
<button type="button" class="btn btn-outline-secondary btn-sm py-2" onclick="refreshGlobalQrModal()" id="btnRefreshGlobalQr">
<i class="bi bi-arrow-clockwise me-1" id="globalRefreshQrIcon"></i>Rotar Ahora
</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>
<!-- Botón de Acción -->
<div class="d-grid">
<a href="/credential/my-card" class="btn btn-primary py-2 rounded-3 shadow-xs d-flex align-items-center justify-content-center">
<i class="bi bi-person-badge me-2"></i>Ver Carnet Completo
</a>
</div>
</div>
@@ -243,10 +257,45 @@
document.addEventListener('DOMContentLoaded', function() {
var modalEl = document.getElementById('userQrCredentialModal');
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() {
// 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();
});
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();
});
}