LEITOR DE DIGITAL - Tarefas Online - DP (Obra 369)
==================================================

Este pacote liga o leitor de digital Hamster DX ao portal, para cadastrar a
digital dos colaboradores e assinar as liberacoes.

Dentro desta pasta tem tudo o que voce precisa, em duas subpastas:
   1-Instalar-driver       -> driver do leitor (instala uma vez por computador)
   2-Programa-de-leitura   -> programa que liga o leitor ao portal


LINKS DO PORTAL
---------------
Pagina do leitor (cadastro de digitais):
   https://www.admdf.site/Biometria.html

Baixar este pacote de novo, se precisar:
   https://www.admdf.site/downloads/leitor-digital.zip


ANTES DE COMECAR: EXTRAIA O ZIP
-------------------------------
Clique com o botao direito no arquivo .zip -> "Extrair tudo".
NAO rode nada de dentro do .zip, so funciona depois de extrair.

Se o Windows tiver bloqueado o arquivo baixado: clique com o botao direito
no .zip -> Propriedades -> marque "Desbloquear" (canto inferior) -> OK, e
extraia de novo.


PASSO 1 - INSTALAR O DRIVER (uma vez por computador)
----------------------------------------------------
- Abra a subpasta "1-Instalar-driver".
- De dois cliques em "UBio_Hamster_X_Driver_Setup_x64.exe".
- Siga as telas ate Concluir.
- Ligue o leitor Hamster DX em uma porta USB.

IMPORTANTE: instalar driver EXIGE senha de administrador do Windows. Isso e
uma regra do proprio Windows, nao tem como pular. Se este computador nao tem
admin, peca ao responsavel de TI para instalar este driver uma unica vez.
Depois de instalado, o dia a dia nao precisa mais de admin.

(Dica: antes de chamar a TI, teste o PASSO 2 e o PASSO 3 assim mesmo. Alguns
computadores reconhecem o leitor sozinhos, sem precisar instalar o driver.)


PASSO 2 - ABRIR O PROGRAMA DE LEITURA (nao precisa de admin)
------------------------------------------------------------
- Mova a subpasta "2-Programa-de-leitura" para um lugar fixo, por exemplo:
     C:\LeitorDigital
- Abra essa pasta e de dois cliques em "Abrir-leitor.bat".
- Se aparecer "O Windows protegeu o seu computador", clique em
  "Mais informacoes" e depois em "Executar assim mesmo".

ATENCAO: o programa NAO abre nenhuma janela. Ele roda escondido, em segundo
plano. Entao e normal "parecer que nada aconteceu". Confira pelo PASSO 3.

Para o programa abrir sozinho toda vez que ligar o computador, de dois
cliques, UMA vez, em "Abrir-com-o-Windows.bat".


PASSO 3 - CONFERIR SE ESTA FUNCIONANDO
--------------------------------------
Com o programa aberto (Passo 2), abra no navegador deste computador:
   http://localhost:5000/apiservice/device-unique-id

  * Aparece um texto com "success":true e um numero de serie
       -> esta tudo certo! O leitor esta pronto.
  * Aparece erro de dispositivo (device/open)
       -> o programa esta rodando, mas o leitor nao foi reconhecido.
          Confira se ele esta ligado na USB e se o driver (Passo 1) foi
          instalado.
  * A pagina nao abre de jeito nenhum
       -> o programa nao esta rodando. Veja "SE NAO ABRIR" abaixo.

Funcionando, entre no portal (login do Departamento Pessoal), abra a pagina
Biometria e deve aparecer "Hamster DX conectado" no canto superior. Na
primeira vez o navegador pergunta se o site pode acessar a rede local:
clique em PERMITIR.


SE O PROGRAMA "NAO ABRE"
------------------------
Lembre que ele NAO tem janela. "Nao abrir" quase sempre e um destes casos:

1) Ele ja esta rodando e voce so nao ve.
   - Abra o Gerenciador de Tarefas (Ctrl+Shift+Esc), procure
     "Fingertech-API". Se estiver na lista, esta funcionando -> faca o
     Passo 3.

2) O arquivo estava bloqueado por ter vindo da internet.
   - Veja "ANTES DE COMECAR" acima (botao direito -> Desbloquear).

3) Para ver o erro de verdade:
   - Abra o Prompt de Comando (tecla Windows, digite cmd, Enter).
   - Arraste o "Fingertech-API.exe" para dentro da janela preta e aperte
     Enter. O erro aparece escrito ali.

4) O antivirus apagou o arquivo.
   - Se o "Fingertech-API.exe" sumiu da pasta depois de extrair, foi o
     antivirus. Em computadores com antivirus corporativo (ex.: CrowdStrike)
     isso pode acontecer porque o programa nao tem assinatura digital
     conhecida. Nesse caso, peca ao suporte de TI para liberar (allowlist) o
     Fingertech-API.exe pelo nome/caminho do arquivo, informando que ele so
     abre a porta local 5000 em localhost e e o programa oficial do leitor
     Fingertech / Hamster DX.


OBSERVACOES
-----------
- O leitor so funciona no computador onde esta ligado (nao funciona no
  celular).
- As digitais ficam guardadas no banco de dados do portal, NAO neste
  computador. Somente o Departamento Pessoal tem acesso.
- Para fechar o programa: Gerenciador de Tarefas (Ctrl+Shift+Esc) ->
  Fingertech-API -> Finalizar tarefa.
