# 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 `#buildingSelect` solo contiene sedes físicas (sin Campus Virtual) y tiene seleccionada la sede `Edificio Central` por defecto. - Se eliminó la librería `html5-qrcode` y el visor de cámara de la interfaz. ## 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**: - `SerialBarcodeScanner` detecta la disponibilidad de `navigator.serial`. - Permite solicitar y abrir un puerto COM con baudRate configurable (9600 predeterminado). - Lee los bytes entrantes mediante `TextDecoderStream` y emite eventos `onCodeScanned` ante delimitadores `\r` y `\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 `SerialBarcodeScanner` con la interfaz de `scanner.html` y 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. ## 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 `dev` y despliegue al servidor institucional LXC `10.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.217` devuelve HTTP 200 en `/version`.