docs: actualizar README.md con recepcion, serial com y dni 2026, y optimizar buffer serial
This commit is contained in:
@@ -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.
|
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)
|
**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)
|
||||||
**Entorno de Producción:** `https://eduspace.oemspot.com.ar` (LXC `10.0.0.217`)
|
**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 & 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.
|
* **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.
|
||||||
|
|||||||
@@ -268,7 +268,8 @@
|
|||||||
slot.buffer = parts[parts.length - 1];
|
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) {
|
if (slot.buffer.trim().length >= 4) {
|
||||||
slot.bufferTimeout = setTimeout(() => {
|
slot.bufferTimeout = setTimeout(() => {
|
||||||
const code = slot.buffer.trim();
|
const code = slot.buffer.trim();
|
||||||
@@ -276,7 +277,7 @@
|
|||||||
this._dispatchCode(slot, code);
|
this._dispatchCode(slot, code);
|
||||||
slot.buffer = '';
|
slot.buffer = '';
|
||||||
}
|
}
|
||||||
}, 120);
|
}, 380);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -286,8 +287,11 @@
|
|||||||
slot.bufferTimeout = null;
|
slot.bufferTimeout = null;
|
||||||
}
|
}
|
||||||
|
|
||||||
// Normalización tolerante de scancodes si el lector traduce : a Ñ en teclados en español
|
// Normalización tolerante: solo reemplazar Ñ por : si el código contiene etiquetas de protocolo institucional
|
||||||
const cleanCode = code.replace(/Ñ/g, ':').replace(/ñ/g, ':');
|
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.lastCode = cleanCode;
|
||||||
slot.lastScannedAt = new Date();
|
slot.lastScannedAt = new Date();
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user