From b10fc14152b17b86e0374c09840cc3c2bc60966e Mon Sep 17 00:00:00 2001 From: Carlos Tello Date: Wed, 28 Oct 2026 15:59:23 -0300 Subject: [PATCH] fix(reception): eliminacion de fondos graficos invasivos y correccion definitiva en resolucion de DNI v3.8.56 --- CHANGELOG.md | 12 +++ MEMORY.md | 12 ++- backend/app/__init__.py | 2 +- backend/app/services/argentine_dni_parser.py | 10 ++- backend/app/services/qr_security_service.py | 79 ++++++++++++++------ backend/setup.py | 2 +- backend/tests/test_dni_parser.py | 14 ++++ frontend/package.json | 2 +- frontend/src/app.js | 6 +- frontend/views/reception/scanner.html | 61 +++++---------- 10 files changed, 119 insertions(+), 81 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 61c0a81..c0a4667 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,18 @@ 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. - **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción. +## [3.8.56] - 2026-10-28 +### Fixed & Enhanced (Eliminación de Fondos Gráficos Invasivos y Corrección Definitiva en Resolución Universal de DNI) +- **Eliminación Total de Fondos Gráficos Invasivos en Recepción (`/reception/scanner`)**: + - Se removió por completo la marca de agua `bg_course-card.png` que generaba un recuadro rosado recortado antiestético en la ficha de validación. + - Se eliminó el degradado forzado `square_course_name.png` en el encabezado de resultado (`resultHeader`), devolviendo la cabecera limpia, nativa y perfectamente integrada con los temas claro y oscuro del sistema. + - Se retiró el isotipo `mini_logo_icon.png` del título del lector, preservando la iconografía SVG limpia y sobria de Edu-Space. +- **Corrección Crítica en Resolución de DNI (Bug de Interceptación por Puntos JWT)**: + - **Falsa Detección de JWT Erradicada**: Anteriormente cualquier código con dos puntos (`count('.') == 2`), tales como DNIs con formato de miles `34.247.025` o fechas de emisión/nacimiento `09.02.89` en códigos de barras Renaper, era interceptado erróneamente por el validador JWT y abortaba con error de firma inválida. Ahora solo se procesa como JWT si posee estructura Base64URL real (`eyJ...` o 3 bloques alfanuméricos puros) y ante fallo sintáctico continúa de inmediato con los métodos de resolución de DNI. + - **Soporte Universal de Prefijos DNI**: `limpiar_numero_documento` y `parsear_dni` ahora filtran prefijos habituales (`DNI:`, `DNI `, `D.N.I.`, `DOC:`) y toleran delimitadores adicionales como `;`. + - **Protección de Caracteres en Nombres**: La sustitución de `Ñ` por `:` (teclados con mapa de caracteres en español) ahora se restringe exclusivamente a prefijos de protocolo institucional (`UNICABAÑ`, `ÑUSRÑ`, `ÑDNIÑ`), preservando intactos los apellidos o nombres con `Ñ` (ej. Piñero, Peña, Núñez). + - **Auto-recuperación y Asociación de Documento**: Si el escaneo de DNI físico contiene nombre y apellido y no coincide con el número exacto, se resuelve por coincidencia nominal y se vincula automáticamente el documento al registro del usuario en la base de datos. + ## [3.8.55] - 2026-10-28 ### Added & Enhanced (Ergonomía de Recepción, Auto-foco Opcional, COM Contraíble, Recursos Gráficos y Contrastes Dark Mode) - **Reorganización Ergonómica de la Consola de Recepción (`/reception/scanner`)**: diff --git a/MEMORY.md b/MEMORY.md index 5dab935..34f1b99 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -9,13 +9,11 @@ Memoria del proyecto entre sesiones para la rama `dev`. - Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables. - 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. -- **Sprint Activo: Ergonomía de Recepción, Auto-foco Opcional, COM Contraíble, Recursos Gráficos y Contrastes Dark Mode (v3.8.55)**: - - **Reorganización del Puesto de Control en `/reception/scanner`**: Columna izquierda consolidada con lector óptico USB e historial cronológico de últimos accesos en sede; columna derecha con tarjeta ampliada de validación y panel de configuración de puertos COM. - - **Control de Foco no Invasivo**: Auto-foco desactivado por defecto (evita secuestrar el cursor cada 2 segundos); botón interactivo toggle (`#btnToggleAutoFocus`) para activarlo/desactivarlo a demanda del operador. - - **Puertos COM Minimizables**: Configuración de hardware serie contraída por defecto con indicador chevron animado y resumen de estado `0 / 4 Activos`. - - **Recursos Gráficos Sutiles**: Incorporación de `mini_logo_icon.png` en el lector, `square_course_name.png` en el header de validación y `bg_course-card.png` como marca de agua botánica. - - **Optimización de Contrastes en Modo Oscuro (WCAG AA)**: Adaptación completa de colores para evitar textos ilegibles o fondos blancos sobre tema oscuro. - - **Versión Consolidada**: `v3.8.55`. +- **Sprint Activo: Eliminación de Fondos Invasivos y Corrección Definitiva en Resolución Universal de DNI (v3.8.56)**: + - **Eliminación Total de Fondos Gráficos Invasivos**: Se retiraron `bg_course-card.png`, `square_course_name.png` y `mini_logo_icon.png` de la consola de recepción, dejando la UI limpia, sobria, sin recuadros recortados y con máxima nitidez. + - **Corrección Crítica en Resolución de DNI (Bug de Interceptación por Puntos)**: Se solucionó el problema donde cualquier entrada con dos puntos (ej. `34.247.025` o fechas de emisión/nacimiento `09.02.89` en códigos de barras Renaper) era catalogada como JWT y abortaba con error de firma. Ahora se exige estructura Base64URL pura y en caso de error continúa con la resolución de DNI. + - **Soporte de Prefijos y Caracteres**: Manejo universal de prefijos `DNI:`, delimitadores `;` y protección de la letra `Ñ` en apellidos y nombres. + - **Versión Consolidada**: `v3.8.56`. ## 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. diff --git a/backend/app/__init__.py b/backend/app/__init__.py index f0024ab..9510b8c 100644 --- a/backend/app/__init__.py +++ b/backend/app/__init__.py @@ -7,7 +7,7 @@ from typing import Any from database import db, get_db, engine, SessionLocal, session from config.config import Config -__version__ = "3.8.55" +__version__ = "3.8.56" class DummyContext: def __enter__(self): diff --git a/backend/app/services/argentine_dni_parser.py b/backend/app/services/argentine_dni_parser.py index 79c923b..c946850 100644 --- a/backend/app/services/argentine_dni_parser.py +++ b/backend/app/services/argentine_dni_parser.py @@ -13,7 +13,11 @@ def limpiar_numero_documento(doc_raw: str) -> Tuple[str, Optional[str]]: if not doc_raw: return "", None doc_clean = doc_raw.strip() - doc_sin_puntos = doc_clean.replace('.', '').replace(',', '').replace(' ', '') + + # Limpiar prefijos comunes como 'DNI:', 'DNI ', 'D.N.I.:', 'D.N.I. ', 'DOC:', 'DOCUMENTO:' + doc_clean = re.sub(r'^(?:DNI|D\.N\.I\.|DOC|DOCUMENTO)[\s\:\-\.]*', '', doc_clean, flags=re.IGNORECASE).strip() + + doc_sin_puntos = doc_clean.replace('.', '').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) @@ -42,8 +46,8 @@ def parsear_dni(raw_text: str) -> Dict[str, str]: # Limpiar terminadores y retornos de carro raw_clean = raw_text.strip().replace('\r', '').replace('\n', '') - # Algunos escáneres o formatos vienen separados por @, comillas simples ' o barras | - text = raw_clean.replace('@', '"').replace("'", '"').replace('´', '"').replace('|', '"') + # Algunos escáneres o formatos vienen separados por @, comillas simples ', barras | o punto y coma ; + text = raw_clean.replace('@', '"').replace("'", '"').replace('´', '"').replace('|', '"').replace(';', '"') parts = text.split('"') # Limpiar espacios de cada segmento diff --git a/backend/app/services/qr_security_service.py b/backend/app/services/qr_security_service.py index af84dba..7f0c7d9 100644 --- a/backend/app/services/qr_security_service.py +++ b/backend/app/services/qr_security_service.py @@ -76,16 +76,29 @@ class QRSecurityService: clean = raw_input.strip() - # Normalizar pistola óptica en teclado en español: - # Los lectores ópticos emulan teclado US, por lo que envían 'Ñ' en lugar de ':' en sistemas operativos con distribución en español. - clean_normalized = clean.replace("Ñ", ":").replace("ñ", ":") + # Normalizar prefijos de lectores ópticos en teclados con distribución en español: + # Los lectores ópticos envían 'Ñ' en lugar de ':' en sistemas operativos con distribución en español cuando leen códigos UNICABA. + clean_upper = clean.upper() + if "UNICABAÑ" in clean_upper or "ÑUSRÑ" in clean_upper or "ÑDNIÑ" in clean_upper or clean_upper.startswith("USRÑ") or clean_upper.startswith("DNIÑ"): + clean_normalized = clean.replace("Ñ", ":").replace("ñ", ":") + else: + clean_normalized = clean # Si viene con prefijo UNICABA:QR: if clean_normalized.startswith("UNICABA:QR:"): clean_normalized = clean_normalized[len("UNICABA:QR:"):].strip() - # 1. Intentar validar como JWT criptográfico institucional primero - if clean_normalized.count(".") == 2: + # 1. Intentar validar como JWT criptográfico institucional ÚNICAMENTE si tiene formato Base64URL de JWT + # Un JWT institucional de UniCABA típicamente comienza con 'eyJ' o sus 3 segmentos son Base64URL puros + is_potential_jwt = False + if clean_normalized.startswith("eyJ") and clean_normalized.count(".") == 2: + is_potential_jwt = True + elif clean_normalized.count(".") == 2: + jwt_parts = clean_normalized.split(".") + if len(jwt_parts) == 3 and all(re.match(r'^[A-Za-z0-9_-]+$', p) for p in jwt_parts): + is_potential_jwt = True + + if is_potential_jwt: try: payload = jwt.decode( clean_normalized, @@ -93,24 +106,23 @@ class QRSecurityService: algorithms=["HS256"], options={"verify_exp": True} ) - if payload.get("type") != cls.QR_TOKEN_TYPE: - return None, "DENEGADO", "El token no corresponde a una credencial institucional válida." + if payload.get("type") == cls.QR_TOKEN_TYPE: + user_id = payload.get("sub") + user = User.query.get(int(user_id)) if user_id else None + if not user: + return None, "DENEGADO", "Usuario no encontrado en la base de datos." - user_id = payload.get("sub") - user = User.query.get(int(user_id)) if user_id else None - if not user: - return None, "DENEGADO", "Usuario no encontrado en la base de datos." + if not user.is_active: + return user, "RESTRINGIDO", "La cuenta del usuario se encuentra inactiva o suspendida." - if not user.is_active: - return user, "RESTRINGIDO", "La cuenta del usuario se encuentra inactiva o suspendida." - - return user, "AUTORIZADO", "Credencial institucional válida y activa." + return user, "AUTORIZADO", "Credencial institucional válida y activa." except jwt.ExpiredSignatureError: return None, "DENEGADO", "La credencial digital ha expirado (anti-captura activo). Renueve el código en la pantalla del usuario." - except jwt.PyJWTError as e: - return None, "DENEGADO", f"Firma criptográfica inválida: {str(e)}" + except jwt.PyJWTError: + # Si falló la firma o decodificación, NO abortar: continuar con los métodos de DNI y fallback + pass - # 2. Formatos fallback (cuando no es un JWT): + # 2. Formatos fallback (DNI Argentino, USR:, DNI: y entrada directa): # A. Intentar extraer patrón institucional UNICABA:USR: usr_match = re.search(r"USR:(\d+)", clean_normalized) if usr_match: @@ -126,18 +138,23 @@ class QRSecurityService: pass # B. Intentar extraer patrón institucional DNI: - dni_match = re.search(r"DNI:([a-zA-Z0-9]+)", clean_normalized) + dni_match = re.search(r"DNI:([a-zA-Z0-9\.\-]+)", clean_normalized, flags=re.IGNORECASE) if dni_match: - doc = dni_match.group(1).strip() - if doc and doc.upper() != "N/A": - user_by_dni = User.query.filter_by(document_number=doc).first() + raw_doc_match = dni_match.group(1).replace(".", "").replace("-", "").strip() + if raw_doc_match and raw_doc_match.upper() != "NA": + user_by_dni = User.query.filter( + or_( + User.document_number == raw_doc_match, + func.replace(User.document_number, ".", "") == raw_doc_match + ) + ).first() if user_by_dni: if not user_by_dni.is_active: 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 {raw_doc_match})." # C. Reconocimiento universal de DNI Argentino (Formatos Renaper 2009, 2012, 2026, Mi Argentina y PDF417 / QR) - dni_info = parsear_dni(clean_normalized) + dni_info = parsear_dni(clean_normalized) or parsear_dni(clean) if dni_info and dni_info.get("documento"): doc = dni_info["documento"].strip() doc_stripped = doc.lstrip("0") or doc @@ -152,6 +169,20 @@ class QRSecurityService: ) ).first() + # Resiliencia: si no se encontró por DNI exacto pero se extrajo nombre y apellido del DNI oficial + if not user_by_dni and dni_info.get("apellido") and dni_info.get("nombre"): + first_name = dni_info["nombre"].split()[0] + user_by_dni = User.query.filter( + User.name.ilike(f"%{dni_info['apellido']}%"), + User.name.ilike(f"%{first_name}%") + ).first() + if user_by_dni and not user_by_dni.document_number: + try: + user_by_dni.document_number = doc + db.session.commit() + except Exception: + pass + 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})." diff --git a/backend/setup.py b/backend/setup.py index 8d87872..43cc9d2 100644 --- a/backend/setup.py +++ b/backend/setup.py @@ -2,7 +2,7 @@ from setuptools import setup, find_packages setup( name="edu-space-admin", - version="3.8.55", + version="3.8.56", description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)", author="Edu-Space Development Team", author_email="admin@edu-space.com", diff --git a/backend/tests/test_dni_parser.py b/backend/tests/test_dni_parser.py index 8958d05..dfffcb7 100644 --- a/backend/tests/test_dni_parser.py +++ b/backend/tests/test_dni_parser.py @@ -145,3 +145,17 @@ def test_qr_security_service_resolves_dni_with_dots_and_stripping(app, init_data assert resolved.id == u.id assert st == "AUTORIZADO" + # Escanear con prefijo 'DNI: 45.123.456' + res_prefixed, st_p, _ = QRSecurityService.decode_and_resolve_user('DNI: 45.123.456') + assert res_prefixed is not None + assert res_prefixed.id == u.id + assert st_p == "AUTORIZADO" + + # Escanear formato 2026 con fechas que contienen puntos (2 puntos en total: NO debe confundirse con JWT) + token_with_dots = '00749743816@PUNTOS@ESTUDIANTE@45123456@G@09.02.89@23.04.26' + res_dots, st_d, _ = QRSecurityService.decode_and_resolve_user(token_with_dots) + assert res_dots is not None + assert res_dots.id == u.id + assert st_d == "AUTORIZADO" + + diff --git a/frontend/package.json b/frontend/package.json index 0ab84bf..c29b152 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,6 +1,6 @@ { "name": "frontend", - "version": "3.8.55", + "version": "3.8.56", "description": "", "main": "index.js", "scripts": { diff --git a/frontend/src/app.js b/frontend/src/app.js index 5cc0286..536efd2 100644 --- a/frontend/src/app.js +++ b/frontend/src/app.js @@ -86,9 +86,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), { }); // Versiones institucionales del sistema -const APP_VERSION = '3.8.55'; -const FRONTEND_VERSION = '3.8.55'; -const BACKEND_VERSION = '3.8.55'; +const APP_VERSION = '3.8.56'; +const FRONTEND_VERSION = '3.8.56'; +const BACKEND_VERSION = '3.8.56'; env.addGlobal('app_version', APP_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION); diff --git a/frontend/views/reception/scanner.html b/frontend/views/reception/scanner.html index 6231908..8f2d8b4 100644 --- a/frontend/views/reception/scanner.html +++ b/frontend/views/reception/scanner.html @@ -40,12 +40,9 @@
-
- Icono -
- Lector Óptico de Acceso -
-
+
+ Lector Óptico de Acceso +
Manual @@ -148,28 +145,28 @@
- -
-
- Esperando lectura... + +
+
+ Esperando lectura...
¡Nuevo Escaneo! - --:-- + --:--
- -
+ +
-

