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. - **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. - **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 ## [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) ### 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`)**: - **Diferenciación Cromática por Cursada del Día (`/reception/scanner`)**:
+5 -5
View File
@@ -9,12 +9,12 @@ Memoria del proyecto entre sesiones para la rama `dev`.
- Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables. - Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables.
- Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación. - Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación.
- Reinicialización segura del sistema con contraseña de Administrador. - Reinicialización segura del sistema con contraseña de Administrador.
- **Sprint Activo: Consola de Recepción Presencial, Alertas de Cursada y Puerto Serie (v3.8.51)**: - **Sprint Activo: Multi-Lector Serial (4 COM) y Reconocimiento de DNI Argentino (v3.8.52)**:
- **Sede Física Exclusiva y Edificio Central Predeterminado**: Filtrado total de sedes virtuales en `/reception/scanner`. Edificio Central fijado como sede predeterminada de control de acceso. - **Soporte Multi-Lector Serial (Hasta 4 Lectores COM)**: Motor `MultiSerialBarcodeScanner` administrando 4 ranuras independientes (Paso Principal, Molinete, Mesa Bedelía, Auxiliar) con LEDs de conexión, selección de baudios y reconexión automática en bloque vía Web Serial API (`navigator.serial`) en Chromium Windows.
- **Reconocimiento y Parseo de DNI Argentino (`argentine_dni_parser.py`)**: Soporte exhaustivo para escaneo de PDF417 y QR de Renaper / Mi Argentina (Formatos 2009 con/sin comilla, 2012, 2026, prefijos F/M y delimitadores `@` / `"`), resolviendo automáticamente el usuario y sus clases del día por DNI.
- **Diferenciación Cromática por Cursada**: Alumnos con cursada hoy se despliegan en verde esmeralda con badge "Tiene Cursada". Alumnos regulares sin clases hoy se destacan en cuadro de advertencia ámbar/amarillo cálido (`#FFFDF5`), badge "Sin Cursada Hoy" y banner explicativo con icono de calendario tachado. - **Diferenciación Cromática por Cursada**: Alumnos con cursada hoy se despliegan en verde esmeralda con badge "Tiene Cursada". Alumnos regulares sin clases hoy se destacan en cuadro de advertencia ámbar/amarillo cálido (`#FFFDF5`), badge "Sin Cursada Hoy" y banner explicativo con icono de calendario tachado.
- **Interacciones de Detección de Nuevo Escaneo**: Resplandor dinámico visual en el contenedor (`animate-scan-*`), badge flotante de alerta `¡Nuevo Escaneo Registrado!` y tonos auditivos diferenciados vía Web Audio API (doble agudo para cursada asignada, tono medio suave para regular sin cursada, y grave de alerta para accesos no autorizados). - **Interacciones de Detección de Nuevo Escaneo**: Resplandor dinámico visual en el contenedor (`animate-scan-*`), badge flotante de alerta `¡Nuevo Escaneo Registrado!` y tonos auditivos diferenciados vía Web Audio API.
- **Especificación e Integración SDD-013 (Web Serial COM en Chromium/Windows)**: Especificación formal completa en `specs/013-escaner-qr-puerto-com-serial/` y módulo `serial-scanner.js` para captura directa asíncrona desde puertos COM (`navigator.serial`) sin requerir foco en el cursor. - **Versión Consolidada**: `v3.8.52`.
- **Versión Consolidada**: `v3.8.51`.
## Decisiones (y por qué) ## Decisiones (y por qué)
- **Flujo Secuencial de Bedelía (9 Pasos)**: Estandarizar la carga operativa en: 1) Sede -> 2) Aula -> 3) Ciclo Lectivo -> 4) Carrera -> 5) Materia (vinculada a Carrera) -> 6) Comisión (asociada a Materia, Carrera y Ciclo) -> 7) Profesores -> 8) Alumnos -> 9) Reserva de Espacio. Esto asegura consistencia e integridad relacional. - **Flujo Secuencial de Bedelía (9 Pasos)**: Estandarizar la carga operativa en: 1) Sede -> 2) Aula -> 3) Ciclo Lectivo -> 4) Carrera -> 5) Materia (vinculada a Carrera) -> 6) Comisión (asociada a Materia, Carrera y Ciclo) -> 7) Profesores -> 8) Alumnos -> 9) Reserva de Espacio. Esto asegura consistencia e integridad relacional.
+1 -1
View File
@@ -7,7 +7,7 @@ from typing import Any
from database import db, get_db, engine, SessionLocal, session from database import db, get_db, engine, SessionLocal, session
from config.config import Config from config.config import Config
__version__ = "3.8.51" __version__ = "3.8.52"
class DummyContext: class DummyContext:
def __enter__(self): def __enter__(self):
@@ -0,0 +1,166 @@
import re
from typing import Tuple, Optional, Dict
def limpiar_numero_documento(doc_raw: str) -> Tuple[str, Optional[str]]:
"""
Limpia y normaliza un número de documento DNI argentino.
En formatos antiguos (Libreta Cívica, Libreta de Enrolamiento o Formato 2009),
el documento suele estar precedido por 'F' (Femenino) o 'M' (Masculino),
por ejemplo: 'F5592570' -> ('5592570', 'F'), 'M34247025' -> ('34247025', 'M').
Retorna (documento_numerico, sexo_inferido).
"""
if not doc_raw:
return "", None
doc_clean = str(doc_raw).strip()
doc_sin_puntos = doc_clean.replace('.', '').replace(',', '').replace(' ', '')
# Patrón: Prefijo F o M seguido de 5 a 9 dígitos
m = re.match(r'^([FMfm])(\d{5,9})$', doc_sin_puntos)
if m:
return m.group(2), m.group(1).upper()
# Si contiene dígitos precedidos por F/M con posibles espacios o puntos
m2 = re.match(r'^([FMfm])[\s\.]*(\d{5,9})$', doc_clean)
if m2:
return m2.group(2), m2.group(1).upper()
return doc_sin_puntos if doc_sin_puntos.isdigit() else doc_clean, None
def parsear_dni(raw_text: str) -> Dict[str, str]:
"""
Parsea la cadena de texto cruda obtenida de un escáner de código de barras/QR de un DNI argentino.
Soporta los formatos 2009, 2012, 2026 y App Mi Argentina.
Retorna un diccionario con las llaves: 'documento', 'apellido', 'nombre', 'sexo'
o un diccionario vacío si no corresponde a un documento de identidad argentino.
"""
if not raw_text:
return {}
# Limpiar terminadores y retornos de carro
raw_clean = str(raw_text).strip().replace('\r', '').replace('\n', '')
# Algunos escáneres o formatos vienen separados por @ en lugar de comillas dobles
text = raw_clean.replace('@', '"')
parts = text.split('"')
# Limpiar espacios de cada segmento
parts = [p.strip() for p in parts]
if len(parts) < 5:
# Si es un ingreso directo de DNI (escaneado de tarjeta de código de barras 1D o tipeado)
doc_limpio, sexo_inf = limpiar_numero_documento(raw_clean)
if doc_limpio and doc_limpio.isdigit() and 5 <= len(doc_limpio) <= 9:
return {
"documento": doc_limpio,
"apellido": "",
"nombre": "",
"sexo": sexo_inf or "M"
}
return {}
doc = nombre = apellido = sexo = ""
# Heurística para Formato 2009 con comilla inicial
# Ej: "34247025"A"1"TELLO"CARLOS FACUNDO"...
# Ej: "F5592570 "A"1"SAUCEDO"TERESA DE JESUS"...
if parts[0] == '' and 6 <= len(parts[1]) <= 11 and len(parts) > 2 and parts[2].isalpha() and len(parts[2]) == 1:
doc = parts[1]
if len(parts) > 4:
apellido = parts[4]
if len(parts) > 5:
nombre = parts[5]
# Búsqueda de sexo en posiciones subsiguientes (índices 6 a 9)
for idx in range(6, min(len(parts), 10)):
val = parts[idx].upper()
if val in ("M", "F", "X"):
sexo = val
break
# Heurística para Formato 2009 sin comilla inicial
# Ej: 34247025"A"1"TELLO"CARLOS FACUNDO...
# Ej: F5592570"A"1"SAUCEDO"TERESA DE JESUS...
elif 6 <= len(parts[0]) <= 11 and len(parts) > 4 and parts[1].isalpha() and len(parts[1]) == 1:
doc = parts[0]
apellido = parts[3]
nombre = parts[4]
for idx in range(5, min(len(parts), 9)):
val = parts[idx].upper()
if val in ("M", "F", "X"):
sexo = val
break
# Heurística para Formatos 2012, 2026 y App Mi Argentina (Comienzan con número de trámite >= 8 dígitos)
else:
# Si la cadena comenzó con comilla/arroba y no es formato 2009, normalizamos descartando el elemento vacío inicial
if parts[0] == '' and len(parts) > 1:
parts = parts[1:]
if parts[0].isdigit() and len(parts[0]) >= 8:
apellido = parts[1] if len(parts) > 1 else ""
nombre = parts[2] if len(parts) > 2 else ""
if len(parts) > 3:
p3 = parts[3].strip()
p4 = parts[4].strip() if len(parts) > 4 else ""
# Caso 1: Formato 2012 (parts[3] es letra de sexo M, F, X)
# 00680051210"TELLO"CARLOS FACUNDO"M"34247025...
if len(p3) == 1 and p3.upper() in ("M", "F", "X"):
sexo = p3.upper()
if len(parts) > 4:
doc = p4
# Caso 2: Formato App Mi Argentina (parts[3] es código numérico de sexo 1=M, 2=F, 3=X)
# y parts[4] es el DNI numérico (6 a 9 dígitos)
# Ej: 00305336518@CIRILLI@GEORGINA SUSANA@2@28988082@A@23/08/1981@13/10/2014
# Ej: 00680051210@TELLO@Carlos Facundo@1@34247025@F@09/02/1989@13/10/2021
elif p3 in ("1", "2", "3", "0") and p4.isdigit() and 6 <= len(p4) <= 9:
if p3 == "1":
sexo = "M"
elif p3 == "2":
sexo = "F"
else:
sexo = "X"
doc = p4
# Caso 3: Formato 2026 (parts[3] es directamente el DNI de 6 a 9 dígitos)
# y parts[4] suele ser ejemplar o sexo alfabético (ej. 'G', 'F', 'M')
# 00749743816"TELLO"CARLOS FACUNDO"34247025"G...
elif p3.isdigit() and 6 <= len(p3) <= 9 and not (p4.isdigit() and 6 <= len(p4) <= 9):
doc = p3
if p4.upper() in ("M", "F", "X"):
sexo = p4.upper()
elif p4.upper() == "G":
sexo = "M"
# Caso 4: Desempate general: si parts[4] es un DNI numérico válido de 6 a 9 dígitos
elif p4.isdigit() and 6 <= len(p4) <= 9:
doc = p4
if p3 == "1":
sexo = "M"
elif p3 == "2":
sexo = "F"
elif p3.upper() in ("M", "F", "X"):
sexo = p3.upper()
else:
# Fallback final
doc = p3
# Normalización del documento extraído (eliminación de prefijos F/M en DNI viejo)
doc_limpio, sexo_doc = limpiar_numero_documento(doc)
doc = doc_limpio
if not sexo and sexo_doc:
sexo = sexo_doc
if not doc or not doc.isdigit() or not (5 <= len(doc) <= 9):
return {}
return {
"documento": doc.strip(),
"apellido": apellido.upper() if apellido else "",
"nombre": nombre.upper() if nombre else "",
"sexo": sexo or "M"
}
@@ -17,6 +17,7 @@ from app.models.building import Building
from app.models.enrollment import StudentEnrollment from app.models.enrollment import StudentEnrollment
from app.models.subject import Commission, Subject from app.models.subject import Commission, Subject
from schemas.reception_dto import TodayClassDTO from schemas.reception_dto import TodayClassDTO
from app.services.argentine_dni_parser import parsear_dni
class QRSecurityService: class QRSecurityService:
@@ -134,6 +135,28 @@ class QRSecurityService:
return user_by_dni, "RESTRINGIDO", "Usuario inactivo en el sistema institucional." return user_by_dni, "RESTRINGIDO", "Usuario inactivo en el sistema institucional."
return user_by_dni, "AUTORIZADO", f"Identificación validada por documento de identidad (DNI {doc})." return user_by_dni, "AUTORIZADO", f"Identificación validada por documento de identidad (DNI {doc})."
# C. Reconocimiento universal de DNI Argentino (Formatos Renaper 2009, 2012, 2026, Mi Argentina y PDF417 / QR)
dni_info = parsear_dni(clean_normalized)
if dni_info and dni_info.get("documento"):
doc = dni_info["documento"]
user_by_dni = User.query.filter_by(document_number=doc).first()
if not user_by_dni:
user_by_dni = User.query.filter(
(User.username == doc) | (User.email.like(f"{doc}@%"))
).first()
if user_by_dni:
if not user_by_dni.is_active:
return user_by_dni, "RESTRINGIDO", f"Usuario inactivo en el sistema institucional (DNI {doc})."
nombre_display = f"{dni_info.get('apellido', '')} {dni_info.get('nombre', '')}".strip()
detalle = f"Identificación validada por DNI argentino {doc}" + (f" ({nombre_display})" if nombre_display else "")
return user_by_dni, "AUTORIZADO", detalle
else:
nombre_display = f"{dni_info.get('apellido', '')} {dni_info.get('nombre', '')}".strip()
if nombre_display:
return None, "DENEGADO", f"DNI argentino {doc} ({nombre_display}) no se encuentra registrado en el padrón de UniCABA."
return None, "DENEGADO", f"DNI argentino {doc} no se encuentra registrado en el padrón de UniCABA."
# D. Fallback: Lectura de pistola óptica o documento directo (ej: 'DNI:12345678' o '12345678') # D. Fallback: Lectura de pistola óptica o documento directo (ej: 'DNI:12345678' o '12345678')
doc_num = clean_normalized doc_num = clean_normalized
if doc_num.upper().startswith("DNI:"): if doc_num.upper().startswith("DNI:"):
+1 -1
View File
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
setup( setup(
name="edu-space-admin", name="edu-space-admin",
version="3.8.51", version="3.8.52",
description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)", description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)",
author="Edu-Space Development Team", author="Edu-Space Development Team",
author_email="admin@edu-space.com", author_email="admin@edu-space.com",
+90
View File
@@ -0,0 +1,90 @@
import pytest
from app.services.argentine_dni_parser import parsear_dni, limpiar_numero_documento
def test_limpiar_numero_documento_variations():
assert limpiar_numero_documento("F5592570") == ("5592570", "F")
assert limpiar_numero_documento("M34247025") == ("34247025", "M")
assert limpiar_numero_documento("f 5592570") == ("5592570", "F")
assert limpiar_numero_documento("34.247.025") == ("34247025", None)
assert limpiar_numero_documento("34247025") == ("34247025", None)
def test_parsear_dni_ejemplo_1_formato_2026():
raw = '00749743816"TELLO"CARLOS FACUNDO"34247025"G"09-02-89"23-04-26"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJpZF90cmFtaXRlIjoiNzQ5NzQzODE2In0.1JThZ0G'
parsed = parsear_dni(raw)
assert parsed["documento"] == "34247025"
assert parsed["apellido"] == "TELLO"
assert parsed["nombre"] == "CARLOS FACUNDO"
assert parsed["sexo"] in ("M", "G")
def test_parsear_dni_ejemplo_2_formato_2009_con_comillas():
raw = '"20979166 "A"1"CASTIGLIONI"MARCELA ANALIA"ARGENTINA"20-07-1969"F"28-02-2011"00040202308"7006 "28-02-2026"296"0"ILRÑ2.01 CÑ110223.01'
parsed = parsear_dni(raw)
assert parsed["documento"] == "20979166"
assert parsed["apellido"] == "CASTIGLIONI"
assert parsed["nombre"] == "MARCELA ANALIA"
assert parsed["sexo"] == "F"
def test_parsear_dni_ejemplo_3_formato_mi_argentina_1():
raw = '305336518"CIRILLI"GEORGINA SUSANA"2"28988082"A"23-08-1981"13-10-2014'
parsed = parsear_dni(raw)
assert parsed["documento"] == "28988082"
assert parsed["apellido"] == "CIRILLI"
assert parsed["nombre"] == "GEORGINA SUSANA"
assert parsed["sexo"] == "F"
def test_parsear_dni_ejemplo_4_formato_2012():
raw = '00225303383"RIO"MARTINA"F"46585482"A"02-09-2005"19-10-2013'
parsed = parsear_dni(raw)
assert parsed["documento"] == "46585482"
assert parsed["apellido"] == "RIO"
assert parsed["nombre"] == "MARTINA"
assert parsed["sexo"] == "F"
def test_parsear_dni_ejemplo_5_formato_2009_con_f():
raw = '"f5592570 "A"1"SAUCEDO"TERESA DE JESUS"ARGENTINA"16-02-1947"F"21-01-2012"00090833406"7020 "21-01-2027"206"0"'
parsed = parsear_dni(raw)
assert parsed["documento"] == "5592570"
assert parsed["apellido"] == "SAUCEDO"
assert parsed["nombre"] == "TERESA DE JESUS"
assert parsed["sexo"] == "F"
def test_parsear_dni_ejemplo_6_formato_mi_argentina_2():
raw = '680051210"TELLO"Carlos Facundo"1"34247025"F"09-02-1989"13-10-2021'
parsed = parsear_dni(raw)
assert parsed["documento"] == "34247025"
assert parsed["apellido"] == "TELLO"
assert parsed["nombre"] == "CARLOS FACUNDO"
assert parsed["sexo"] == "M"
def test_parsear_dni_con_separadores_arroba():
raw = '00305336518@CIRILLI@GEORGINA SUSANA@2@28988082@A@23/08/1981@13/10/2014'
parsed = parsear_dni(raw)
assert parsed["documento"] == "28988082"
assert parsed["apellido"] == "CIRILLI"
assert parsed["nombre"] == "GEORGINA SUSANA"
assert parsed["sexo"] == "F"
def test_parsear_dni_directo_o_invalido():
assert parsear_dni("34247025") == {
"documento": "34247025",
"apellido": "",
"nombre": "",
"sexo": "M"
}
assert parsear_dni("F5592570") == {
"documento": "5592570",
"apellido": "",
"nombre": "",
"sexo": "F"
}
assert parsear_dni("") == {}
assert parsear_dni("TEXTO_CORTO") == {}
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"name": "frontend", "name": "frontend",
"version": "3.8.51", "version": "3.8.52",
"description": "", "description": "",
"main": "index.js", "main": "index.js",
"scripts": { "scripts": {
+197 -76
View File
@@ -1,186 +1,307 @@
/** /**
* serial-scanner.js — Módulo de Lector Óptico y Escáner QR por Puerto Serie (COM) * serial-scanner.js — Módulo Multi-Lector Óptico y Escáner QR por Puerto Serie (COM)
* Específico para navegadores Chromium (Google Chrome, Microsoft Edge, Opera, Brave) en entornos Windows. * Específico para navegadores Chromium (Google Chrome, Microsoft Edge, Opera, Brave) en entornos Windows.
* Utiliza la Web Serial API (navigator.serial) para lectura directa y en segundo plano sin requerir foco. * Soporta hasta 4 lectores seriales concurrentes mediante la Web Serial API (navigator.serial).
* Espec: specs/013-escaner-qr-puerto-com-serial/ * Especificación: specs/013-escaner-qr-puerto-com-serial/
*/ */
(function(window) { (function(window) {
'use strict'; 'use strict';
class SerialBarcodeScanner { class SerialSlot {
constructor(options = {}) { constructor(id, name, options = {}) {
this.id = id;
this.name = name || `Lector ${id}`;
this.baudRate = options.baudRate || 9600; this.baudRate = options.baudRate || 9600;
this.port = null; this.port = null;
this.reader = null; this.reader = null;
this.readableStreamClosed = null; this.readableStreamClosed = null;
this.keepReading = false; this.keepReading = false;
this.buffer = ''; this.buffer = '';
this.status = 'DISCONNECTED'; // 'DISCONNECTED' | 'CONNECTED' | 'ERROR'
this.lastCode = '';
this.lastScannedAt = null;
}
isConnected() {
return this.status === 'CONNECTED' && this.port !== null && Boolean(this.port.readable);
}
}
class MultiSerialBarcodeScanner {
constructor(options = {}) {
this.maxSlots = 4;
this.slots = [
new SerialSlot(1, 'Lector 1 (Paso Principal)', options),
new SerialSlot(2, 'Lector 2 (Molinete / Acceso)', options),
new SerialSlot(3, 'Lector 3 (Mesa Bedelía)', options),
new SerialSlot(4, 'Lector 4 (Auxiliar / Puesto 2)', options)
];
this.onCodeScanned = options.onCodeScanned || null; this.onCodeScanned = options.onCodeScanned || null;
this.onStatusChanged = options.onStatusChanged || null; this.onStatusChanged = options.onStatusChanged || null;
this.onError = options.onError || null; this.onError = options.onError || null;
this._initDisconnectListener(); this._initGlobalDisconnectListener();
} }
isSupported() { isSupported() {
return typeof navigator !== 'undefined' && 'serial' in navigator; return typeof navigator !== 'undefined' && 'serial' in navigator;
} }
_initDisconnectListener() { getSlots() {
return this.slots;
}
getSlot(slotId) {
return this.slots.find(s => s.id === slotId) || null;
}
getConnectedCount() {
return this.slots.filter(s => s.isConnected()).length;
}
_initGlobalDisconnectListener() {
if (this.isSupported()) { if (this.isSupported()) {
navigator.serial.addEventListener('disconnect', (event) => { navigator.serial.addEventListener('disconnect', (event) => {
if (this.port && event.target === this.port) { const disconnectedSlot = this.slots.find(s => s.port === event.target);
this._notifyStatus('DISCONNECTED', 'Puerto serie desconectado físicamente.'); if (disconnectedSlot) {
this.disconnect(); this.disconnectSlot(disconnectedSlot.id, 'Dispositivo serie desconectado físicamente.');
} }
}); });
} }
} }
_notifyStatus(status, message, details = {}) { _notifyStatus(slot, message, extra = {}) {
if (typeof this.onStatusChanged === 'function') { if (typeof this.onStatusChanged === 'function') {
this.onStatusChanged({ status, message, ...details }); this.onStatusChanged({
slotId: slot.id,
slotName: slot.name,
status: slot.status,
message: message || '',
baudRate: slot.baudRate,
totalConnected: this.getConnectedCount(),
...extra
});
} }
} }
async autoConnectIfAuthorized() { /**
if (!this.isSupported()) return false; * Reabre automáticamente los puertos previamente autorizados por el usuario en esta terminal.
*/
async autoConnectAuthorizedPorts() {
if (!this.isSupported()) return 0;
try { try {
const ports = await navigator.serial.getPorts(); const ports = await navigator.serial.getPorts();
if (ports && ports.length > 0) { if (!ports || ports.length === 0) return 0;
this.port = ports[0];
await this._openPort(); let connectedCount = 0;
return true; for (let i = 0; i < Math.min(ports.length, this.maxSlots); i++) {
const slot = this.slots[i];
if (!slot.isConnected()) {
try {
slot.port = ports[i];
await this._openPortOnSlot(slot);
connectedCount++;
} catch (err) {
console.warn(`[MultiSerialScanner] Autoconnect slot ${slot.id} notice:`, err.message);
}
}
} }
return connectedCount;
} catch (err) { } catch (err) {
console.warn('[SerialScanner] Autoconnect notice:', err.message); console.warn('[MultiSerialScanner] Error consultando puertos autorizados:', err);
return 0;
} }
return false;
} }
async requestAndConnect(baudRate = null) { /**
* Solicita al operador seleccionar un dispositivo serie COM y lo asigna al slot especificado.
*/
async requestAndConnectSlot(slotId, baudRate = null) {
if (!this.isSupported()) { if (!this.isSupported()) {
throw new Error('La Web Serial API no está soportada en este navegador. Utiliza Google Chrome o Microsoft Edge.'); throw new Error('La Web Serial API no está disponible en este navegador. Utiliza Google Chrome o Microsoft Edge en Windows.');
}
const slot = this.getSlot(slotId);
if (!slot) {
throw new Error(`Slot #${slotId} no válido (debe ser entre 1 y ${this.maxSlots}).`);
} }
if (baudRate) { if (baudRate) {
this.baudRate = parseInt(baudRate, 10) || 9600; slot.baudRate = parseInt(baudRate, 10) || 9600;
} }
// Desconectar puerto previo si estuviera activo // Si el slot ya estaba conectado, liberarlo previamente
if (this.port) { if (slot.isConnected()) {
await this.disconnect(); await this.disconnectSlot(slot.id);
} }
// Despliega el diálogo nativo de Windows para seleccionar dispositivo COM // Despliega el diálogo nativo de Windows para seleccionar dispositivo serie COM
this.port = await navigator.serial.requestPort(); const port = await navigator.serial.requestPort();
await this._openPort(); slot.port = port;
return this.port; await this._openPortOnSlot(slot);
return slot;
} }
async _openPort() { async _openPortOnSlot(slot) {
if (!this.port) return; if (!slot || !slot.port) return;
await this.port.open({ await slot.port.open({
baudRate: this.baudRate, baudRate: slot.baudRate,
dataBits: 8, dataBits: 8,
stopBits: 1, stopBits: 1,
parity: 'none', parity: 'none',
bufferSize: 1024 bufferSize: 2048
}); });
this.keepReading = true; slot.keepReading = true;
this._notifyStatus('CONNECTED', `Puerto serie conectado a ${this.baudRate} baudios.`, { slot.status = 'CONNECTED';
baudRate: this.baudRate this._notifyStatus(slot, `Lector COM conectado a ${slot.baudRate} baudios.`);
});
this._startReadingLoop(); this._startReadingLoop(slot);
} }
async _startReadingLoop() { async _startReadingLoop(slot) {
while (this.port && this.port.readable && this.keepReading) { while (slot.port && slot.port.readable && slot.keepReading) {
const textDecoder = new TextDecoderStream(); const textDecoder = new TextDecoderStream();
this.readableStreamClosed = this.port.readable.pipeTo(textDecoder.writable); slot.readableStreamClosed = slot.port.readable.pipeTo(textDecoder.writable);
this.reader = textDecoder.readable.getReader(); slot.reader = textDecoder.readable.getReader();
try { try {
while (this.keepReading) { while (slot.keepReading) {
const { value, done } = await this.reader.read(); const { value, done } = await slot.reader.read();
if (done) break; if (done) break;
if (value) { if (value) {
this._handleIncomingText(value); this._handleIncomingText(slot, value);
} }
} }
} catch (error) { } catch (error) {
if (this.keepReading) { if (slot.keepReading) {
console.error('[SerialScanner] Error en lectura serie:', error); console.error(`[MultiSerialScanner] Error en lectura de slot ${slot.id}:`, error);
if (typeof this.onError === 'function') { if (typeof this.onError === 'function') {
this.onError(error); this.onError(error, slot);
} }
} }
} finally { } finally {
try { try {
this.reader.releaseLock(); slot.reader.releaseLock();
} catch (e) {} } catch (e) {}
} }
} }
} }
_handleIncomingText(chunk) { _handleIncomingText(slot, chunk) {
this.buffer += chunk; slot.buffer += chunk;
// Detectar delimitadores de fin de línea habituales en pistolas ópticas (\r, \n) // Delimitadores habituales de lectores y pistolas ópticas (\r, \n)
if (this.buffer.includes('\n') || this.buffer.includes('\r')) { if (slot.buffer.includes('\n') || slot.buffer.includes('\r')) {
const parts = this.buffer.split(/[\r\n]+/); const parts = slot.buffer.split(/[\r\n]+/);
for (let i = 0; i < parts.length - 1; i++) { for (let i = 0; i < parts.length - 1; i++) {
const rawCode = parts[i].trim(); const rawCode = parts[i].trim();
if (rawCode.length >= 2) { if (rawCode.length >= 2) {
this._dispatchCode(rawCode); this._dispatchCode(slot, rawCode);
} }
} }
this.buffer = parts[parts.length - 1]; slot.buffer = parts[parts.length - 1];
} }
} }
_dispatchCode(code) { _dispatchCode(slot, code) {
// Normalizar scancodes si fuera necesario // Normalizar tolerante de scancodes si el lector traduce : a Ñ en teclados en español
const cleanCode = code.replace(/Ñ/g, ':').replace(/ñ/g, ':'); const cleanCode = code.replace(/Ñ/g, ':').replace(/ñ/g, ':');
slot.lastCode = cleanCode;
slot.lastScannedAt = new Date();
if (typeof this.onCodeScanned === 'function') { if (typeof this.onCodeScanned === 'function') {
this.onCodeScanned(cleanCode); this.onCodeScanned(cleanCode, {
slotId: slot.id,
slotName: slot.name,
timestamp: slot.lastScannedAt
});
} }
} }
async disconnect() { async disconnectSlot(slotId, reason = 'Desconectado por el usuario') {
this.keepReading = false; const slot = this.getSlot(slotId);
if (!slot) return;
if (this.reader) { slot.keepReading = false;
slot.status = 'DISCONNECTED';
if (slot.reader) {
try { try {
await this.reader.cancel(); await slot.reader.cancel();
} catch (e) {} } catch (e) {}
this.reader = null; slot.reader = null;
} }
if (this.readableStreamClosed) { if (slot.readableStreamClosed) {
try { try {
await this.readableStreamClosed.catch(() => {}); await slot.readableStreamClosed.catch(() => {});
} catch (e) {} } catch (e) {}
this.readableStreamClosed = null; slot.readableStreamClosed = null;
} }
if (this.port) { if (slot.port) {
try { try {
await this.port.close(); await slot.port.close();
} catch (e) {} } catch (e) {}
this.port = null; slot.port = null;
} }
this.buffer = ''; slot.buffer = '';
this._notifyStatus('DISCONNECTED', 'Puerto serie desconectado.'); this._notifyStatus(slot, reason);
}
async disconnectAll() {
for (const slot of this.slots) {
if (slot.isConnected()) {
await this.disconnectSlot(slot.id);
}
}
} }
} }
// Exportar al objeto global de ventana // Compatibilidad hacia atrás para código que instancie SerialBarcodeScanner directamente
window.SerialBarcodeScanner = SerialBarcodeScanner; class SerialBarcodeScannerCompat {
constructor(options = {}) {
this.multi = new MultiSerialBarcodeScanner({
...options,
onCodeScanned: (code, info) => {
if (typeof options.onCodeScanned === 'function') {
options.onCodeScanned(code, info);
}
},
onStatusChanged: (evt) => {
if (typeof options.onStatusChanged === 'function') {
options.onStatusChanged(evt);
}
}
});
}
isSupported() {
return this.multi.isSupported();
}
async autoConnectIfAuthorized() {
const count = await this.multi.autoConnectAuthorizedPorts();
return count > 0;
}
async requestAndConnect(baudRate = null) {
return await this.multi.requestAndConnectSlot(1, baudRate);
}
async disconnect() {
await this.multi.disconnectSlot(1);
}
}
// Exportar al objeto global
window.MultiSerialBarcodeScanner = MultiSerialBarcodeScanner;
window.SerialBarcodeScanner = SerialBarcodeScannerCompat;
})(window); })(window);
+3 -3
View File
@@ -86,9 +86,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
}); });
// Versiones institucionales del sistema // Versiones institucionales del sistema
const APP_VERSION = '3.8.51'; const APP_VERSION = '3.8.52';
const FRONTEND_VERSION = '3.8.51'; const FRONTEND_VERSION = '3.8.52';
const BACKEND_VERSION = '3.8.51'; const BACKEND_VERSION = '3.8.52';
env.addGlobal('app_version', APP_VERSION); env.addGlobal('app_version', APP_VERSION);
env.addGlobal('frontend_version', FRONTEND_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION);
+221 -64
View File
@@ -76,23 +76,119 @@
</div> </div>
</form> </form>
<!-- Panel de Conexión Serial / Puerto COM (Web Serial API) --> <!-- Panel de Conexión Multi-Lector Serial / Puertos COM (Hasta 4 lectores) -->
<div class="mt-4 pt-3 border-top"> <div class="mt-4 pt-3 border-top">
<div class="d-flex align-items-center justify-content-between mb-2"> <div class="d-flex align-items-center justify-content-between mb-2">
<span class="small fw-bold text-uppercase text-muted"> <span class="small fw-bold text-uppercase text-muted">
<i class="bi bi-usb-symbol me-1 text-primary"></i> Puerto Serie (COM) <i class="bi bi-usb-symbol me-1 text-primary"></i> Lectores Serie COM (Hasta 4)
</span>
<span class="badge bg-secondary-subtle text-secondary rounded-pill px-2 py-1 small" id="serialPortStatusBadge">
<i class="bi bi-circle-fill text-muted me-1" style="font-size: 0.5rem;"></i> Puerto USB-HID Activo
</span> </span>
<div class="d-flex align-items-center gap-1">
<span class="badge bg-secondary-subtle text-secondary rounded-pill px-2 py-1 small" id="comGlobalBadge">
<i class="bi bi-circle-fill text-muted me-1" style="font-size: 0.5rem;"></i> 0 / 4 Activos
</span>
<button type="button" class="btn btn-xs btn-link text-decoration-none p-0 text-muted" title="Reconectar autorizados" onclick="reconnectAuthorizedComPorts()">
<i class="bi bi-arrow-clockwise"></i>
</button>
</div>
</div> </div>
<div class="d-flex align-items-center justify-content-between p-2 rounded-3 bg-body-tertiary border">
<small class="text-muted" style="font-size: 0.74rem;"> <!-- Grilla de los 4 Slots de Lectores Seriales -->
Dispositivos Seriales COM (Windows / Chromium) <div class="row g-2" id="serialSlotsContainer">
</small> <!-- Slot 1 -->
<button type="button" class="btn btn-xs btn-outline-secondary rounded-pill px-3 py-1 text-nowrap" id="btnConnectSerial" onclick="handleSerialConnectClick()"> <div class="col-12">
<i class="bi bi-link-45deg me-1"></i>Configurar COM <div class="p-2 rounded-3 bg-body-tertiary border transition-all" id="slotCard1">
</button> <div class="d-flex align-items-center justify-content-between">
<div class="d-flex align-items-center gap-2">
<span class="badge bg-secondary rounded-circle p-1" id="slotLed1" style="width: 10px; height: 10px;"></span>
<div>
<div class="fw-semibold small text-dark" style="font-size: 0.78rem;">Lector 1 (Paso Principal)</div>
<div class="text-muted" style="font-size: 0.70rem;" id="slotStatusText1">Sin conectar</div>
</div>
</div>
<div class="d-flex align-items-center gap-1">
<select class="form-select form-select-xs py-0 px-1 border-0 bg-transparent text-muted" id="slotBaud1" style="font-size: 0.70rem; width: 68px;">
<option value="9600" selected>9600</option>
<option value="115200">115200</option>
</select>
<button type="button" class="btn btn-xs btn-outline-secondary rounded-pill px-2 py-0" id="btnConnectSlot1" onclick="handleConnectSlot(1)" style="font-size: 0.72rem;">
Conectar
</button>
</div>
</div>
</div>
</div>
<!-- Slot 2 -->
<div class="col-12">
<div class="p-2 rounded-3 bg-body-tertiary border transition-all" id="slotCard2">
<div class="d-flex align-items-center justify-content-between">
<div class="d-flex align-items-center gap-2">
<span class="badge bg-secondary rounded-circle p-1" id="slotLed2" style="width: 10px; height: 10px;"></span>
<div>
<div class="fw-semibold small text-dark" style="font-size: 0.78rem;">Lector 2 (Molinete / Acceso)</div>
<div class="text-muted" style="font-size: 0.70rem;" id="slotStatusText2">Sin conectar</div>
</div>
</div>
<div class="d-flex align-items-center gap-1">
<select class="form-select form-select-xs py-0 px-1 border-0 bg-transparent text-muted" id="slotBaud2" style="font-size: 0.70rem; width: 68px;">
<option value="9600" selected>9600</option>
<option value="115200">115200</option>
</select>
<button type="button" class="btn btn-xs btn-outline-secondary rounded-pill px-2 py-0" id="btnConnectSlot2" onclick="handleConnectSlot(2)" style="font-size: 0.72rem;">
Conectar
</button>
</div>
</div>
</div>
</div>
<!-- Slot 3 -->
<div class="col-12">
<div class="p-2 rounded-3 bg-body-tertiary border transition-all" id="slotCard3">
<div class="d-flex align-items-center justify-content-between">
<div class="d-flex align-items-center gap-2">
<span class="badge bg-secondary rounded-circle p-1" id="slotLed3" style="width: 10px; height: 10px;"></span>
<div>
<div class="fw-semibold small text-dark" style="font-size: 0.78rem;">Lector 3 (Mesa Bedelía)</div>
<div class="text-muted" style="font-size: 0.70rem;" id="slotStatusText3">Sin conectar</div>
</div>
</div>
<div class="d-flex align-items-center gap-1">
<select class="form-select form-select-xs py-0 px-1 border-0 bg-transparent text-muted" id="slotBaud3" style="font-size: 0.70rem; width: 68px;">
<option value="9600" selected>9600</option>
<option value="115200">115200</option>
</select>
<button type="button" class="btn btn-xs btn-outline-secondary rounded-pill px-2 py-0" id="btnConnectSlot3" onclick="handleConnectSlot(3)" style="font-size: 0.72rem;">
Conectar
</button>
</div>
</div>
</div>
</div>
<!-- Slot 4 -->
<div class="col-12">
<div class="p-2 rounded-3 bg-body-tertiary border transition-all" id="slotCard4">
<div class="d-flex align-items-center justify-content-between">
<div class="d-flex align-items-center gap-2">
<span class="badge bg-secondary rounded-circle p-1" id="slotLed4" style="width: 10px; height: 10px;"></span>
<div>
<div class="fw-semibold small text-dark" style="font-size: 0.78rem;">Lector 4 (Auxiliar / Puesto 2)</div>
<div class="text-muted" style="font-size: 0.70rem;" id="slotStatusText4">Sin conectar</div>
</div>
</div>
<div class="d-flex align-items-center gap-1">
<select class="form-select form-select-xs py-0 px-1 border-0 bg-transparent text-muted" id="slotBaud4" style="font-size: 0.70rem; width: 68px;">
<option value="9600" selected>9600</option>
<option value="115200">115200</option>
</select>
<button type="button" class="btn btn-xs btn-outline-secondary rounded-pill px-2 py-0" id="btnConnectSlot4" onclick="handleConnectSlot(4)" style="font-size: 0.72rem;">
Conectar
</button>
</div>
</div>
</div>
</div>
</div> </div>
</div> </div>
</div> </div>
@@ -218,87 +314,132 @@
<script> <script>
let isScanningLocked = false; let isScanningLocked = false;
let serialScanner = null; let multiScanner = null;
// Inicializar SerialBarcodeScanner para Chromium / Windows // Inicializar MultiSerialBarcodeScanner (hasta 4 lectores COM)
function initSerialScanner() { function initSerialScanner() {
if (typeof SerialBarcodeScanner === 'undefined') return; if (typeof MultiSerialBarcodeScanner === 'undefined') return;
serialScanner = new SerialBarcodeScanner({ multiScanner = new MultiSerialBarcodeScanner({
baudRate: 9600, baudRate: 9600,
onCodeScanned: function(code) { onCodeScanned: function(code, slotInfo) {
if (!isScanningLocked) { if (!isScanningLocked) {
isScanningLocked = true; isScanningLocked = true;
playBeep(true); // Destello visual en la tarjeta del lector específico emisor
verifyToken(code); flashSlotCard(slotInfo ? slotInfo.slotId : 1);
verifyToken(code, slotInfo);
setTimeout(() => { isScanningLocked = false; }, 1500); setTimeout(() => { isScanningLocked = false; }, 1500);
} }
}, },
onStatusChanged: function(evt) { onStatusChanged: function(evt) {
const badge = document.getElementById('serialPortStatusBadge'); updateSlotUI(evt);
const btn = document.getElementById('btnConnectSerial');
if (evt.status === 'CONNECTED') {
if (badge) {
badge.className = 'badge bg-success text-white rounded-pill px-2 py-1 small';
badge.innerHTML = '<i class="bi bi-usb-plug-fill me-1"></i> COM Activo (9600 baud)';
}
if (btn) {
btn.className = 'btn btn-xs btn-outline-danger rounded-pill px-3 py-1 text-nowrap';
btn.innerHTML = '<i class="bi bi-x-circle me-1"></i>Desconectar';
}
} else {
if (badge) {
badge.className = 'badge bg-secondary-subtle text-secondary rounded-pill px-2 py-1 small';
badge.innerHTML = '<i class="bi bi-circle-fill text-muted me-1" style="font-size: 0.5rem;"></i> Puerto USB-HID Activo';
}
if (btn) {
btn.className = 'btn btn-xs btn-outline-secondary rounded-pill px-3 py-1 text-nowrap';
btn.innerHTML = '<i class="bi bi-link-45deg me-1"></i>Configurar COM';
}
}
}, },
onError: function(err) { onError: function(err, slot) {
console.warn('[SerialScanner UI] Error:', err); console.warn(`[MultiSerialScanner UI] Error en slot ${slot ? slot.id : '?'}:`, err);
} }
}); });
// Comprobar soporte // Comprobar compatibilidad con Web Serial API
if (!serialScanner.isSupported()) { if (!multiScanner.isSupported()) {
const badge = document.getElementById('serialPortStatusBadge'); const badge = document.getElementById('comGlobalBadge');
const btn = document.getElementById('btnConnectSerial');
if (badge) { if (badge) {
badge.className = 'badge bg-body-tertiary text-muted rounded-pill px-2 py-1 small border'; badge.className = 'badge bg-body-tertiary text-muted rounded-pill px-2 py-1 small border';
badge.textContent = 'Modo USB-HID (Chromium requerido para COM)'; badge.innerHTML = '<i class="bi bi-info-circle me-1"></i> Modo USB-HID (Chromium requerido para COM)';
}
for (let i = 1; i <= 4; i++) {
const btn = document.getElementById(`btnConnectSlot${i}`);
if (btn) btn.disabled = true;
} }
if (btn) btn.disabled = true;
} else { } else {
// Intentar auto-conexión a puerto previamente autorizado // Reabrir automáticamente puertos autorizados
serialScanner.autoConnectIfAuthorized(); reconnectAuthorizedComPorts();
} }
} }
async function handleSerialConnectClick() { function updateSlotUI(evt) {
if (!serialScanner) initSerialScanner(); const slotId = evt.slotId;
if (!serialScanner.isSupported()) { const led = document.getElementById(`slotLed${slotId}`);
const statusText = document.getElementById(`slotStatusText${slotId}`);
const btn = document.getElementById(`btnConnectSlot${slotId}`);
const globalBadge = document.getElementById('comGlobalBadge');
if (evt.status === 'CONNECTED') {
if (led) led.className = 'badge bg-success rounded-circle p-1 animate-pulse-badge';
if (statusText) {
statusText.className = 'text-success fw-semibold';
statusText.innerHTML = `<i class="bi bi-usb-plug-fill me-1"></i> COM Activo (${evt.baudRate || 9600} baud)`;
}
if (btn) {
btn.className = 'btn btn-xs btn-outline-danger rounded-pill px-2 py-0';
btn.innerHTML = '<i class="bi bi-x-circle me-1"></i>Desconectar';
}
} else {
if (led) led.className = 'badge bg-secondary rounded-circle p-1';
if (statusText) {
statusText.className = 'text-muted';
statusText.innerText = 'Sin conectar';
}
if (btn) {
btn.className = 'btn btn-xs btn-outline-secondary rounded-pill px-2 py-0';
btn.innerText = 'Conectar';
}
}
if (globalBadge) {
const connected = evt.totalConnected !== undefined ? evt.totalConnected : (multiScanner ? multiScanner.getConnectedCount() : 0);
if (connected > 0) {
globalBadge.className = 'badge bg-success text-white rounded-pill px-2 py-1 small shadow-xs';
globalBadge.innerHTML = `<i class="bi bi-check-circle-fill me-1"></i> ${connected} / 4 Activos`;
} else {
globalBadge.className = 'badge bg-secondary-subtle text-secondary rounded-pill px-2 py-1 small';
globalBadge.innerHTML = '<i class="bi bi-circle-fill text-muted me-1" style="font-size: 0.5rem;"></i> 0 / 4 Activos';
}
}
}
function flashSlotCard(slotId) {
const card = document.getElementById(`slotCard${slotId}`);
if (!card) return;
card.classList.add('border-primary', 'bg-primary-subtle');
setTimeout(() => {
card.classList.remove('border-primary', 'bg-primary-subtle');
}, 800);
}
async function handleConnectSlot(slotId) {
if (!multiScanner) initSerialScanner();
if (!multiScanner.isSupported()) {
alert('La Web Serial API no está disponible en este navegador. Utiliza Google Chrome o Microsoft Edge en entornos Windows.'); alert('La Web Serial API no está disponible en este navegador. Utiliza Google Chrome o Microsoft Edge en entornos Windows.');
return; return;
} }
const btn = document.getElementById('btnConnectSerial'); const slot = multiScanner.getSlot(slotId);
if (serialScanner.port) { if (slot && slot.isConnected()) {
await serialScanner.disconnect(); await multiScanner.disconnectSlot(slotId);
} else { } else {
const baudSelect = document.getElementById(`slotBaud${slotId}`);
const baudRate = baudSelect ? parseInt(baudSelect.value, 10) : 9600;
try { try {
await serialScanner.requestAndConnect(9600); await multiScanner.requestAndConnectSlot(slotId, baudRate);
} catch (err) { } catch (err) {
if (err.name !== 'NotFoundError') { if (err.name !== 'NotFoundError') {
console.error('Error al conectar puerto COM:', err); console.error(`Error conectando slot ${slotId}:`, err);
alert('No se pudo abrir el puerto serie: ' + err.message); alert(`No se pudo abrir el puerto serie para el Lector ${slotId}: ` + err.message);
} }
} }
} }
} }
async function reconnectAuthorizedComPorts() {
if (!multiScanner) initSerialScanner();
if (multiScanner && multiScanner.isSupported()) {
const count = await multiScanner.autoConnectAuthorizedPorts();
if (count > 0) {
console.log(`[MultiSerialScanner] ${count} puertos reconectados automáticamente.`);
}
}
}
// Mantener el cursor forzado permanentemente en el input de la pistola óptica // Mantener el cursor forzado permanentemente en el input de la pistola óptica
function focusScannerInput() { function focusScannerInput() {
const input = document.getElementById('scannerInput'); const input = document.getElementById('scannerInput');
@@ -342,7 +483,7 @@
} }
// Petición AJAX de verificación al Backend BFF // Petición AJAX de verificación al Backend BFF
async function verifyToken(token) { async function verifyToken(token, slotInfo = null) {
const buildingId = document.getElementById('buildingSelect').value; const buildingId = document.getElementById('buildingSelect').value;
try { try {
@@ -356,7 +497,7 @@
}); });
const data = await resp.json(); const data = await resp.json();
displayVerificationResult(data); displayVerificationResult(data, slotInfo);
refreshRecentLogs(); refreshRecentLogs();
} catch (err) { } catch (err) {
console.error('Error verificando:', err); console.error('Error verificando:', err);
@@ -364,14 +505,14 @@
status: 'DENEGADO', status: 'DENEGADO',
message: 'Error de conexión con el validador.', message: 'Error de conexión con el validador.',
todays_classes: [] todays_classes: []
}); }, slotInfo);
} finally { } finally {
setTimeout(focusScannerInput, 150); setTimeout(focusScannerInput, 150);
} }
} }
// Despliegue visual de resultados en pantalla // Despliegue visual de resultados en pantalla
function displayVerificationResult(data) { function displayVerificationResult(data, slotInfo = null) {
const waitingState = document.getElementById('waitingState'); const waitingState = document.getElementById('waitingState');
const activeState = document.getElementById('activeResultState'); const activeState = document.getElementById('activeResultState');
const resultCard = document.getElementById('resultCard'); const resultCard = document.getElementById('resultCard');
@@ -392,8 +533,10 @@
void resultCard.offsetWidth; // Forzar reflow para reiniciar animación void resultCard.offsetWidth; // Forzar reflow para reiniciar animación
if (alertBadge) { if (alertBadge) {
const sourceLabel = slotInfo ? (slotInfo.slotName || `Lector ${slotInfo.slotId}`) : 'Pistola Óptica';
alertBadge.innerHTML = `<i class="bi bi-lightning-charge-fill text-warning me-1"></i> ¡Nuevo Escaneo! <span class="badge bg-dark text-white ms-1 fw-normal">${sourceLabel}</span>`;
alertBadge.classList.remove('d-none'); alertBadge.classList.remove('d-none');
setTimeout(() => { alertBadge.classList.add('d-none'); }, 2500); setTimeout(() => { alertBadge.classList.add('d-none'); }, 3000);
} }
const hasClasses = Boolean(data.todays_classes && data.todays_classes.length > 0); const hasClasses = Boolean(data.todays_classes && data.todays_classes.length > 0);
@@ -474,6 +617,20 @@
</div> </div>
</div> </div>
`).join(''); `).join('');
} else if (data.status === 'DENEGADO') {
classesContainer.innerHTML = `
<div class="alert alert-danger border border-danger-subtle text-danger-emphasis p-3 rounded-4 mb-0 shadow-xs">
<div class="d-flex align-items-center gap-3">
<div class="rounded-circle bg-danger text-white p-2 d-flex align-items-center justify-content-center shadow-xs" style="width: 42px; height: 42px;">
<i class="bi bi-shield-x fs-5"></i>
</div>
<div>
<div class="fw-bold fs-6">Ingreso No Autorizado</div>
<div class="small">${data.message || 'El documento o credencial escaneada no registra permisos vigentes de ingreso.'}</div>
</div>
</div>
</div>
`;
} else { } else {
classesContainer.innerHTML = ` classesContainer.innerHTML = `
<div class="alert alert-warning border border-warning-subtle text-dark p-3 rounded-4 mb-0 shadow-xs"> <div class="alert alert-warning border border-warning-subtle text-dark p-3 rounded-4 mb-0 shadow-xs">
+36 -25
View File
@@ -53,37 +53,48 @@ Las pistolas ópticas envían los caracteres leídos en pequeños fragmentos (ch
- Al recargar la página o volver a la pestaña, se consulta `navigator.serial.getPorts()`. - Al recargar la página o volver a la pestaña, se consulta `navigator.serial.getPorts()`.
- Si el navegador ya concedió permiso para un puerto serie en esta sesión, se reabre automáticamente sin solicitar nuevamente permiso interactivo al usuario. - Si el navegador ya concedió permiso para un puerto serie en esta sesión, se reabre automáticamente sin solicitar nuevamente permiso interactivo al usuario.
### 2.5. Arquitectura Multi-Lector Serial (4 Slots Concurrentes)
- Se diseña la clase `MultiSerialBarcodeScanner` que administra un array fijo de 4 slots de escaneo (`Slot 1`, `Slot 2`, `Slot 3`, `Slot 4`).
- Cada slot encapsula su propia instancia de `SerialPort`, `reader`, `baudRate` (predeterminado 9600) y buffer de línea.
- La función `requestAndConnectSlot(slotId, baudRate)` permite al operador invocar `navigator.serial.requestPort()` para asignar un puerto COM específico al slot deseado.
- Al detectarse un código en cualquiera de los slots activos, se despacha el evento `onCodeScanned(code, { slotId, slotName })`, emitiendo una alerta visual en el slot específico y ejecutando `verifyToken(code)`.
### 2.6. Módulo de Normalización y Parseo de DNI Argentino
- Módulo `backend/app/services/argentine_dni_parser.py`:
- `limpiar_numero_documento(doc_raw)`: Remueve puntos, espacios, y extrae prefijos de género antiguos (`F`, `M`) retornando `(documento_numerico, sexo)`.
- `parsear_dni(raw_text)`: Identifica los formatos oficiales de Renaper:
- Formato 2009 (con/sin comilla inicial, posición fija de apellido, nombre, sexo).
- Formatos 2012, 2026 y App Mi Argentina (comienzan con número de trámite >= 8 dígitos, sexo alfabético o numérico 1/2/3, y DNI de 6 a 9 dígitos).
- Entradas directas de tarjetas o códigos de barras 1D.
- Integración en `backend/app/services/qr_security_service.py`:
- Antes del fallback por string crudo, se invoca `parsear_dni(clean_normalized)`.
- Si retorna un `documento` numérico válido (5 a 9 dígitos), se busca al usuario por `User.document_number == doc` o coincidencia de `username`.
- Si el usuario existe en el padrón de UniCABA, se valida su estado (activo, regularidad) y se computan sus clases de hoy.
- Si no existe, se retorna estado `DENEGADO` con detalle amigable: *"DNI argentino {doc} ({apellido}, {nombre}) no encontrado en el padrón de UniCABA."*
--- ---
## 3. Estructura de Cambios por Archivo ## 3. Estructura de Cambios por Archivo
1. **`frontend/views/reception/scanner.html`**: 1. **`backend/app/services/argentine_dni_parser.py`** (Nuevo módulo):
- Reemplazo definitivo del visor de cámara por el panel de Lector Óptico y Control de Puerto Serie. - Funciones `limpiar_numero_documento` y `parsear_dni` con cobertura exhaustiva de los formatos 2009, 2012, 2026 y Mi Argentina.
- Selector de sedes filtrado exclusivamente por sedes físicas con `Edificio Central` predeterminado. 2. **`backend/tests/test_dni_parser.py`** (Nuevas pruebas unitarias):
- Controles de UI para el puerto COM: Badge de estado (`COM Activo`, `Desconectado`, `No Soportado`), botón de conexión rápida, selector de baud rate (9600 predeterminado). - Pruebas automatizadas con los 6 ejemplos provistos por el usuario y casos extremos.
- Inclusión del módulo `serial-scanner.js` y binding con `verifyToken()`. 3. **`backend/app/services/qr_security_service.py`**:
- Integración de `parsear_dni` en `decode_and_resolve_user` con respuesta enriquecida.
2. **`frontend/public/js/serial-scanner.js`** (Nuevo módulo): 4. **`frontend/public/js/serial-scanner.js`**:
- Encapsula la clase `SerialBarcodeScanner` con métodos: - Soporte para `MultiSerialBarcodeScanner` administrando hasta 4 slots concurrentes con reconexión automática.
- `isSupported()` 5. **`frontend/views/reception/scanner.html`**:
- `connect(baudRate)` - Interfaz visual para los 4 lectores COM (con modal o acordeón de gestión de 4 terminales, badges de estado individuales y notificación de lectura por puerto).
- `disconnect()` - Parser complementario en cliente para pre-detección de DNI argentino.
- `autoConnectIfAuthorized()`
- Eventos: `onCodeScanned`, `onStatusChanged`, `onError`.
3. **`frontend/src/routes/reception.js`**:
- Filtrado estricto de `buildings` presenciales (`!is_virtual`).
- Sede predeterminada `Edificio Central`.
--- ---
## 4. Plan de Pruebas y Validación ## 4. Plan de Pruebas y Validación
1. **Prueba de Compatibilidad de API**: 1. **Pruebas Unitarias del Parser de DNI**:
- En Chrome/Edge: verificar que `navigator.serial` esté disponible y que al pulsar "Configurar COM" se abra el diálogo del sistema operativo Windows. - Validar los 6 ejemplos de lecturas reales provistas por el usuario.
- En Firefox: verificar que la interfaz no lance errores y explique amigablemente el uso de USB HID. 2. **Pruebas de Verificación de Recepción**:
2. **Prueba de Ingesta y Verificación Asíncrona**: - Validar que al enviar la cadena cruda de un DNI argentino a `/api/v1/reception/verify`, se resuelva el estudiante si existe en BD.
- Simular transmisión de bytes en serie terminados en `\r\n` con código de credencial. 3. **Prueba de Multi-Lector Serial en Navegador**:
- Verificar que `verifyToken` se dispare sin que el cursor deba estar en el input de texto. - Verificar la API de 4 slots en `MultiSerialBarcodeScanner` con eventos concurrentes.
3. **Prueba de Desconexión Física y Resiliencia**:
- Simular evento `disconnect` en el puerto serial y validar que el badge retorne a "Desconectado" sin colgar el navegador.
+24 -7
View File
@@ -49,20 +49,37 @@ Para resolver esto en terminales con sistema operativo **Windows**, esta especif
- **RF-12 (Error de apertura o puerto ocupado)**: SI el puerto COM seleccionado ya se encuentra abierto por otra aplicación de Windows o falla la comunicación, ENTONCES EL SISTEMA mostrará un mensaje de advertencia: `"No se pudo acceder al puerto COM. Verifique que no esté en uso por otra terminal o software de escáner"`. - **RF-12 (Error de apertura o puerto ocupado)**: SI el puerto COM seleccionado ya se encuentra abierto por otra aplicación de Windows o falla la comunicación, ENTONCES EL SISTEMA mostrará un mensaje de advertencia: `"No se pudo acceder al puerto COM. Verifique que no esté en uso por otra terminal o software de escáner"`.
### 4.5. Requisitos Opcionales (Configuración y Preferencias) ### 4.5. Requisitos Opcionales (Configuración y Preferencias)
- **RF-13 (Ajuste de velocidad de baudios)**: DONDE el modelo de escáner industrial requiera una tasa de transferencia diferente a 9600 baudios, EL SISTEMA permitirá al operador seleccionar entre 9600, 19200, 38400 y 115200 baudios mediante un menú desplegable de configuración rápida. ### 4.6. Requisitos de Multi-Lector Serial (Hasta 4 Lectores COM Concurrentes)
- **RF-14 (Gestión de Múltiples Lectores Serie)**: EL SISTEMA permitirá la conexión, configuración y escucha simultánea de hasta **4 lectores QR / código de barras por puerto serie (COM)** concurrentes en una misma terminal o puesto de control de recepción.
- **RF-15 (Slots de Lectura Independientes)**: EL SISTEMA proveerá 4 slots identificables (ej: "Lector 1 / Entrada", "Lector 2", "Lector 3", "Lector 4"), cada uno con su propio estado de conexión (`CONNECTED`, `DISCONNECTED`), configuración de baudios y control independiente para abrir o liberar el puerto.
- **RF-16 (Multiplexación y canalización de escaneos)**: CUANDO cualquiera de los 4 lectores seriales transmita una lectura, EL SISTEMA procesará el código de inmediato de forma no bloqueante, notificando en la interfaz el slot emisor y disparando la verificación académica sin interferir con los otros lectores.
- **RF-17 (Reconexión automática multi-puerto)**: MIENTRAS existan puertos seriales previamente autorizados en el navegador (`navigator.serial.getPorts()`), EL SISTEMA intentará reabrir y asignar automáticamente hasta 4 puertos conocidos a los slots disponibles al iniciar o recargar la consola.
### 4.7. Requisitos de Reconocimiento de Documento Nacional de Identidad (DNI Argentino)
- **RF-18 (Detección de DNI Físico / QR / PDF417 de Renaper)**: EL SISTEMA detectará automáticamente si una cadena leída (vía lector COM, pistola USB-HID o ingreso manual) corresponde a un Documento Nacional de Identidad argentino en sus distintos formatos oficiales:
1. *Formato 2009 con comilla inicial*: `"34247025"A"1"TELLO"CARLOS FACUNDO"...` o `"f5592570 "A"1"SAUCEDO"TERESA DE JESUS"...`
2. *Formato 2009 sin comilla inicial*: `34247025"A"1"TELLO"CARLOS FACUNDO"...`
3. *Formato 2012*: `00225303383"RIO"MARTINA"F"46585482"A"...` (número de trámite, apellido, nombre, sexo M/F/X, DNI).
4. *Formato App Mi Argentina*: `305336518"CIRILLI"GEORGINA SUSANA"2"28988082"A"...` (sexo numérico 1=M, 2=F, 3=X, DNI).
5. *Formato 2026*: `00749743816"TELLO"CARLOS FACUNDO"34247025"G"...` (DNI en posición 3 con ejemplar alfabético).
6. *Entrada 1D / directa*: Con o sin prefijos de género antiguos (ej: `F5592570` ➔ `5592570`).
- **RF-19 (Normalización y Búsqueda Académica por DNI)**: CUANDO se reconozca un DNI argentino, EL SISTEMA normalizará el número de documento numérico y realizará la búsqueda directa en el padrón institucional (`User.document_number` o username).
- **RF-20 (Respuesta Contextual de DNI)**: SI el DNI pertenece a un estudiante o docente registrado, EL SISTEMA retornará su validación académica completa (aulas y horarios de hoy). SI el DNI no se encuentra en la base de datos de UniCABA, EL SISTEMA responderá informando claramente el documento y nombres extraídos del plástico físico (ej. `"DNI 34247025 (TELLO, CARLOS FACUNDO) no se encuentra registrado en el padrón de UniCABA"`).
--- ---
## 5. Requisitos No Funcionales (NFR) ## 5. Requisitos No Funcionales (NFR)
1. **Latencia de Captura**: El tiempo transcurrido entre la recepción del último byte del escáner en el puerto serie y el despacho de la solicitud `/reception/verify` debe ser inferior a **50 milisegundos**. 1. **Latencia de Captura**: El tiempo transcurrido entre la recepción del último byte del escáner en cualquiera de los 4 puertos serie y el despacho de la solicitud `/reception/verify` debe ser inferior a **50 milisegundos**.
2. **Seguridad y Permisos**: La comunicación serie solo se ejecuta en contextos de origen seguro (`HTTPS` o `localhost`), respetando estrictamente el modelo de permisos explícitos de usuario de la Web Serial API de Chromium. 2. **Seguridad y Permisos**: La comunicación serie solo se ejecuta en contextos de origen seguro (`HTTPS` o `localhost`), respetando estrictamente el modelo de permisos explícitos de usuario de la Web Serial API de Chromium.
3. **Resiliencia ante Streams Abruptos**: El lector de stream serial no debe colgar el hilo principal de renderizado de la UI; debe implementarse con `ReadableStreamDefaultReader` asíncrono y control `try...finally` para liberar el bloqueo (`releaseLock()`). 3. **Resiliencia ante Streams Abruptos**: El lector de stream serial no debe colgar el hilo principal de renderizado de la UI; debe implementarse con `ReadableStreamDefaultReader` asíncrono y control `try...finally` para liberar el bloqueo (`releaseLock()`).
4. **Tolerancia a Separadores en DNI**: El parser de DNI debe soportar indistintamente separadores de comillas dobles (`"`) y arrobas (`@`), así como terminadores `\r`, `\n` o espacios en blanco residuales.
--- ---
## 6. Criterios de Aceptación y Validación ## 6. Criterios de Aceptación y Validación
- [ ] En Google Chrome o Edge en Windows, el botón "Configurar COM" abre el selector de dispositivos nativo del sistema operativo. - [ ] La consola de recepción permite conectar hasta 4 lectores seriales COM independientes con indicadores individuales de estado.
- [ ] Al seleccionar un lector o conversor USB-Serial (ej. Prolific, FTDI, CH340, Honeywell, Zebra), el badge cambia a "COM Conectado" con pulso verde. - [ ] Al escanear desde cualquiera de los 4 lectores COM, el sistema captura y valida el código inmediatamente.
- [ ] Al escanear una credencial QR con la pistola conectada al puerto serie, la consola registra el ingreso inmediatamente sin necesidad de tener el cursor en el input de texto. - [ ] Al escanear cualquiera de los 6 formatos de ejemplo de DNI argentino (2009, 2012, 2026, Mi Argentina, prefijos F/M), el sistema extrae el número de documento y datos de identidad con 100% de precisión.
- [ ] Al desconectar físicamente el cable USB, el sistema no lanza excepciones no controladas y vuelve al estado USB-HID. - [ ] Si el titular del DNI está registrado en UniCABA, el sistema muestra sus clases de hoy y su estado regular/activo.
- [ ] En navegadores no Chromium (Firefox), la aplicación no presenta errores de consola y mantiene el funcionamiento por emulación de teclado USB HID. - [ ] Si el titular del DNI no está registrado, el sistema notifica el DNI y nombre leídos sin error de sintaxis ni bloqueo.
- [ ] Al desconectar físicamente cualquiera de los lectores serie, el slot correspondiente pasa a desconectado sin afectar a los otros lectores.
@@ -38,3 +38,20 @@
- `pytest tests/` pasa exitosamente con 0 fallos. - `pytest tests/` pasa exitosamente con 0 fallos.
- La versión se incrementa a `3.8.50`. - La versión se incrementa a `3.8.50`.
- El despliegue en `10.0.0.217` devuelve HTTP 200 en `/version`. - 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.