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
+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: Acceso Global a Credencial Digital QR y Código QR Dinámico en Perfil (v3.8.45)**:
- **Botón Global QR junto al Botón de Tema**: Incorporación del botón `.qr-credential-btn` en el footer del sidebar (`sidebar-footer`) y en la cabecera móvil (`mobile-header`), abriendo el modal `#userQrCredentialModal` para visualización y regeneración inmediata de la credencial QR del usuario.
- **Código QR Dinámico en Perfil (`/auth/profile`)**: Tarjeta destacada de Credencial Universitaria con renderizado de QR firmado, datos de DNI, rol y renovación interactiva en tiempo real.
- **Endpoint BFF `/credential/token`**: Endpoint en Express para provisión de tokens criptográficos firmados con HMAC y tiempo de validez de 72hs.
- **Versión Consolidada**: `v3.8.45`.
- **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`.
## 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.