feat(qr): add 3-second dynamic QR auto-rotation and global settings configuration (v3.8.46)

This commit is contained in:
2026-10-28 08:11:45 -03:00
parent 54c221e20e
commit 2d1fefa856
16 changed files with 600 additions and 64 deletions
@@ -93,6 +93,11 @@
<i class="bi bi-cpu me-2 text-success"></i>Asistente IA &amp; LLM Local
</button>
</li>
<li class="nav-item" role="presentation">
<button class="nav-link" id="tab-security-qr-btn" data-bs-toggle="tab" data-bs-target="#tab-security-qr" type="button" role="tab">
<i class="bi bi-qr-code me-2 text-warning"></i>Credencial QR &amp; Acceso
</button>
</li>
<li class="nav-item" role="presentation">
<button class="nav-link text-danger" id="tab-maintenance-btn" data-bs-toggle="tab" data-bs-target="#tab-maintenance" type="button" role="tab">
<i class="bi bi-radioactive me-2 text-danger"></i>Mantenimiento &amp; Reinicio
@@ -718,7 +723,92 @@
</div>
<!-- ========================================== -->
<!-- PESTAÑA 6: MANTENIMIENTO & REINICIO -->
<!-- PESTAÑA 6: CREDENCIAL QR & ACCESO (SDD-012)-->
<!-- ========================================== -->
<div class="tab-pane fade" id="tab-security-qr" role="tabpanel">
<div class="row g-4">
<div class="col-lg-8">
<form id="securityQrForm" onsubmit="saveSecurityQrConfig(event)">
<div class="card border shadow-none bg-body-tertiary p-3 mb-4 rounded-3">
<h6 class="fw-bold mb-3 d-flex align-items-center">
<i class="bi bi-shield-lock-fill text-warning me-2"></i>Rotación Dinámica de Código QR Anti-Captura
</h6>
<div class="mb-4">
<label class="form-label small fw-semibold text-body" for="qr_renewal_interval_seconds">
Tiempo de Renovación del Código QR en Pantalla (Segundos)
</label>
<div class="input-group input-group-sm mb-2" style="max-width: 260px;">
<span class="input-group-text"><i class="bi bi-stopwatch"></i></span>
<input type="number" class="form-control font-monospace text-center fw-bold" id="qr_renewal_interval_seconds" name="renewal_interval_seconds"
min="1" max="300" step="1"
value="{{ settings.security_qr.renewal_interval_seconds if (settings and settings.security_qr and settings.security_qr.renewal_interval_seconds) else 3 }}" required>
<span class="input-group-text">segundos</span>
</div>
<div class="d-flex gap-2 flex-wrap mb-2">
<button type="button" class="btn btn-xs btn-outline-secondary py-1 px-2 small" onclick="setQrIntervalPreset(3)">
<i class="bi bi-lightning-charge text-warning me-1"></i>3 seg (Predeterminado)
</button>
<button type="button" class="btn btn-xs btn-outline-secondary py-1 px-2 small" onclick="setQrIntervalPreset(5)">
5 seg
</button>
<button type="button" class="btn btn-xs btn-outline-secondary py-1 px-2 small" onclick="setQrIntervalPreset(10)">
10 seg
</button>
<button type="button" class="btn btn-xs btn-outline-secondary py-1 px-2 small" onclick="setQrIntervalPreset(30)">
30 seg
</button>
</div>
<div class="text-muted small">
Frecuencia con la que la aplicación regenera la imagen del QR y su token criptográfico firmado en el modal del usuario, carnet y perfil.
Un valor de <strong>3 segundos</strong> garantiza máxima seguridad anti-screenshot / anti-captura para evitar que los estudiantes se presten accesos.
</div>
</div>
<hr class="opacity-25 my-3">
<div class="mb-3">
<label class="form-label small fw-semibold text-body" for="qr_token_grace_period_seconds">
Ventana de Gracia / Validez de Lectura del Token (Segundos)
</label>
<div class="input-group input-group-sm mb-2" style="max-width: 260px;">
<span class="input-group-text"><i class="bi bi-hourglass-split"></i></span>
<input type="number" class="form-control font-monospace text-center fw-bold" id="qr_token_grace_period_seconds" name="grace_period_seconds"
min="5" max="3600" step="5"
value="{{ settings.security_qr.grace_period_seconds if (settings and settings.security_qr and settings.security_qr.grace_period_seconds) else 60 }}" required>
<span class="input-group-text">segundos</span>
</div>
<div class="text-muted small">
Tiempo durante el cual el escáner de Recepción aceptará como válido un token QR recién generado (tolerancia a latencia de red, enfoque de cámara y lectura en torniquetes). Se recomienda entre 30 y 120 segundos.
</div>
</div>
</div>
<div class="d-flex justify-content-end">
<button type="submit" class="btn btn-primary btn-sm px-4" id="btnSaveSecurityQr">
<i class="bi bi-check2-circle me-1"></i>Guardar Configuración de Credencial QR
</button>
</div>
</form>
</div>
<!-- Panel de Consejos / UX & Seguridad -->
<div class="col-lg-4">
<div class="card border-0 bg-warning-subtle text-warning-emphasis p-3 rounded-3 mb-3">
<h6 class="fw-bold mb-2"><i class="bi bi-shield-check me-1"></i>Credencial Dinámica Anti-Fraude</h6>
<p class="small mb-2">
Al renovar el código cada 3 segundos, las capturas de pantalla tomadas por alumnos quedan invalidadas en los puntos de acceso físico.
</p>
<p class="small mb-0">
Cada rotación genera un JWT con identificador único (JTI) y marca de tiempo firmada, garantizando trazabilidad y seguridad institucional.
</p>
</div>
</div>
</div>
</div>
<!-- ========================================== -->
<!-- PESTAÑA 7: MANTENIMIENTO & REINICIO -->
<!-- ========================================== -->
<div class="tab-pane fade" id="tab-maintenance" role="tabpanel">
<div class="row g-4">
@@ -1500,6 +1590,57 @@ async function testAiConnection() {
}
}
// -------------------------------------------------------------
// Configuración de Credenciales QR Dinámicas y Rotación (SDD-012)
// -------------------------------------------------------------
function setQrIntervalPreset(sec) {
const input = document.getElementById('qr_renewal_interval_seconds');
if (input) input.value = sec;
}
async function saveSecurityQrConfig(e) {
e.preventDefault();
const btn = document.getElementById('btnSaveSecurityQr');
const renewalInput = document.getElementById('qr_renewal_interval_seconds');
const graceInput = document.getElementById('qr_token_grace_period_seconds');
btn.disabled = true;
btn.innerHTML = '<span class="spinner-border spinner-border-sm me-1"></span>Guardando...';
const payload = {
renewal_interval_seconds: parseInt(renewalInput.value, 10) || 3,
grace_period_seconds: parseInt(graceInput.value, 10) || 60
};
try {
let res = await fetch('/admin/settings/security-qr', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(payload)
});
if (!res.ok && res.status === 404) {
res = await fetch('/api/v1/admin/settings/security-qr', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(payload)
});
}
const data = await res.json();
if (res.ok) {
showAlert(data.message || 'Configuración de credenciales QR guardada exitosamente.', 'success');
} else {
showAlert(data.message || 'Error al guardar configuración de QR.', 'danger');
}
} catch (err) {
showAlert('Error de comunicación: ' + err.message, 'danger');
} finally {
btn.disabled = false;
btn.innerHTML = '<i class="bi bi-check2-circle me-1"></i>Guardar Configuración de Credencial QR';
}
}
// -------------------------------------------------------------
// Reinicialización Total del Sistema (Requiere Contraseña Admin)
// -------------------------------------------------------------