Files

58 lines
4.4 KiB
Markdown

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