feat(benefits-reception): add institutional benefits, QR digital card & reception access control (SDD-012 v3.8.39)

This commit is contained in:
2026-10-27 23:34:57 -03:00
parent e45eb972dd
commit e5e6bfa094
30 changed files with 2994 additions and 11 deletions
+14
View File
@@ -11,6 +11,20 @@ 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.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`)**: