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.