docs: actualizar README.md con recepcion, serial com y dni 2026, y optimizar buffer serial

This commit is contained in:
2026-10-28 16:08:04 -03:00
parent b10fc14152
commit 845f6e160e
2 changed files with 38 additions and 5 deletions
+30 -1
View File
@@ -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.
+8 -4
View File
@@ -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();