Files

3.8 KiB

Spec 002 — Escaneo Óptico de DNI con Cámara de Tablet y Control de Acceso

Estado: borrador

Contexto y objetivo

Eliminar por completo los lectores físicos externos de código de barras/QR (puerto COM serie y USB emulando teclado) en los puestos de control de OnEverControl. En su lugar, utilizar directamente la cámara integrada de la tablet (Android, iPad, Windows) para detectar, escanear y decodificar el DNI argentino (PDF417 y QR) en tiempo real, completando instantáneamente los datos de la persona y capturando al mismo tiempo la fotografía del documento como evidencia de seguridad.

Usuarios / Actores

  • Operador de Garita (Guardia en Tablet): Apunta la tablet al DNI físico de la visita o conductor en la ventanilla para capturar los datos y registrar el ingreso/salida.

Historias de usuario

  • HU-1: Como guardia con tablet en mano, quiero escanear el DNI del ingresante apuntando con la cámara trasera de la tablet para no depender de lectores con cables ni escáneres externos en el puesto.
  • HU-2: Como guardia, quiero que al detectar el DNI la tablet haga un bip/vibración y complete automáticamente Apellido, Nombre, Documento y Género para no tener que tipear nada manualmente.
  • HU-3: Como guardia, quiero que el sistema guarde automáticamente la foto del DNI capturada por la cámara como constancia visual de la visita.

Requisitos funcionales (Criterios de aceptación en sintaxis EARS)

  • RF-1 (Activación de Cámara y Detección): CUANDO el operador abre el carril de ingreso o pulsa "Escanear DNI", EL SISTEMA activa la cámara trasera de la tablet (facingMode: "environment") con encuadre guiado y escanea continuamente fotogramas mediante la Barcode Detection API nativa y fallback con ZXing (Wasm/JS).
  • RF-2 (Decodificación Instantánea): CUANDO el encuadre enfoca un código de barras PDF417 (dorso de DNI) o código QR oficial (Renaper / Mi Argentina), EL SISTEMA decodifica la cadena de texto cruda en menos de 100 ms, emite un feedback sonoro/háptico y congela el fotograma como imagen del documento.
  • RF-3 (Parsing de Datos): CUANDO se decodifica la cadena del DNI, EL SISTEMA ejecuta la función de parsing (formatos 2009, 2012, 2026 y digital) y completa de forma inmediata los campos de Documento, Apellido, Nombre y Sexo en el formulario del carril.
  • RF-4 (Validación de Seguridad y Antipassback): CUANDO los datos de la persona son cargados, EL SISTEMA consulta de inmediato en SQL Server videoman el estado de la persona: antipassback activo, listas de restricción (Blacklist), alertas de seguridad y pólizas registradas.
  • RF-5 (Fallback a Tipeo Manual): SI el código de barras físico del documento está borroso o ilegible, ENTONCES EL SISTEMA permite al operador ingresar el número de documento directamente con el teclado numérico táctil de pantalla (inputmode="numeric").
  • RF-6 (Cero Dependencia de Periféricos): EL SISTEMA opera de forma autónoma sin requerir escáneres por puerto COM ni periféricos USB HID conectados.

Requisitos no funcionales

  • Rendimiento: Decodificación óptica en cliente en menos de 100 ms sin enviar video continuo por la red local.
  • Aceleración por Hardware: Utilización de Barcode Detection API nativa en Chromium/Android y Safari/iPadOS cuando esté disponible.
  • Ergonomía Táctil: Botón de captura y activación de cámara con tamaño mínimo de 56 x 56 px.

Casos límite

  • Cámara sin permisos en el navegador: mensaje claro solicitando habilitar permisos de cámara en la tablet.
  • DNI con iluminación deficiente o reflejos: guía visual en pantalla recomendando inclinar la tarjeta.
  • Persona ya ingresada adentro (Antipassback): visualización inmediata del banner de alerta con botón "Ir a Salida".

Fuera de alcance

  • Conexión con escáneres físicos RS-232 o emuladores de teclado USB.