# 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`. ## Tarea 6: Módulo y Pruebas de DNI Argentino (Formatos 2009, 2012, 2026 y Mi Argentina) - **Objetivo**: Implementar `argentine_dni_parser.py` e integrarlo en `qr_security_service.py` con pruebas unitarias en `test_dni_parser.py` para todos los ejemplos provistos. - **Archivos**: `backend/app/services/argentine_dni_parser.py`, `backend/app/services/qr_security_service.py`, `backend/tests/test_dni_parser.py`. - **Hecho cuando**: - Todos los formatos de ejemplo son procesados y extraen correctamente DNI numérico, apellido, nombre y sexo. - Al escanear un DNI de alumno/docente existente en base de datos, `decode_and_resolve_user` resuelve el usuario y sus clases. - `pytest tests/test_dni_parser.py` pasa al 100% (verde). ## Tarea 7: Soporte Multi-Lector Serial COM (Hasta 4 Lectores Simultáneos) - **Objetivo**: Extender `serial-scanner.js` con `MultiSerialBarcodeScanner` y diseñar la UI de gestión de 4 terminales en `scanner.html`. - **Archivos**: `frontend/public/js/serial-scanner.js`, `frontend/views/reception/scanner.html`. - **Hecho cuando**: - Se pueden conectar y monitorear hasta 4 lectores seriales COM en paralelo. - Cada ranura muestra su estado individual (Conectado / Desconectado) y baudrate. - Los escaneos desde cualquiera de los 4 lectores se canalizan automáticamente hacia la verificación sin bloquear la interfaz.