feat(reception): filter virtual buildings, remove camera and add SDD-013 Web Serial COM support (v3.8.50)
This commit is contained in:
@@ -0,0 +1,40 @@
|
||||
# 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`.
|
||||
Reference in New Issue
Block a user