1. Introdução

1.1. GBS FastLine

O GBS FastLine é uma aplicação de software para autenticação em filas de espera. Ele usa identificação facial de forma rápida e precisa para fazer com que as pessoas sejam identificadas de forma mais ágil do que pelo processo de checagem de documentos realizado por um operador humano. Usando o FastLine, é possível reconhecer, identificar e registrar indivíduos em uma fila de forma automática.

Esse manual está atualizado para a versão 1.5.1 do FastLine.

1.1.1. Versões da Aplicação

O GBS FastLine está disponível em duas versões:

Desktop Standalone

Essa versão é para uso completo em um ambiente desktop, sem a necessidade de ferramentas ou requisitos externos.

Warning

O GBS FastLine foi projetado como um serviço, e sua versão desktop é recomendada para procedimentos de teste, validação e prova de conceito, ou para casos triviais de uso.

Note

Nesse documento essa versão será referida somente como Desktop.

Services

Nessa versão, o GBS FastLine é fornecido como um serviço e deve ser controlado por uma aplicação externa através de sua API. Esta versão também fornece meios para supervisão externa.

1.2. Licença de Software

O GBS FastLine requer uma licença de software para funcionar. A licença não está ligada a nenhum endereço de hardware (como MAC Address) e não expira. A licença deve ser instalada em: C:\ProgramData\Griaule, de acordo com as instruções presentes no manual de licença.

Note

Se for necessária mais assistência, entre em contato com o suporte da Griaule.

1.3. Instalação e Configuração Inicial do FastLine

O instalador do FastLine tem uma aba de configuração, GBDS Settings:

1.3.1. Configurações do GBDS

GBDS URL Address

URL de endereço do servidor GBDS. Exemplo: http://192.168.0.1:8085.

Username and Password

Credenciais usadas pelo FastLine para autenticação no GBDS.

2. Interface do Usuário

2.1. Iniciando a Aplicação

Ao iniciar o FastLine, a Tela Inicial será exibida:

2.2. Adicionando Perfis ao Banco de Dados

Essa seção mostra como popular o banco de dados local.

2.2.1. Recuperando do GBDS

O formulário Load base from GBDS, mostrado abaixo, pode ser usado para recuperar perfis do GBDS. Os perfis podem ser filtrados pelas chaves biográficas. Se o filtro for deixado vazio, todos os perfis disponíveis serão importados.

2.2.2. Cadastro Local

O botão Capturar Foto permite ao usuário cadastrar uma nova pessoa no banco de dados local. Ao selecionar essa opção, a janela de captura de imagem irá abrir:

A versão Desktop permite o cadastro por captura de imagens ao vivo, ou por importação de arquivos de imagem já salvos.

A versão Services permite cadastrar por importação de arquivos de imagem, mas não por captura ao vivo. Essa versão é focada em usos externos, para os quais é esperado um banco de dados já populado com perfis.

2.3. Visualizando Perfis

A lista de perfis é exibida na barra lateral, e mostra todos os perfis disponíveis para detecção. O número de perfis é mostrado no topo da lista.

O tamanho da lista exibida pode ser modificado nas configurações da aplicação. Passar o cursor do mouse sobre um perfil mostra sua foto. Perfis podem ser selecionados ou desselecionados ao clicar neles.

2.4. Deletando Perfis

Para deletar um ou mais perfis, selecione-os clicando na lista de perfis e pressione o botão Delete.

Warning

Uma vez que um perfil for deletado, ele não poderá ser recuperado.

2.5. Configurações da Aplicação

Para configurar a aplicação, clique em Configurações na página inicial:

Nessa tela, o usuário pode configurar o funcionamento da detecção, bem como a câmera que será usada.

3. Fluxo de Trabalho Padrão

O fluxo de trabalho padrão para uso do FastLine é o seguinte:

1. Realizar o login
2. Preencher o banco de dados
3. Começar a detecção
4. Finalizar a detecção
5. Verificar os resultados
6. Exportar o PDF com os resultados.

4. Detecção

4.1. Tela de Detecção

A Tela de Detecção é o núcleo do GBS FastLine. Nessa tela, o usuário poderá visualizar as imagens capturadas pela câmera, bem como as pessoas já identificadas e não identificadas.

4.1.1. Realizando Detecções

Detecções podem ser iniciadas através da interface da versão Desktop, ou através da API, na versão de Services. Uma vez iniciada, a aplicação começará o reconhecimento através da câmera configurada. Cada vez que um quadro da imagem ao vivo coincidir com um perfil do banco de dados, o evento será registrado e uma notificação podrá ser enviada (dependendo das configurações da aplicação).

