feat: complete Phases 2 to 5 inclusive - Access Core, Web Cockpit, Hardware enqueuing, Optical Scanner and QA (v0.5.0-beta)
This commit is contained in:
@@ -0,0 +1,121 @@
|
||||
# ==============================================================================
|
||||
# Servicio de Parseo y Normalización de DNI Argentino (PDF417 / QR)
|
||||
# Soporta formatos 2009, 2012, 2026 y App Mi Argentina
|
||||
# ==============================================================================
|
||||
from typing import Dict
|
||||
from pydantic import BaseModel
|
||||
|
||||
|
||||
class DNIParsedResult(BaseModel):
|
||||
valido: bool
|
||||
documento: str
|
||||
apellido: str
|
||||
nombre: str
|
||||
sexo: str
|
||||
|
||||
|
||||
class DniParserService:
|
||||
@staticmethod
|
||||
def parsear(raw_text: str) -> Dict[str, str]:
|
||||
"""
|
||||
Parsea el texto decodificado por la cámara de la tablet o escáner.
|
||||
Retorna: {"documento": str, "apellido": str, "nombre": str, "sexo": str}
|
||||
"""
|
||||
if not raw_text:
|
||||
return {"documento": "", "apellido": "", "nombre": "", "sexo": "M"}
|
||||
|
||||
# Limpiar terminadores y retornos de carro
|
||||
raw_clean = 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 = [p.strip() for p in text.split('"')]
|
||||
|
||||
if len(parts) < 5:
|
||||
# Si solo vino un número de documento escrito manualmente
|
||||
digits = "".join(filter(str.isdigit, raw_clean))
|
||||
if 6 <= len(digits) <= 9:
|
||||
return {"documento": digits, "apellido": "", "nombre": "", "sexo": "M"}
|
||||
return {"documento": "", "apellido": "", "nombre": "", "sexo": "M"}
|
||||
|
||||
doc = nombre = apellido = sexo = ""
|
||||
|
||||
# Heurística para Formato 2009 con comilla inicial
|
||||
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) > 5:
|
||||
apellido = parts[4]
|
||||
nombre = parts[5]
|
||||
|
||||
# Heurística para Formato 2009 sin comilla inicial
|
||||
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]
|
||||
|
||||
# Formatos 2012, 2026 y App Mi Argentina
|
||||
else:
|
||||
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 ""
|
||||
|
||||
# Formato 2012: parts[3] es letra de sexo (M, F, X)
|
||||
if len(p3) == 1 and p3.upper() in ("M", "F", "X"):
|
||||
sexo = p3.upper()
|
||||
if len(parts) > 4:
|
||||
doc = p4
|
||||
|
||||
# Formato App Mi Argentina: parts[3] es código 1=M, 2=F, 3=X y parts[4] es DNI
|
||||
elif p3 in ("1", "2", "3", "0") and p4.isdigit() and 6 <= len(p4) <= 9:
|
||||
sexo = "M" if p3 == "1" else ("F" if p3 == "2" else "X")
|
||||
doc = p4
|
||||
|
||||
# Formato 2026: parts[3] es DNI directo
|
||||
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"
|
||||
|
||||
# Desempate general: si parts[4] es DNI numérico
|
||||
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:
|
||||
doc = p3
|
||||
|
||||
return {
|
||||
"documento": doc.strip(),
|
||||
"apellido": apellido.upper().strip() if apellido else "",
|
||||
"nombre": nombre.upper().strip() if nombre else "",
|
||||
"sexo": sexo or "M",
|
||||
}
|
||||
|
||||
@classmethod
|
||||
def parsear_codigo(cls, raw_text: str) -> DNIParsedResult:
|
||||
res = cls.parsear(raw_text)
|
||||
valido = bool(res["documento"] and len(res["documento"]) >= 6)
|
||||
return DNIParsedResult(
|
||||
valido=valido,
|
||||
documento=res["documento"],
|
||||
apellido=res["apellido"],
|
||||
nombre=res["nombre"],
|
||||
sexo=res["sexo"],
|
||||
)
|
||||
|
||||
|
||||
# Alias para compatibilidad de nomenclatura
|
||||
DNIParsingService = DniParserService
|
||||
Reference in New Issue
Block a user