Apunta el lector óptico a la credencial

+

Apunta el lector óptico a la credencial o ingresa el DNI

- Al detectar la credencial dinámica o física del alumno o docente, el sistema mostrará instantáneamente sus datos de ingreso y las aulas donde cursa hoy. + Al detectar la credencial dinámica o física del alumno o docente (o al tipear su DNI), el sistema mostrará instantáneamente sus datos de ingreso y las aulas donde cursa hoy.

@@ -578,7 +575,10 @@ focusScannerInput(); return; } - val = val.replace(/Ñ/g, ':').replace(/ñ/g, ':'); + // Solo normalizar Ñ por : si el código contiene prefijos de protocolo institucional (UNICABA, USR, DNI) + if (/^(UNICABA|USR|DNI)ñ/i.test(val) || /UNICABAÑ|ÑUSRÑ|ÑDNIÑ/i.test(val)) { + val = val.replace(/Ñ/g, ':').replace(/ñ/g, ':'); + } verifyToken(val); input.value = ''; if (isAutoFocusActive) { @@ -649,7 +649,7 @@ // AUTORIZADO CON CLASES HOY -> VERDE INSTITUCIONAL resultCard.className = 'card border-2 border-success shadow-lg rounded-4 overflow-hidden mb-4 animate-scan-success result-validation-card'; resultCard.style.backgroundColor = ''; - cardHeader.className = 'card-header py-3 px-4 bg-success text-white border-0 d-flex align-items-center justify-content-between header-course-banner'; + cardHeader.className = 'card-header py-3 px-4 bg-success text-white border-0 d-flex align-items-center justify-content-between'; statusText.innerHTML = ' ACCESO AUTORIZADO — TIENE CLASE HOY'; timeBadge.className = 'badge bg-white text-success rounded-pill px-3 py-1 font-monospace fw-bold'; matriculaBadge.className = 'badge bg-success rounded-pill px-3 py-1 mb-1 me-1'; @@ -659,7 +659,7 @@ // AUTORIZADO PERO SIN CLASES HOY -> ÁMBAR resultCard.className = 'card border-2 border-warning shadow-lg rounded-4 overflow-hidden mb-4 animate-scan-warning result-validation-card'; resultCard.style.backgroundColor = ''; - cardHeader.className = 'card-header py-3 px-4 bg-warning text-dark border-0 d-flex align-items-center justify-content-between fw-bold header-course-banner'; + cardHeader.className = 'card-header py-3 px-4 bg-warning text-dark border-0 d-flex align-items-center justify-content-between fw-bold'; statusText.innerHTML = ' ACCESO AUTORIZADO — SIN CLASES PROGRAMADAS HOY'; timeBadge.className = 'badge bg-dark text-white rounded-pill px-3 py-1 font-monospace'; matriculaBadge.className = 'badge bg-success rounded-pill px-3 py-1 mb-1 me-1'; @@ -669,7 +669,7 @@ } else if (data.status === 'RESTRINGIDO') { resultCard.className = 'card border-2 border-warning shadow-lg rounded-4 overflow-hidden mb-4 animate-scan-warning result-validation-card'; resultCard.style.backgroundColor = ''; - cardHeader.className = 'card-header py-3 px-4 bg-warning text-dark border-0 d-flex align-items-center justify-content-between fw-bold header-course-banner'; + cardHeader.className = 'card-header py-3 px-4 bg-warning text-dark border-0 d-flex align-items-center justify-content-between fw-bold'; statusText.innerHTML = ' ACCESO OBSERVADO / RESTRINGIDO'; timeBadge.className = 'badge bg-dark text-white rounded-pill px-3 py-1 font-monospace'; matriculaBadge.className = 'badge bg-warning text-dark rounded-pill px-3 py-1 mb-1'; @@ -679,7 +679,7 @@ // DENEGADO -> ROJO resultCard.className = 'card border-2 border-danger shadow-lg rounded-4 overflow-hidden mb-4 animate-scan-danger result-validation-card'; resultCard.style.backgroundColor = ''; - cardHeader.className = 'card-header py-3 px-4 bg-danger text-white border-0 d-flex align-items-center justify-content-between header-course-banner'; + cardHeader.className = 'card-header py-3 px-4 bg-danger text-white border-0 d-flex align-items-center justify-content-between'; statusText.innerHTML = ' ACCESO DENEGADO'; timeBadge.className = 'badge bg-white text-danger rounded-pill px-3 py-1 font-monospace fw-bold'; matriculaBadge.className = 'badge bg-danger rounded-pill px-3 py-1 mb-1'; @@ -899,23 +899,6 @@ 100% { transform: scale(0.9); box-shadow: 0 0 0 0 rgba(34, 197, 94, 0); } } - /* Recursos Gráficos Sutiles: Banner de Cabecera y Marca de Agua Botánica */ - .header-course-banner { - background-image: linear-gradient(135deg, rgba(30, 27, 75, 0.92) 0%, rgba(67, 56, 202, 0.85) 60%, rgba(180, 62, 142, 0.90) 100%), - url('/img/square_course_name.png'); - background-size: cover; - background-position: center right; - } - - .result-body-watermark { - position: relative; - background-image: url('/img/bg_course-card.png'); - background-repeat: no-repeat; - background-position: bottom right; - background-size: 260px auto; - background-blend-mode: overlay; - } - /* Animaciones de Flash de Escaneo */ @keyframes scan-flash-success { 0% { transform: scale(0.99); box-shadow: 0 0 0 0 rgba(34, 197, 94, 0.8); } @@ -983,10 +966,6 @@ border-color: rgba(255, 255, 255, 0.08) !important; } - [data-bs-theme="dark"] .result-body-watermark { - background-blend-mode: screen; - opacity: 0.98; - } [data-bs-theme="dark"] #recentLogsTable thead, [data-bs-theme="dark"] #recentLogsTable thead th {