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
+5 -4
View File
@@ -9,10 +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: Resiliencia de Respuestas y Corrección DTO de UdeCi — SDD-011 (v3.8.38)**:
- **Corrección de Mapeo de Atributos DTO**: Se corrigió el desacople de nombres de campo entre el frontend (`ai-chat-widget.js`) y el backend (`ChatResponse`), asegurando que las respuestas factualmente válidas del motor de IA (`response`, `quick_options`) se muestren fluidamente y no caigan en el texto de fallo por defecto.
- **Dual DTO & Spotlight Integration**: Soporte en backend de alias `reply` y `options`, e integración de `guide_step` con `WalkthroughEngine.startStep()`.
- **Versión Consolidada**: `v3.8.38`.
- **Sprint Activo: Club de Beneficios, Convenios Institucionales y Control de Acceso QR / Recepción — SDD-012 (v3.8.39)**:
- **Club de Beneficios y Convenios**: ABM completo para Bedelía/Admin (`/benefits/manage`), catálogo visual estilo marketplace para Alumnos/Docentes (`/benefits`), y valor agregado con IA donde UdeCi cita en tiempo real convenios vigentes desde la base de datos relacional (`LiveContextService`).
- **Recepción y Control de Acceso QR**: Rol `RECEPCION`, consola de escaneo de alta velocidad (`/reception/scanner`) con soporte de cámara web y lector de código de barras USB. Verificación de credencial con alerta visual de matrícula e indicación inmediata del aula física, piso y horario asignado al alumno/docente en el día.
- **Credencial Digital**: Vista de tarjeta institucional (`/credential/my-card`) con token QR dinámico criptográficamente firmado (`credential_qr`).
- **Versión Consolidada**: `v3.8.39`.
## 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.