Cada perfil pode ser reconhecido somente uma vez: Quando um perfil é reconhecido, ele é removido da lista de observação.

É possível detectar mais que uma face de uma vez, reduzir a área de detecção da câmera, especificar outras resoluções de câmera, alternar entre câmeras, mudar o limiar de identificação, e outros recursos, através das configurações da aplicação.

Detecções são realizadas em sessões de detecção, um conceito discutido abaixo.

4.1.2. Sessão de Detecção

Todo processo de detecção deve ocorrer dentro de uma Sessão de Detecção, essas sessões podem ser criadas pelo usuário através da interface ou da API. Uma vez criadas, as sessões podem ser iniciadas, pausadas, retomadas e finalizadas. Enquanto não finalizadas, as sessões podem ter as configurações e dados alterados. Uma vez finalizada, a sessão de gera um relatório de detecção que não pode mais ser alterado.

Uma Sessão de Detecção pode ser vista como um relatório que está sendo escrito. Quando completo, se torna um relatório de detecção imutável, garantindo a consistência dos dados.

Cada sessão de detecção tem seu próprio UUID (Identificador Único Universal, em inglês, Universal Unique Identifier), chamado SGUID (Identificador Único Global de Sessão, do inglês, Session Global Unique Identifier)

4.2. Lista de Identificados

A Lista de Identificados mostra as pessoas que casaram com as pessoas cadastradas desde o início da sessão:

4.3. Lista de Não Identificados

A Lista de Não Identificados mostra as pessoas que não casaram com as pessoas cadastradas desde o início da sessão:

4.4. Relatório de Resultados

O usuário pode ver o status da sessão na Tela de Relatório:

Uma vez que a sessão de detecção termina, a lista de detecção se torna um relatório imutável. O relatório é automaticamente salvo em um arquivo PDF ou JSON. O formato do relatório e a localização onde é salvo são determinados nas configurações da aplicação. Na versão Desktop, a aplicação pode ser configurada para automaticamente mostrar o relatório quando a sessão é finalizada.

4.4.1. Gerando Relatório em Execução

Você pode gerar um relatório enquanto o FastLine está em execução. Este relatório parcial só está disponível se o parâmetro de configuração savePdfRunning estiver definido como true no arquivo config.properties. Quando este parâmetro for true, um botão chamado Exportar como PDF aparecerá na tela de detecção. Você pode clicar no botão para gerar o relatório.

5. Notificação Externa

Quando o FastLine detecta uma face, ele exibirá a imagem da face adquirida e da face de referência. Outras informações, como o nome e a pontuação da pessoa também são exibidas. As informações de casamento também podem ser enviadas para um determinado URL por meio da configuração desktopStandalone.notifyUrl.

Para modificar a configuração, vá para a pasta FastLine, acesse o arquivo conf/config.properties e altere o parâmetro desktopStandalone.notifyUrl para a URL que será notificada.

Após o FastLine realizar um casamento, ele exibirá as informações na interface e notificará a URL configurada com o seguinte JSON:

{
   "id" : "FastLine001",
   "status" : "MATCH",
   "matchSummary" : {
      "referencePerson" : {
         "template" : "BYTEARRAY",
         "tguid" : "29D99G74-BF97-4714-B78E-1A3A49DDF782",
         "name" : "John Doe",
         "document" : "88418861092",
         "key" : "CPF",
         "profileImageByteArray" : "BYTEARRAY"
      },
      "score" : 95.29505,
      "timestamp" : "2022-08-08_08.08.08_BRT",
      "queryImage" : "BYTEARRAY"
   }
}

Note

Note que os valores de profileImageByteArray, template e queryImage serão bytearrays com formato de base64.

Os campos JSON são:

• id: ID do FastLine, definido pela configuração desktopStandalone.notifyId.
• status: Indique se houve casamento ou não. Ele pode retornar MATCH ou NOT_MATCH. Quando retornar o valor NOT_MATCH, o JSON não terá um matchSummary.
• template: Bytearray do template de imagem no GBDS.
• tguid: ID único da transação no GBDS.
• name: Nome da pessoa. Se nenhuma informação biográfica estiver disponível, este campo pode ficar em branco.
• document: valor da chave definida no campo key.
• key: Chave da pessoa no GBDS.
• profileImageByteArray: Bytearray da imagem no GBDS.
• score: Pontuação do casamento.
• timestamp: Timestamp do casamento.
• queryImage: Bytearray da imagem capturada pelo FastLine.