feat(reception): add multi-serial scanner for up to 4 COM ports and universal Argentine DNI parser (v3.8.52)

This commit is contained in:
2026-10-28 14:47:54 -03:00
parent 1477780df0
commit 19495e96b4
14 changed files with 806 additions and 183 deletions
+21
View File
@@ -11,6 +11,27 @@ El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1
- **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1.
- **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción.
## [3.8.52] - 2026-10-28
### Added & Enhanced (Soporte Multi-Lector de hasta 4 Puertos COM y Reconocimiento Universal de DNI Argentino)
- **Soporte Multi-Lector Serie COM (Hasta 4 Lectores Simultáneos)**:
- Se extendió el motor de lectura serie a la clase `MultiSerialBarcodeScanner` en `frontend/public/js/serial-scanner.js`, administrando 4 ranuras de hardware independientes (`Lector 1 (Paso Principal)`, `Lector 2 (Molinete / Acceso)`, `Lector 3 (Mesa Bedelía)`, `Lector 4 (Auxiliar / Puesto 2)`).
- Cada ranura dispone de control individual de apertura (`requestPort`), configuración de velocidad en baudios (9600 predeterminado / 115200), LED indicador con pulso en vivo (`bg-success`), botón conectar/desconectar y reconexión automática en bloque con `reconnectAuthorizedComPorts()`.
- La interfaz de recepción destaca visualmente la ranura que originó cada escaneo (`flashSlotCard`) y notifica en el badge flotante la terminal emisora (ej: `¡Nuevo Escaneo! Lector 2 (Molinete)`).
- **Módulo de Reconocimiento y Parseo de DNI Argentino (`argentine_dni_parser.py`)**:
- Implementación del algoritmo oficial de extracción y normalización de documentos de identidad argentinos para códigos de barras PDF417 y QR emitidos por Renaper y la App Mi Argentina:
- *Formato 2026*: DNI en posición 3 con ejemplar alfabético (`00749743816"TELLO"CARLOS FACUNDO"34247025"G"...`).
- *Formato 2009 con comilla inicial*: Posición fija de documento, apellido, nombre y sexo (`"20979166 "A"1"CASTIGLIONI"...`).
- *Formato 2009 con prefijos de género antiguos*: Manejo de prefijos `F` / `M` (`"f5592570 "A"1"SAUCEDO"...` ➔ DNI `5592570`).
- *Formato App Mi Argentina*: Con sexo numérico `1=M`, `2=F`, `3=X` y DNI numérico (`305336518"CIRILLI"...` / `680051210"TELLO"...`).
- *Formato 2012*: Sexo en posición 3 y DNI en posición 4 (`00225303383"RIO"MARTINA"F"46585482"...`).
- *Tolerancia de delimitadores*: Compatibilidad idéntica con delimitadores de comilla doble (`"`) y arroba (`@`).
- **Integración Académica en Tiempo Real en `QRSecurityService`**:
- Al escanear un DNI físico o credencial digital Renaper, el backend extrae el número de documento y busca de forma transparente al alumno, docente o bedel en el padrón (`document_number`, `username` o `email`).
- Si el usuario existe, se validan sus permisos y se computan sus clases del día en la sede física.
- Si no existe en la base de datos de UniCABA, el sistema responde informando claramente los datos leídos del documento físico (ej: *"DNI argentino 34247025 (TELLO CARLOS FACUNDO) no se encuentra registrado en el padrón de UniCABA"*).
- **Suite de Pruebas Automatizadas**:
- Se añadieron 9 pruebas unitarias en `backend/tests/test_dni_parser.py` validando todos los formatos y ejemplos provistos, alcanzando 17/17 pruebas superadas en el backend.
## [3.8.51] - 2026-10-28
### Added & Improved (Alerta Visual Ámbar sin Clases Hoy e Interacciones de Detección de Nuevo Escaneo en Recepción)
- **Diferenciación Cromática por Cursada del Día (`/reception/scanner`)**: