5.8 KiB
5.8 KiB
Desglose de Tareas: Portal de Beneficios, Convenios y Control de Acceso QR (SDD-012)
Tareas de Implementación
-
Tarea 1: Modelos de Persistencia SQLAlchemy (
InstitutionalBenefityAccessLogQR)- Estimación: 25 min
- Acciones:
- Crear
backend/models/institutional_benefit.pycon campos de título, comercio, categoría, descuento, términos, roles objetivo, fechas de vigencia y switch de estado activo. - Crear
backend/models/access_log_qr.pypara trazabilidad de ingresos escaneados por sede y personal de recepción. - Importar y registrar los modelos en
backend/models/__init__.py.
- Crear
- Hecho cuando: Las tablas se crean correctamente en PostgreSQL/SQLite sin errores de clave foránea ni regresiones de inicialización.
-
Tarea 2: DTOs Pydantic v2 y Endpoints RESTful de Beneficios (
routers/benefits.py)- Estimación: 30 min
- Acciones:
- Crear
backend/schemas/benefit_dto.pycon validaciones de campos (min_length, fechas, roles). - Crear
backend/routers/benefits.pycon operaciones CRUD (GET /,GET /{id},POST /,PUT /{id},PATCH /{id}/toggle-status,DELETE /{id}). - Proteger rutas de escritura exigiendo roles
ADMINoBEDELIA. - Registrar el router en
backend/main.py.
- Crear
- Hecho cuando: Peticiones a
/api/v1/benefitsresponden con códigos HTTP semánticos (200, 201, 204, 403, 404, 422) y aparecen en OpenAPI Swagger UI (/docs).
-
Tarea 3: Servicio de Seguridad QR y Endpoints de Recepción (
routers/reception.py)- Estimación: 30 min
- Acciones:
- Crear
backend/app/services/qr_security_service.pypara generar y verificar tokens de credencial firmados con HMAC-SHA256 institucional. - Crear
backend/schemas/reception_dto.pypara los contratos de verificación de acceso. - Crear
backend/routers/reception.pycon/api/v1/reception/verify-qry/api/v1/reception/recent-logs. - Integrar la búsqueda de clases presenciales del día para mostrar el aula y piso asignado al momento de ingresar.
- Registrar el router en
backend/main.py.
- Crear
- Hecho cuando: Un escaneo de QR válido responde con
status: AUTORIZADO, datos del alumno y sus aulas asignadas del día en < 300 ms.
-
Tarea 4: Integración de Convenios en el Motor Conversacional de UdeCi
- Estimación: 20 min
- Acciones:
- Modificar
backend/app/services/live_context_service.pypara inyectar los convenios vigentes en el contexto en vivo de UdeCi. - Actualizar las reglas del System Prompt en
backend/routers/ai_chat.pypara responder consultas sobre descuentos en cafeterías, librerías y beneficios institucionales reales.
- Modificar
- Hecho cuando: Al consultar a UdeCi "¿Qué descuentos hay en cafetería?", responde citando comercios, porcentaje y condiciones reales de la base de datos.
-
Tarea 5: Panel de Gestión de Convenios para Bedelía y Admin (Frontend BFF)
- Estimación: 30 min
- Acciones:
- Crear controlador
frontend/src/routes/benefits.jsy vistafrontend/views/benefits/manage.html. - Implementar tabla de convenios con badges de categoría, switches de activación rápida y modal de alta/edición.
- Incorporar el enlace en el menú lateral de Bedelía y Administración (
sidebar.html).
- Crear controlador
- Hecho cuando: Bedelía puede dar de alta un convenio con descuento, fechas y sede desde la interfaz web con feedback visual inmediato.
-
Tarea 6: Catálogo de Beneficios y Credencial Digital QR para Alumnos y Docentes
- Estimación: 30 min
- Acciones:
- Crear vista
frontend/views/benefits/catalog.htmlcon tarjetas estilo marketplace, buscador interactivo y filtro por categoría (Cafetería, Librería, etc.). - Crear vista
frontend/views/credential/card.html("Mi Credencial Digital") mostrando foto, datos institucionales y código QR dinámico. - Añadir accesos en el menú de Estudiante y Docente.
- Crear vista
- Hecho cuando: Un estudiante puede explorar los convenios vigentes, abrir el cupón y visualizar su Credencial QR en su teléfono.
-
Tarea 7: Consola de Escáner de Recepción y Control de Acceso en Vivo
- Estimación: 30 min
- Acciones:
- Crear vista
frontend/views/reception/scanner.htmlcon lector de cámara (html5-qrcode) y soporte para pistola de código de barras USB. - Integrar modal/tarjeta de validación instantánea con indicadores visuales (verde/rojo) y cronograma de clases de hoy con sede, aula y piso.
- Configurar permisos en el BFF para el rol
RECEPCIONy administradores.
- Crear vista
- Hecho cuando: Al escanear un QR con la cámara, la pantalla muestra de inmediato la foto, el estado de matrícula y el aula donde cursa hoy.
-
Tarea 8: Suite de Pruebas Automatizadas Backend y Cobertura E2E
- Estimación: 20 min
- Acciones:
- Crear
backend/tests/test_benefits_and_reception.pycubriendo:- CRUD de beneficios y restricciones de roles.
- Validación de vigencia de fechas.
- Generación y verificación de tokens QR.
- Registro de logs de acceso.
- Respuestas de UdeCi sobre beneficios en vivo.
- Ejecutar
pytest tests/ -vasegurando 100% de tests pasando.
- Crear
- Hecho cuando: Todos los tests de la suite pasan exitosamente sin fallos ni warnings no controlados.
-
Tarea 9: Bump de Versión, Git Push y Despliegue Continuo en Producción (LXC 10.0.0.217)
- Estimación: 20 min
- Acciones:
- Incrementar versión semántica en
package.json,app.js,__init__.py,setup.py,CHANGELOG.mdyMEMORY.md. - Ejecutar
git push origin dev. - Desplegar en el contenedor de producción (
10.0.0.217) y validar HTTP 200 en/version.
- Incrementar versión semántica en
- Hecho cuando: Producción corre la nueva versión con los módulos de beneficios y recepción operativos.