Conectar terminales Biopad a ATV Asistencias

Guía de instalación para Biopad LT Pro y la suite AXS Biopad. Basada en los manuales incluidos con la instalación.

Arquitectura recomendada

1. Preparar la red y los equipos

1. Asigne a cada Biopad una IP fija o una reserva DHCP, gateway y DNS correctos. Registre IP, serie, sucursal y número de reloj.
2. Conecte energía y Ethernet. No exponga la terminal ni el AXS Biopad directamente a Internet.
3. Instale AXS Biopad 1.0.0.0 en Windows. El manual del fabricante señala que actúa como servidor en PC y que el host y las terminales deben estar en la misma LAN.
4. En AXS agregue cada terminal por búsqueda LAN o por IP; valide su estado de red y sincronice fecha/hora antes de enrolar personas.
5. Proteja con contraseña única el menú de cada terminal y el PC/VM AXS. Mantenga respaldo periódico de la base AXS.

2. Enrolar personas sin perder trazabilidad

1. En ATV cree/actualice al trabajador y asigne un PIN reloj único, numérico y estable. Ese PIN es la llave de correlación; no reutilice uno de una persona desvinculada.
2. Para rostro o huella, registre previamente el consentimiento de datos del trabajador. En Dispositivos → Enrolamiento BioPad, seleccione trabajador, terminal y credencial. La solicitud llega al adaptador local y AXS prepara el BioPad.
3. Cuando la solicitud indique En el terminal, la persona realiza la captura presencial. ATV confirma el resultado consultando AXS y conserva solo la referencia técnica: nunca descarga ni guarda la plantilla biométrica.
4. Defina en la ficha del dispositivo la marca por defecto (entrada, salida o colación). AXS no asigna esa semántica por sí solo; ATV la sincroniza al adaptador.
5. Verifique que el PIN reportado por el reloj coincide exactamente con el campo PIN reloj de ATV. Haga una marca de prueba por cada método habilitado y confirme fecha, hora, trabajador, origen, hash y comprobante.

3. Configurar el adaptador hacia ATV

1. En ATV: Dispositivos → Registrar dispositivo. Ingrese sucursal, modelo, IP, número de reloj y los métodos de lectura. Guarde el token mostrado; se revela una sola vez.
2. En el adaptador, configure la URL HTTPS de ATV y el encabezado X-Device-Token: DEV-…. Nunca envíe el token en la URL, planillas o capturas.
3. Mapee los eventos Biopad al tipo de ATV: entrada → entrada; salida → salida; salida a colación → colacion_inicio; regreso → colacion_fin.
4. Envíe lotes pequeños al endpoint POST /api/dispositivo/marcas y un heartbeat periódico a POST /api/dispositivo/heartbeat. Consulte el contrato exacto en la API de dispositivos.
5. Conserve la marca original con su fecha/hora de captura. Si hubo corte, envíela como offline: true y con ts original; no la reemplace por la hora de sincronización.

4. Publicar ATV de forma segura para el adaptador

1. Para pruebas locales en este Mac: python3 run.py --host 0.0.0.0 --puerto 8447. Obtenga la IP LAN del Mac y permita el puerto solo desde la IP del adaptador/VM.
2. Para producción: use DNS, HTTPS/TLS, proxy inverso y un certificado válido. Mantenga la aplicación en una red privada; no publique el puerto Python directamente a Internet.
3. Si la terminal solo admite HTTP propietario, limite su tráfico a la VLAN interna y use el adaptador como único componente con salida HTTPS hacia ATV.

Prueba de aceptación

1. Pruebe entrada, salida, ambas marcas de colación y una marca sin conexión.
2. Revise que el dispositivo aparezca con heartbeat reciente y que no existan PINes desconocidos en “Intentos fallidos”.
3. Contraste la marca en AXS, el log del adaptador y ATV: PIN, timestamp y tipo deben coincidir.
4. Descargue el comprobante y valide su hash en el verificador público.
5. Simule reinicio de terminal y caída de red; confirme que las marcas pendientes se reenvían una vez y no se duplican.