From 845f6e160eff33d72828eb7b7a9a15597b81f11b Mon Sep 17 00:00:00 2001 From: Carlos Tello Date: Wed, 28 Oct 2026 16:08:04 -0300 Subject: [PATCH] docs: actualizar README.md con recepcion, serial com y dni 2026, y optimizar buffer serial --- README.md | 31 +++++++++++++++++++++++++++- frontend/public/js/serial-scanner.js | 12 +++++++---- 2 files changed, 38 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index c967901..df74dfb 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ Plataforma integral de gestión áulica, asignación de espacios, control de hor El proyecto se basa en una arquitectura **desacoplada (Frontend / Backend)** en formato monorepo. -**Versión Actual:** `3.5.7` (Principio 11: Estándares Modernos de APIs, Pydantic e Integración de IA) +**Versión Actual:** `3.8.56` (Control de Acceso QR / DNI, Multi-Serial COM, RAG UdeCi y Modo Oscuro) **Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA) **Entorno de Producción:** `https://eduspace.oemspot.com.ar` (LXC `10.0.0.217`) @@ -177,6 +177,35 @@ La asignación puede realizarse desde dos puntos de entrada según la necesidad --- +## 🪪 Consola de Recepción & Escáner QR, Hardware COM y Reconocimiento de DNI + +La plataforma incorpora una consola operativa integral de control de accesos en tiempo real para personal de Recepción y Seguridad (`/reception/scanner`): + +### 1. Validación de Credencial Digital y Cronograma Áulico Instantáneo +* **Escaneo de Códigos QR Institucionales**: Decodificación de tokens criptográficos anti-captura emitidos por la aplicación (`/credential/my-card`). +* **Cronograma en Vivo del Día**: Al escanear una credencial o DNI, el sistema muestra instantáneamente el estado de matrícula del alumno o docente, la foto/inicial institucional, la comisión y el **aula física y piso asignado para el día de hoy** (ej. *Aula 204 — Piso 2, Edificio Central*). +* **Feedback Visual y Sonoro**: Señalización por colores (Verde con clases hoy, Ámbar sin clases hoy o restringido, Rojo denegado) junto con tonos de audio distintivos sintetizados mediante la Web Audio API. + +### 2. Soporte Multi-Lector por Puerto Serie COM (Web Serial API) +* **Hasta 4 Lectores Seriales Concurrentes**: Gestión de puertos serie físicos (`Lector 1 — Paso Principal`, `Lector 2 — Molinete`, `Lector 3 — Mesa Bedelía`, `Lector 4 — Auxiliar`). +* **Reconexión Automática Plug-and-Play**: Detección dinámica de desconexión y reconexión física de cables USB-Serial en Windows sin recargar el navegador. +* **Panel Colapsable Ergonómico**: El módulo de configuración de puertos COM se encuentra contraído por defecto con indicador resumen (`0 / 4 Activos`) para mantener despejada la vista de trabajo del operador. + +### 3. Reconocimiento Universal de DNI Argentino (Renaper & Mi Argentina) +* **Formatos Soportados**: + * **Renaper Formato 2026**: Códigos QR de alta densidad que incluyen datos patronímicos seguidos del JWT oficial de Renaper (`00749743816"TELLO"CARLOS FACUNDO"34247025"G"09-02-89"23-04-26"eyJ...`). + * **Renaper Formato 2012**: Códigos de barras PDF417 de DNIs tarjeta vigentes. + * **Renaper Formato 2009**: DNI libreta celeste o tarjeta inicial con prefijos alfabéticos `F` / `M` (Libreta Cívica / Enrolamiento). + * **App Mi Argentina**: Códigos QR con identificadores numéricos de género y documento. + * **Ingreso Directo**: Tipeado o pistola sobre número de documento con o sin puntos (`34.247.025`, `34247025`, `DNI: 34247025`). +* **Resiliencia Nominal**: Si un DNI físico es escaneado por primera vez y el usuario no tenía el número cargado en la base de datos, el sistema realiza vinculación asistida por coincidencia de nombre y apellido, asociando su documento de forma permanente. + +### 4. Ergonomía del Puesto y Modo Oscuro Accesible +* **Control de Foco no Invasivo**: El cursor no secuestra la pantalla; cuenta con un switch en cabecera (`Auto-foco: Inactivo` / `Auto-foco: Activo`) para activar la retención de foco solo cuando se requieran tandas intensivas de escaneo con pistola. +* **Diseño y Contraste WCAG AA**: Interfaz libre de recuadros o imágenes invasivas, optimizada con paletas nítidas en tema claro y modo oscuro profundo (`#17162E` / `#0E0D1D`) con bordes violetas institucionales `#8B5CF6`. + +--- + ## 📅 Ficha de Reserva & Gestión de Comisiones * **Ficha de Reserva Detallada (`/schedule/view_reservation?id={id}`):** Información completa del espacio físico o virtual asignado, capacidad y asistencia prevista, comisión académica vinculada, docente a cargo, botones de acción inmediata (*Modificar Reserva*, *Confirmar Reserva*, *Cancelar Reserva*) y acceso con un clic a la sala de videollamada. diff --git a/frontend/public/js/serial-scanner.js b/frontend/public/js/serial-scanner.js index 9c1610b..48fcaaa 100644 --- a/frontend/public/js/serial-scanner.js +++ b/frontend/public/js/serial-scanner.js @@ -268,7 +268,8 @@ slot.buffer = parts[parts.length - 1]; } - // 2. Timeout de seguridad: Si pasan 120ms sin nuevos caracteres y el buffer tiene longitud razonable, despachar + // 2. Timeout de seguridad: Si pasan 380ms sin nuevos caracteres y el buffer tiene longitud razonable, despachar + // (Permite que códigos largos de alta densidad como Renaper 2026 con más de 400 caracteres lleguen completos) if (slot.buffer.trim().length >= 4) { slot.bufferTimeout = setTimeout(() => { const code = slot.buffer.trim(); @@ -276,7 +277,7 @@ this._dispatchCode(slot, code); slot.buffer = ''; } - }, 120); + }, 380); } } @@ -286,8 +287,11 @@ slot.bufferTimeout = null; } - // Normalización tolerante de scancodes si el lector traduce : a Ñ en teclados en español - const cleanCode = code.replace(/Ñ/g, ':').replace(/ñ/g, ':'); + // Normalización tolerante: solo reemplazar Ñ por : si el código contiene etiquetas de protocolo institucional + let cleanCode = code; + if (/^(UNICABA|USR|DNI)ñ/i.test(code) || /UNICABAÑ|ÑUSRÑ|ÑDNIÑ/i.test(code)) { + cleanCode = code.replace(/Ñ/g, ':').replace(/ñ/g, ':'); + } slot.lastCode = cleanCode; slot.lastScannedAt = new Date();