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:
@@ -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`)**:
|
||||||
|
|||||||
@@ -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.
|
||||||
|
|||||||
@@ -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
@@ -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",
|
||||||
|
|||||||
@@ -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,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": {
|
||||||
|
|||||||
@@ -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
@@ -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);
|
||||||
|
|||||||
@@ -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">
|
||||||
|
|||||||
@@ -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.
|
|
||||||
|
|||||||
@@ -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.
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user