Files
admin-edu-space/specs/013-escaner-qr-puerto-com-serial/tasks.md
T

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 #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.