3.1 KiB
3.1 KiB
Tareas de Implementación SDD-013: Escáner QR por Puerto Serie (COM) en Chromium Windows
Tarea 1: Depuración de la Consola de Recepción (Sede Física y Eliminación de Cámara)
- Objetivo: Asegurar que solo se listen sedes presenciales/físicas, predeterminar Edificio Central y remover totalmente el código y librerías de escáner por cámara web.
- Archivos:
frontend/src/routes/reception.js,frontend/views/reception/scanner.html. - Hecho cuando:
- El selector
#buildingSelectsolo contiene sedes físicas (sin Campus Virtual) y tiene seleccionada la sedeEdificio Centralpor defecto. - Se eliminó la librería
html5-qrcodey el visor de cámara de la interfaz.
- El selector
Tarea 2: Módulo Cliente SerialBarcodeScanner (Web Serial API)
- Objetivo: Crear el módulo JavaScript reutilizable que encapsula la Web Serial API para lectores ópticos y pistolas serie.
- Archivos:
frontend/public/js/serial-scanner.js. - Hecho cuando:
SerialBarcodeScannerdetecta la disponibilidad denavigator.serial.- Permite solicitar y abrir un puerto COM con baudRate configurable (9600 predeterminado).
- Lee los bytes entrantes mediante
TextDecoderStreamy emite eventosonCodeScannedante delimitadores\ry\n. - Maneja la liberación de recursos (
releaseLock) y cierre seguro de puertos.
Tarea 3: Integración de UI de Puerto Serie en la Consola de Recepción
- Objetivo: Conectar
SerialBarcodeScannercon la interfaz descanner.htmly el despachador de verificación/reception/verify. - Archivos:
frontend/views/reception/scanner.html. - Hecho cuando:
- El botón "Configurar COM" abre el diálogo de selección de puertos serie de Windows en Chromium.
- El badge refleja visualmente el estado: "COM Conectado (COMx)", "Puerto USB-HID Activo" o "No Soportado".
- Las lecturas entrantes por puerto COM disparan automáticamente
verifyToken()mostrando el titular y sus clases del día sin requerir foco en el input.
Tarea 4: Resiliencia ante Desconexión y Reconexión Automática
- Objetivo: Manejar desconexiones físicas de cables USB/Serial y reabrir puertos autorizados al recargar la página.
- Archivos:
frontend/public/js/serial-scanner.js,frontend/views/reception/scanner.html. - Hecho cuando:
- El evento
navigator.serial.addEventListener('disconnect', ...)actualiza el estado a "Desconectado" limpiamente. - Al recargar la página,
navigator.serial.getPorts()reabre el puerto autorizado automáticamente si sigue conectado.
- El evento
Tarea 5: Validación Cruzada, Suite de Pruebas y Despliegue en Producción
- Objetivo: Verificar que la suite de pruebas automatizadas del backend se ejecute al 100%, realizar bump semántico de versión, commit, git push a
devy despliegue al servidor institucional LXC10.0.0.217. - Archivos:
backend/tests/,package.json,app.js,CHANGELOG.md,MEMORY.md. - Hecho cuando:
pytest tests/pasa exitosamente con 0 fallos.- La versión se incrementa a
3.8.50. - El despliegue en
10.0.0.217devuelve HTTP 200 en/version.