feat(reception): add multi-serial scanner for up to 4 COM ports and universal Argentine DNI parser (v3.8.52)
This commit is contained in:
@@ -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.51"
|
||||
__version__ = "3.8.52"
|
||||
|
||||
class DummyContext:
|
||||
def __enter__(self):
|
||||
|
||||
@@ -0,0 +1,166 @@
|
||||
import re
|
||||
from typing import Tuple, Optional, Dict
|
||||
|
||||
|
||||
def limpiar_numero_documento(doc_raw: str) -> Tuple[str, Optional[str]]:
|
||||
"""
|
||||
Limpia y normaliza un número de documento DNI argentino.
|
||||
En formatos antiguos (Libreta Cívica, Libreta de Enrolamiento o Formato 2009),
|
||||
el documento suele estar precedido por 'F' (Femenino) o 'M' (Masculino),
|
||||
por ejemplo: 'F5592570' -> ('5592570', 'F'), 'M34247025' -> ('34247025', 'M').
|
||||
Retorna (documento_numerico, sexo_inferido).
|
||||
"""
|
||||
if not doc_raw:
|
||||
return "", None
|
||||
doc_clean = str(doc_raw).strip()
|
||||
doc_sin_puntos = doc_clean.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)
|
||||
if m:
|
||||
return m.group(2), m.group(1).upper()
|
||||
|
||||
# Si contiene dígitos precedidos por F/M con posibles espacios o puntos
|
||||
m2 = re.match(r'^([FMfm])[\s\.]*(\d{5,9})$', doc_clean)
|
||||
if m2:
|
||||
return m2.group(2), m2.group(1).upper()
|
||||
|
||||
return doc_sin_puntos if doc_sin_puntos.isdigit() else doc_clean, None
|
||||
|
||||
|
||||
def parsear_dni(raw_text: str) -> Dict[str, str]:
|
||||
"""
|
||||
Parsea la cadena de texto cruda obtenida de un escáner de código de barras/QR de un DNI argentino.
|
||||
Soporta los formatos 2009, 2012, 2026 y App Mi Argentina.
|
||||
|
||||
Retorna un diccionario con las llaves: 'documento', 'apellido', 'nombre', 'sexo'
|
||||
o un diccionario vacío si no corresponde a un documento de identidad argentino.
|
||||
"""
|
||||
if not raw_text:
|
||||
return {}
|
||||
|
||||
# Limpiar terminadores y retornos de carro
|
||||
raw_clean = str(raw_text).strip().replace('\r', '').replace('\n', '')
|
||||
|
||||
# Algunos escáneres o formatos vienen separados por @ en lugar de comillas dobles
|
||||
text = raw_clean.replace('@', '"')
|
||||
parts = text.split('"')
|
||||
|
||||
# Limpiar espacios de cada segmento
|
||||
parts = [p.strip() for p in parts]
|
||||
|
||||
if len(parts) < 5:
|
||||
# Si es un ingreso directo de DNI (escaneado de tarjeta de código de barras 1D o tipeado)
|
||||
doc_limpio, sexo_inf = limpiar_numero_documento(raw_clean)
|
||||
if doc_limpio and doc_limpio.isdigit() and 5 <= len(doc_limpio) <= 9:
|
||||
return {
|
||||
"documento": doc_limpio,
|
||||
"apellido": "",
|
||||
"nombre": "",
|
||||
"sexo": sexo_inf or "M"
|
||||
}
|
||||
return {}
|
||||
|
||||
doc = nombre = apellido = sexo = ""
|
||||
|
||||
# Heurística para Formato 2009 con comilla inicial
|
||||
# Ej: "34247025"A"1"TELLO"CARLOS FACUNDO"...
|
||||
# Ej: "F5592570 "A"1"SAUCEDO"TERESA DE JESUS"...
|
||||
if parts[0] == '' and 6 <= len(parts[1]) <= 11 and len(parts) > 2 and parts[2].isalpha() and len(parts[2]) == 1:
|
||||
doc = parts[1]
|
||||
if len(parts) > 4:
|
||||
apellido = parts[4]
|
||||
if len(parts) > 5:
|
||||
nombre = parts[5]
|
||||
# Búsqueda de sexo en posiciones subsiguientes (índices 6 a 9)
|
||||
for idx in range(6, min(len(parts), 10)):
|
||||
val = parts[idx].upper()
|
||||
if val in ("M", "F", "X"):
|
||||
sexo = val
|
||||
break
|
||||
|
||||
# Heurística para Formato 2009 sin comilla inicial
|
||||
# Ej: 34247025"A"1"TELLO"CARLOS FACUNDO...
|
||||
# Ej: F5592570"A"1"SAUCEDO"TERESA DE JESUS...
|
||||
elif 6 <= len(parts[0]) <= 11 and len(parts) > 4 and parts[1].isalpha() and len(parts[1]) == 1:
|
||||
doc = parts[0]
|
||||
apellido = parts[3]
|
||||
nombre = parts[4]
|
||||
for idx in range(5, min(len(parts), 9)):
|
||||
val = parts[idx].upper()
|
||||
if val in ("M", "F", "X"):
|
||||
sexo = val
|
||||
break
|
||||
|
||||
# Heurística para Formatos 2012, 2026 y App Mi Argentina (Comienzan con número de trámite >= 8 dígitos)
|
||||
else:
|
||||
# Si la cadena comenzó con comilla/arroba y no es formato 2009, normalizamos descartando el elemento vacío inicial
|
||||
if parts[0] == '' and len(parts) > 1:
|
||||
parts = parts[1:]
|
||||
|
||||
if parts[0].isdigit() and len(parts[0]) >= 8:
|
||||
apellido = parts[1] if len(parts) > 1 else ""
|
||||
nombre = parts[2] if len(parts) > 2 else ""
|
||||
|
||||
if len(parts) > 3:
|
||||
p3 = parts[3].strip()
|
||||
p4 = parts[4].strip() if len(parts) > 4 else ""
|
||||
|
||||
# Caso 1: Formato 2012 (parts[3] es letra de sexo M, F, X)
|
||||
# 00680051210"TELLO"CARLOS FACUNDO"M"34247025...
|
||||
if len(p3) == 1 and p3.upper() in ("M", "F", "X"):
|
||||
sexo = p3.upper()
|
||||
if len(parts) > 4:
|
||||
doc = p4
|
||||
|
||||
# Caso 2: Formato App Mi Argentina (parts[3] es código numérico de sexo 1=M, 2=F, 3=X)
|
||||
# y parts[4] es el DNI numérico (6 a 9 dígitos)
|
||||
# Ej: 00305336518@CIRILLI@GEORGINA SUSANA@2@28988082@A@23/08/1981@13/10/2014
|
||||
# Ej: 00680051210@TELLO@Carlos Facundo@1@34247025@F@09/02/1989@13/10/2021
|
||||
elif p3 in ("1", "2", "3", "0") and p4.isdigit() and 6 <= len(p4) <= 9:
|
||||
if p3 == "1":
|
||||
sexo = "M"
|
||||
elif p3 == "2":
|
||||
sexo = "F"
|
||||
else:
|
||||
sexo = "X"
|
||||
doc = p4
|
||||
|
||||
# Caso 3: Formato 2026 (parts[3] es directamente el DNI de 6 a 9 dígitos)
|
||||
# y parts[4] suele ser ejemplar o sexo alfabético (ej. 'G', 'F', 'M')
|
||||
# 00749743816"TELLO"CARLOS FACUNDO"34247025"G...
|
||||
elif p3.isdigit() and 6 <= len(p3) <= 9 and not (p4.isdigit() and 6 <= len(p4) <= 9):
|
||||
doc = p3
|
||||
if p4.upper() in ("M", "F", "X"):
|
||||
sexo = p4.upper()
|
||||
elif p4.upper() == "G":
|
||||
sexo = "M"
|
||||
|
||||
# Caso 4: Desempate general: si parts[4] es un DNI numérico válido de 6 a 9 dígitos
|
||||
elif p4.isdigit() and 6 <= len(p4) <= 9:
|
||||
doc = p4
|
||||
if p3 == "1":
|
||||
sexo = "M"
|
||||
elif p3 == "2":
|
||||
sexo = "F"
|
||||
elif p3.upper() in ("M", "F", "X"):
|
||||
sexo = p3.upper()
|
||||
else:
|
||||
# Fallback final
|
||||
doc = p3
|
||||
|
||||
# Normalización del documento extraído (eliminación de prefijos F/M en DNI viejo)
|
||||
doc_limpio, sexo_doc = limpiar_numero_documento(doc)
|
||||
doc = doc_limpio
|
||||
if not sexo and sexo_doc:
|
||||
sexo = sexo_doc
|
||||
|
||||
if not doc or not doc.isdigit() or not (5 <= len(doc) <= 9):
|
||||
return {}
|
||||
|
||||
return {
|
||||
"documento": doc.strip(),
|
||||
"apellido": apellido.upper() if apellido else "",
|
||||
"nombre": nombre.upper() if nombre else "",
|
||||
"sexo": sexo or "M"
|
||||
}
|
||||
@@ -17,6 +17,7 @@ from app.models.building import Building
|
||||
from app.models.enrollment import StudentEnrollment
|
||||
from app.models.subject import Commission, Subject
|
||||
from schemas.reception_dto import TodayClassDTO
|
||||
from app.services.argentine_dni_parser import parsear_dni
|
||||
|
||||
|
||||
class QRSecurityService:
|
||||
@@ -134,6 +135,28 @@ class QRSecurityService:
|
||||
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})."
|
||||
|
||||
# C. Reconocimiento universal de DNI Argentino (Formatos Renaper 2009, 2012, 2026, Mi Argentina y PDF417 / QR)
|
||||
dni_info = parsear_dni(clean_normalized)
|
||||
if dni_info and dni_info.get("documento"):
|
||||
doc = dni_info["documento"]
|
||||
user_by_dni = User.query.filter_by(document_number=doc).first()
|
||||
if not user_by_dni:
|
||||
user_by_dni = User.query.filter(
|
||||
(User.username == doc) | (User.email.like(f"{doc}@%"))
|
||||
).first()
|
||||
|
||||
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})."
|
||||
nombre_display = f"{dni_info.get('apellido', '')} {dni_info.get('nombre', '')}".strip()
|
||||
detalle = f"Identificación validada por DNI argentino {doc}" + (f" ({nombre_display})" if nombre_display else "")
|
||||
return user_by_dni, "AUTORIZADO", detalle
|
||||
else:
|
||||
nombre_display = f"{dni_info.get('apellido', '')} {dni_info.get('nombre', '')}".strip()
|
||||
if nombre_display:
|
||||
return None, "DENEGADO", f"DNI argentino {doc} ({nombre_display}) no se encuentra registrado en el padrón de UniCABA."
|
||||
return None, "DENEGADO", f"DNI argentino {doc} no se encuentra registrado en el padrón de UniCABA."
|
||||
|
||||
# D. Fallback: Lectura de pistola óptica o documento directo (ej: 'DNI:12345678' o '12345678')
|
||||
doc_num = clean_normalized
|
||||
if doc_num.upper().startswith("DNI:"):
|
||||
|
||||
+1
-1
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
|
||||
|
||||
setup(
|
||||
name="edu-space-admin",
|
||||
version="3.8.51",
|
||||
version="3.8.52",
|
||||
description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)",
|
||||
author="Edu-Space Development Team",
|
||||
author_email="admin@edu-space.com",
|
||||
|
||||
@@ -0,0 +1,90 @@
|
||||
import pytest
|
||||
from app.services.argentine_dni_parser import parsear_dni, limpiar_numero_documento
|
||||
|
||||
|
||||
def test_limpiar_numero_documento_variations():
|
||||
assert limpiar_numero_documento("F5592570") == ("5592570", "F")
|
||||
assert limpiar_numero_documento("M34247025") == ("34247025", "M")
|
||||
assert limpiar_numero_documento("f 5592570") == ("5592570", "F")
|
||||
assert limpiar_numero_documento("34.247.025") == ("34247025", None)
|
||||
assert limpiar_numero_documento("34247025") == ("34247025", None)
|
||||
|
||||
|
||||
def test_parsear_dni_ejemplo_1_formato_2026():
|
||||
raw = '00749743816"TELLO"CARLOS FACUNDO"34247025"G"09-02-89"23-04-26"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJpZF90cmFtaXRlIjoiNzQ5NzQzODE2In0.1JThZ0G'
|
||||
parsed = parsear_dni(raw)
|
||||
assert parsed["documento"] == "34247025"
|
||||
assert parsed["apellido"] == "TELLO"
|
||||
assert parsed["nombre"] == "CARLOS FACUNDO"
|
||||
assert parsed["sexo"] in ("M", "G")
|
||||
|
||||
|
||||
def test_parsear_dni_ejemplo_2_formato_2009_con_comillas():
|
||||
raw = '"20979166 "A"1"CASTIGLIONI"MARCELA ANALIA"ARGENTINA"20-07-1969"F"28-02-2011"00040202308"7006 "28-02-2026"296"0"ILRÑ2.01 CÑ110223.01'
|
||||
parsed = parsear_dni(raw)
|
||||
assert parsed["documento"] == "20979166"
|
||||
assert parsed["apellido"] == "CASTIGLIONI"
|
||||
assert parsed["nombre"] == "MARCELA ANALIA"
|
||||
assert parsed["sexo"] == "F"
|
||||
|
||||
|
||||
def test_parsear_dni_ejemplo_3_formato_mi_argentina_1():
|
||||
raw = '305336518"CIRILLI"GEORGINA SUSANA"2"28988082"A"23-08-1981"13-10-2014'
|
||||
parsed = parsear_dni(raw)
|
||||
assert parsed["documento"] == "28988082"
|
||||
assert parsed["apellido"] == "CIRILLI"
|
||||
assert parsed["nombre"] == "GEORGINA SUSANA"
|
||||
assert parsed["sexo"] == "F"
|
||||
|
||||
|
||||
def test_parsear_dni_ejemplo_4_formato_2012():
|
||||
raw = '00225303383"RIO"MARTINA"F"46585482"A"02-09-2005"19-10-2013'
|
||||
parsed = parsear_dni(raw)
|
||||
assert parsed["documento"] == "46585482"
|
||||
assert parsed["apellido"] == "RIO"
|
||||
assert parsed["nombre"] == "MARTINA"
|
||||
assert parsed["sexo"] == "F"
|
||||
|
||||
|
||||
def test_parsear_dni_ejemplo_5_formato_2009_con_f():
|
||||
raw = '"f5592570 "A"1"SAUCEDO"TERESA DE JESUS"ARGENTINA"16-02-1947"F"21-01-2012"00090833406"7020 "21-01-2027"206"0"'
|
||||
parsed = parsear_dni(raw)
|
||||
assert parsed["documento"] == "5592570"
|
||||
assert parsed["apellido"] == "SAUCEDO"
|
||||
assert parsed["nombre"] == "TERESA DE JESUS"
|
||||
assert parsed["sexo"] == "F"
|
||||
|
||||
|
||||
def test_parsear_dni_ejemplo_6_formato_mi_argentina_2():
|
||||
raw = '680051210"TELLO"Carlos Facundo"1"34247025"F"09-02-1989"13-10-2021'
|
||||
parsed = parsear_dni(raw)
|
||||
assert parsed["documento"] == "34247025"
|
||||
assert parsed["apellido"] == "TELLO"
|
||||
assert parsed["nombre"] == "CARLOS FACUNDO"
|
||||
assert parsed["sexo"] == "M"
|
||||
|
||||
|
||||
def test_parsear_dni_con_separadores_arroba():
|
||||
raw = '00305336518@CIRILLI@GEORGINA SUSANA@2@28988082@A@23/08/1981@13/10/2014'
|
||||
parsed = parsear_dni(raw)
|
||||
assert parsed["documento"] == "28988082"
|
||||
assert parsed["apellido"] == "CIRILLI"
|
||||
assert parsed["nombre"] == "GEORGINA SUSANA"
|
||||
assert parsed["sexo"] == "F"
|
||||
|
||||
|
||||
def test_parsear_dni_directo_o_invalido():
|
||||
assert parsear_dni("34247025") == {
|
||||
"documento": "34247025",
|
||||
"apellido": "",
|
||||
"nombre": "",
|
||||
"sexo": "M"
|
||||
}
|
||||
assert parsear_dni("F5592570") == {
|
||||
"documento": "5592570",
|
||||
"apellido": "",
|
||||
"nombre": "",
|
||||
"sexo": "F"
|
||||
}
|
||||
assert parsear_dni("") == {}
|
||||
assert parsear_dni("TEXTO_CORTO") == {}
|
||||
Reference in New Issue
Block a user