GBS Identity

1. Visão geral
O GBS Identity é uma aplicação web destinada à criação e consulta de registros biométricos de indivíduos. Cada registro (chamado internamente de encounter) reúne:
Dados biográficos — chaves, nome, filiação, data de nascimento (a depender da configuração do ambiente).
Biometrias — imagem facial, impressões digitais e assinatura.
Após o envio, o sistema cadastra o indivíduo no ABIS e dispara uma busca biométrica 1:N que retorna perfis com correspondência. O operador pode então visualizar as informações dos perfis encontrados na base, validando a identidade.
Principais capacidades para o operador:
Criar e enviar registros, mesmo sem conexão (modo offline).
Pesquisar histórico de registros.
Visualizar resultados de busca biométrica.
Monitorar o status dos dispositivos biométricos e dos serviços dependentes.
Visualizar métricas agregadas de capturas, envios e correspondências.
2. Pré-requisitos
2.1 Navegador e instalação
Navegador recomendado: Google Chrome ou Microsoft Edge atualizados.
O GBS Identity é um PWA (Progressive Web App). Ele pode ser utilizado offline e pode ser instalado no computador.
Após o primeiro acesso com internet, recursos da aplicação ficam em cache local, permitindo uso offline.
Para instalar como aplicativo do sistema operacional, clique no ícone de instalação na barra de endereços do navegador. O GBS Identity passará a ser aberto como uma janela dedicada, sem necessidade do navegador, e fica disponível no menu do Windows.
2.2 Extensão e dispositivos biométricos
A captura biométrica ocorre por meio da Live Capture Extension, que se comunica com os dispositivos USB do computador (câmera facial, leitor biométrico de digitais e pad de assinatura). Antes de iniciar um registro, certifique-se de que:
A Live Capture Extension está instalada no navegador.
O Live Capture Connector está instalado no sistema operacional (drivers e plugins dos dispositivos).
Os dispositivos físicos estão conectados via USB e ligados.
O status de cada componente pode ser verificado a qualquer momento na página Diagnóstico do Sistema e no indicador no canto superior direito (ver Seção 5).
2.3 Conexão e servidor
Para envio imediato de registros, é necessária conexão com a internet e disponibilidade do servidor de identificação (ABIS).
Quando offline, o registro é salvo localmente e enviado automaticamente assim que a conexão e o servidor voltarem a estar disponíveis.
3. Acesso e login
O GBS Identity utiliza a nova autenticação integrada da suíte GBS através do GBS Auth. Nesta modalidade, a autenticação é intermediada com o provedor de identidade (IdP - Identity Provider) da organização do cliente. Ao acessar a aplicação, você é redirecionado para a tela de login do provedor de identidade. Após autenticar com suas credenciais, o navegador retorna ao GBS Identity já com a sua sessão aberta.
O nome do usuário aparece no canto superior direito do cabeçalho. As funcionalidades disponíveis dependem das permissões atribuídas ao seu perfil.
Para encerrar a sessão, clique no avatar (canto superior direito) e selecione Sair. Você será redirecionado de volta para a tela de login.

4. Layout da aplicação
Toda página possui a mesma estrutura: barra lateral à esquerda, cabeçalho fixo no topo e área de conteúdo central.

4.1 Barra lateral (esquerda)
Mostra os itens de navegação principais. Pode ser recolhida/expandida pelo botão na base.
Início
Página inicial. Atalho para criar novo registro e ver atividade recente.
Novo Registro
Abre o formulário de criação de registro (somente se você tiver permissão de escrita).
Registros
Lista e pesquisa todos os registros (todos os usuários, se você for administrador) ou apenas os seus.
Métricas
Painel de indicadores agregados de uso (somente para usuários com permissão de métricas).
Itens de menu que você não pode acessar (por falta de permissão) ficam ocultos. A versão do aplicativo é exibida na parte inferior da barra lateral.
4.2 Cabeçalho (topo)
O cabeçalho exibe o título da página atual e, no canto direito, os seguintes ícones (da esquerda para a direita):
Prontos para Enviar — atalho para o Registro de Envios (página com registros pendentes de sincronização). Aparece quando há registros aguardando envio.
Indicador de status do sistema — sinaliza em tempo real se todos os componentes (dispositivos, extensão, ABIS, internet) estão operacionais. Clicar abre a página de Diagnóstico do Sistema. Cores:
VERDEtudo ok,AMARELOaviso (algo não crítico falhou),VERMELHOcrítico (impede novos registros).Iniciar tour da página (ícone de ajuda) — inicia um tour guiado contextual com explicações sobre cada elemento da tela atual.
Avatar e nome do usuário — abre o menu da conta, com a opção Sair.
4.3 Tour guiado e onboarding
Em cada página, o botão de ajuda (ícone com "?") inicia um tour interativo com explicações passo a passo dos elementos da tela. Os tours estão disponíveis em:

Início — apresentação geral do aplicativo, modo offline e instalação como PWA.
Novo Registro — explicação das etapas biográficas e biométricas.
Registros — busca e leitura da listagem.
Detalhes do registro — leitura dos resultados da busca biométrica.
Os passos exibidos no tour se adaptam às suas permissões e ao estado da tela. Use os botões Anterior, Próximo e Concluir para navegar.

5. Status do sistema e diagnóstico
5.1 Indicador no cabeçalho
Um pequeno painel no cabeçalho monitora continuamente cada componente. Ao clicar nele você é levado à página Diagnóstico do Sistema.

5.2 Página Diagnóstico do Sistema

Acessível pelo indicador do cabeçalho ou pelo menu da conta. Verifica seis componentes:
Sistema de Captura
Live Capture Extension instalada e Connector ativo (motor principal de captura biométrica).
Sim
Dispositivo de Captura Facial
Câmera detectada, permissão de acesso concedida pelo navegador.
Sim
Scanner de Impressão Digital
Driver, SDK, dispositivo USB e acesso.
Sim
Pad de Assinatura
Driver, SDK, dispositivo USB e acesso.
Sim
Serviço de Identificação (ABIS)
Conexão com o sistema biométrico de busca.
Não (limita funcionalidade)
Conexão à Internet
Conectividade de rede.
Não (limita funcionalidade)
Cada componente é exibido em um cartão com seu status — ONLINE, OFFLINE, CRÍTICO, INDISPONÍVEL. Quando há falha, o cartão exibe uma seção Passos para Resolução com instruções específicas.
5.3 Banners de status
Problema crítico identificado — pelo menos um componente essencial (extensão ou dispositivo biométrico) está indisponível. Não será possível iniciar novos registros enquanto não for resolvido. Siga os passos indicados no cartão correspondente.
Aviso do Sistema — componentes não críticos estão indisponíveis (ABIS ou internet). Você pode continuar a usar o sistema com funcionalidade limitada (por exemplo, registros são salvos localmente para envio posterior).
5.4 Sub-status comuns
Negado
O navegador bloqueou o acesso ao dispositivo.
Verifique as permissões na barra de endereços.
Não Encontrado
O dispositivo não foi detectado pelo sistema.
Confira a conexão USB e o cabo.
Em Uso
O dispositivo está sendo usado por outro programa.
Feche outros softwares que possam estar usando o dispositivo.
Não instalado
O driver ou a extensão não foi instalado.
Instale a Live Capture Extension/Connector (link clicável no cartão).
Versão incompatível
A versão instalada não é suportada.
Atualize o driver/extensão para a versão recomendada.
6. Início (Home)

É a página inicial da aplicação, acessível pelo item Início da barra lateral. Contém dois blocos:
6.1 Iniciar Novo Registro
Botão em destaque no topo. Clica e abre a página de criação de novo registro (Seção 7). Aparece apenas se você tiver permissão de criação.
6.2 Atividade Recente
Lista dos 5 registros mais recentes a que você tem acesso, com nome (quando disponível), data de criação e status atual. Cada item é clicável e leva à página de detalhes do registro.

Comportamento:
Online: mostra os 5 registros mais recentes do servidor.
Offline: mostra os 5 registros mais recentes armazenados localmente (ainda não enviados).
Quando há registros com status Pesquisa Solicitada, a dashboard atualiza-se automaticamente a cada 10 segundos para refletir a evolução até que todos sejam concluídos.
O link Ver mais → abre a página completa de registros (online) ou o Registro de Envios (offline).
7. Criar um Novo Registro
Esta é a funcionalidade central do GBS Identity. O fluxo padrão tem cinco etapas, exibidas em sequência com indicador de progresso no topo:
Dados Biográficos
Preencha as informações do indivíduo. Os campos exibidos dependem da configuração da instalação.
Campos obrigatórios aparecem em vermelho. Alguns campos têm máscara automática e validação imediata — se o valor for inválido, a mensagem aparece abaixo do campo e o botão Próximo fica desabilitado.
Clique em Próximo para avançar.

Captura Facial
O componente de captura ao vivo exibe a imagem da câmera. Por padrão, a captura inicia automaticamente e o sistema usa a verificação de qualidade ICAO para garantir uma imagem adequada.
Quando a imagem é capturada com sucesso, aparece a mensagem "Face capturada com sucesso" e o botão Capturar Novamente. Avalie a imagem na tela: se necessário, refaça antes de seguir.

O botão Próximo só é habilitado após uma captura bem-sucedida. Use Anterior para voltar à etapa de dados biográficos.
Impressões Digitais
O scanner solicita as digitais em sequência. Posicione o dedo indicado pela interface e aguarde a captura — o sistema avança automaticamente para o próximo dedo.

O modo de captura é configurável por instalação. A imagem de referência acima mostra uma coleta de quatro dedos. Os dedos que ainda não foram capturados são destacados.

Se um dedo não puder ser capturado (amputação, lesão), siga a interface da extensão para marcar o motivo (a captura pode ser pulada por meio das opções específicas do dispositivo, quando habilitadas pela configuração).
A mensagem "Impressões digitais capturadas com sucesso" aparece quando o conjunto está completo.
Assinatura
Solicite ao indivíduo que assine no pad de assinatura. A assinatura é exibida em tempo real na tela.
Se a assinatura ficar inadequada, use Capturar Novamente.
Quando a assinatura é capturada, aparece "Assinatura capturada com sucesso".
Se o indivíduo for incapaz de assinar (analfabeto, lesão, criança de colo, etc.), marque a opção Não assina. O sistema exibirá "Assinatura não capturada" e permitirá avançar mesmo sem assinatura.
Revise os dados inseridos
Exibe um resumo de todos os dados inseridos:
Dados biográficos preenchidos.
Dados biométricos — para cada modalidade (Face, Impressões Digitais, Assinatura), indica se foi Capturado ou Não capturado, com pré-visualização quando disponível.
Releia atentamente. Para corrigir algo, use Anterior e volte às etapas anteriores — os dados já capturados são preservados.
Quando estiver tudo correto, clique em Enviar. Durante o envio, ambos os botões ficam desabilitados.

Cancelar registro

Cancelar (canto superior): aborta o registro e descarta tudo o que foi capturado (com confirmação).
Atenção: esta ação não pode ser desfeita. Ao cancelar ou sair de um registro em andamento, todos os dados biográficos e biométricos capturados (foto facial, impressões digitais, assinatura e demais informações associadas) são apagados permanentemente. O sistema sempre exibe um modal de confirmação antes de descartar dados.
Após envio

O comportamento depende do estado da conexão no momento do envio:
Online + ABIS disponível
O registro é enviado imediatamente. Você é redirecionado para a página de detalhes do registro.
"Registro enviado com sucesso"
Offline
O registro é salvo no dispositivo (IndexedDB) e adicionado à fila de envio.
"Você está offline. Registro salvo localmente e será enviado quando a conexão for restaurada."
Falha no envio online
O registro é salvo localmente e o sistema tentará reenviá-lo automaticamente.
"Falha no envio. Registro salvo localmente e será reenviado automaticamente."
8. Modo offline e Registro de Envios
O GBS Identity foi projetado para funcionar sem conexão. Você pode iniciar e concluir um registro normalmente quando estiver offline — ele será armazenado no navegador e enviado automaticamente assim que houver conexão e o servidor estiver disponível.
8.1 Como o sistema identifica o estado offline
O navegador perdeu acesso à internet, ou
O servidor de identificação (ABIS) está fora do ar.
Em ambos os casos, o cabeçalho exibirá indicação de status amarelo/vermelho e algumas páginas mostrarão banners específicos.
8.2 Prontos para Enviar
Quando há registros aguardando envio, um botão Prontos para Enviar aparece no cabeçalho. Clicar abre a página Registro de Envios.

8.3 Página Registro de Envios
Lista todos os registros pendentes de envio armazenados localmente. Para cada um, são exibidos:
Nome (ou "Registro sem nome" quando não preenchido).
Data da última atualização.
Indicador Enviando em tempo real durante a sincronização.
Indicador Erro na tentativa de envio quando ocorre falha.
Quando o sistema está online, o ABIS responde e há registros pendentes, aparece o botão Reenviar registros no topo da página. Clique para forçar uma nova tentativa de envio.
Quando a fila está vazia, a página exibe "Nenhum registro pendente de envio".
8.4 Banner de servidor offline
Na página Registros e em Métricas, quando o ABIS está indisponível, aparece um banner laranja:
MODO OFFLINE — Servidor de Pesquisa Offline. O servidor de pesquisa ABIS está indisponível no momento. Apenas registros prontos para envio estão visíveis. Registros online não podem ser acessados até que a conexão com o servidor seja restabelecida.
9. Listar e buscar registros
Acessada pelo item Registros da barra lateral. A página tem três blocos: filtros, lista paginada e paginação.

9.1 Filtros
Buscar por...
Campo de texto com seletor de tipo de chave. O valor é formatado automaticamente conforme o tipo selecionado.
Data inicial / Data final
Filtra pela data de início da coleta do registro. Pode-se usar somente uma das duas.
Botões Buscar (aplica os filtros) e Limpar (zera todos os filtros e refaz a busca). Pressionar a tecla Enter no campo de busca também dispara a pesquisa.
Os filtros aplicados são preservados ao navegar para outras páginas. Ao voltar para Registros, sua busca continua exibida.
9.2 Lista de registros
Cada item exibe:
Nome (ou "Registro desconhecido", quando não há "Nome").
Documentos identificadores.
Quantidade de candidatos encontrados (após a busca biométrica concluir).
Badge de status indicando o estado de processamento:
Cadastrando
O indivíduo está sendo cadastrado no ABIS.
Cadastrado
O enrolamento foi concluído.
Falha ao cadastrar
O enrolamento falhou.
Processando
A busca biométrica 1:N foi solicitada e está em andamento.
Falha na Pesquisa
A busca biométrica falhou no servidor.
Concluído
O processamento foi concluído — os candidatos (se houver) estão disponíveis para análise.
Cada item tem o botão Visualizar para abrir os detalhes (Seção 10).
9.3 Paginação
No rodapé da lista, controle de páginas (primeira, anterior, próxima, última) e seleção de quantidade de registros por página (10, 15 ou 50). A paginação só aparece quando há resultados online.
10. Detalhes do registro e busca biométrica
Acessada pelo botão Visualizar de cada registro ou pelo card de atividade recente na dashboard. A página tem três blocos:

10.1 Registro Atual

Cartão no topo, mostrando todos os dados do registro recém-criado:
Imagem facial capturada.
Dados biográficos.
Status atual (badge).
Indicação se algum dedo tem anomalia (amputado, lesionado, etc.).
Enquanto o status do registro for Cadastrando, Cadastrado ou Pesquisa Solicitada, esta página atualiza-se automaticamente a cada 5 segundos.
10.2 Resultado da pesquisa biométrica

Logo abaixo do registro atual, exibe o resultado da busca:
"X perfis encontrados" — total de candidatos no canto superior direito da seção.
"Nenhum perfil encontrado" — quando a busca não retornou candidatos.
Quando não há candidatos, o sistema explica:
10.3 Cartão de candidato
Cada candidato encontrado é exibido em um cartão com:
Imagem facial do candidato.
Tipo de registro:
CIVIL(vindo da base civil) ouREGISTRO(outro encounter já existente no Identity).Dados biográficos resumidos.
Data de criação do registro do candidato.
PGUID / TGUID — identificadores únicos do candidato.
Botão Ver Detalhes.
Para fechar as informações detalhadas, clique em Ocultar Detalhes.
10.4 Avisos de verificação por chave
Além da busca biométrica 1:N, o GBS Identity faz uma verificação 1:1 para cada chave informada. Esses avisos aparecem como banners destacados:
Aviso: O (chave) informado já está cadastrado em um perfil na base que não tem correspondência biométrica com o registro. Isso pode indicar fraude documental — investigue antes de aceitar o registro.
10.5 Voltar
O botão Voltar no topo retorna para a página de origem: Registros (se você veio da listagem) ou Início (se você veio da dashboard).
11. Completar cadastro
Quando um registro foi criado no modo rápido (apenas com biometria mínima) e a busca biométrica não retornou nenhum candidato, o operador pode completar o cadastro adicionando mais biometrias e dados biográficos. Isso melhora a qualidade do registro armazenado no ABIS para buscas futuras.
11.1 Quando aparece o botão
Na página de detalhes do registro, quando nenhum candidato é encontrado e o registro é do tipo rápido (e ainda não foi completado), aparece o botão Completar Cadastro.
Se o registro já tem candidatos ou já foi completado, o botão não aparece e o sistema exibe "Registro não pode ser completado" caso você tente abrir a URL de complemento manualmente.
11.2 Fluxo de complemento
Ao clicar em Completar Cadastro, abre-se o mesmo formulário de cinco etapas usado em novo registro, já pré-preenchido com os dados biográficos e biométricos do registro original. Acrescente as informações que faltam e siga até a etapa de revisão.
Ao enviar, o sistema atualiza o registro no ABIS e retorna o novo resultado de busca. Você é redirecionado de volta para a página de detalhes.
Se você cancelar ou tentar sair com alterações pendentes, o sistema exibe um modal:
Descartar Alterações — Atenção: Suas alterações serão perdidas. Cancelar descartará todas as alterações feitas neste registro, incluindo novos dados biográficos e biométricos capturados.
12. Métricas
Acessada pelo item Métricas da barra lateral (somente para usuários com permissão). Exibe três indicadores agregados de uso para um período selecionado.
12.1 Filtro de período
No topo da página, escolha Data Inicial e Data Final. Atalhos disponíveis: Hoje, Último Mês, Este Ano. O botão Buscar só fica habilitado quando ambas as datas estão preenchidas.
Após buscar, é exibida uma linha-resumo (ex.: "Período selecionado: 01/05/2026 - 27/05/2026 (27 dias)") e os três cartões de métrica.
12.2 Indicadores exibidos

Total de Capturas Offline
Quantos registros foram capturados sem conexão (offline) no período. Útil para acompanhar uso em campo.
Total de Registros Enviados
Quantos registros foram efetivamente enviados ao ABIS no período.
Registros sem candidatos
Quantos registros, ao serem submetidos à busca biométrica, não tiveram nenhum candidato correspondente.
12.3 Indisponibilidade do serviço
Esta página requer o ABIS online. Se você acessar enquanto offline, será redirecionado para a página inicial com a mensagem "O serviço de identificação não está acessível no momento para consulta de métricas".
13. Mensagens, avisos e solução de problemas
13.1 Toasts e notificações comuns
Registro enviado com sucesso
Envio online concluído. Registro disponível para consulta.
Você está offline. Registro salvo localmente e será enviado quando a conexão for restaurada.
O registro está seguro no dispositivo. Verifique o cabeçalho para sinais de retorno da conexão.
Registro pendente sincronizado com sucesso
Um registro que estava na fila foi enviado.
Falha ao sincronizar registro. Tentaremos novamente.
Erro temporário. O sistema fará nova tentativa automaticamente.
Erro no formato do registro. Entre em contato com o suporte
O registro local está corrompido ou em formato inválido. Acione o suporte com o ID do registro.
Falha ao carregar registros. Tente novamente.
Erro temporário na chamada ao servidor. Recarregue a página ou refaça a busca.
Página de novo registro indisponível enquanto os dispositivos estiverem inativos
Verifique a página de Diagnóstico do Sistema (Seção 5).
Registro não encontrado. Um novo registro será criado.
O ID na URL não existe. O sistema criou um registro em branco.
Falha ao inicializar registro. Tente novamente.
Erro ao preparar a tela de novo registro. Reabra a página.
13.2 Atualização do aplicativo (PWA)
Quando uma nova versão é detectada, aparece um aviso flutuante "Nova versão disponível — Atualize a página para usar a versão mais recente do app", com os botões:
Atualizar agora — recarrega o aplicativo na nova versão.
Mais tarde — adia o lembrete.
Dispensar — fecha o aviso (será exibido novamente em outra ocasião).
13.3 Diagnósticos: o que fazer se algo está vermelho
Sistema de Captura em vermelho.
Live Capture Extension não instalada ou desativada.
Instale a extensão (link na página de Diagnóstico). Reinicie o navegador.
Dispositivo Facial em vermelho.
Câmera não conectada ou permissão negada.
Verifique cabo USB. Conceda permissão à câmera na barra de endereços do navegador.
Scanner de Digital em vermelho.
Driver ausente, dispositivo em uso por outro programa ou USB desconectado.
Reconecte o USB. Feche outros softwares de captura. Instale o driver indicado.
Pad de Assinatura em vermelho.
Mesma família de causas que o scanner.
Reconecte e teste.
Serviço de Identificação em vermelho.
ABIS fora do ar ou VPN/firewall bloqueando.
Continue trabalhando offline — registros serão enviados quando o serviço voltar. Contate o suporte se persistir.
Conexão à Internet em vermelho.
Sem rede (Wi-Fi/Ethernet) ou roteador caído.
Verifique a rede do equipamento. Continue trabalhando offline — o GBS Identity funciona sem internet.
14. Sair e trocar de sessão
Clique no avatar no canto superior direito e selecione Sair. O sistema encerra a sessão no provedor de identidade e retorna você para a tela de login. Dados locais não enviados (registros pendentes) permanecem armazenados no dispositivo e serão sincronizados na próxima sessão do mesmo usuário.
Glossário
Registro (encounter)
Conjunto de dados biográficos e biométricos coletados de um indivíduo em uma sessão.
ABIS
Automated Biometric Identification System — serviço que armazena, indexa e busca biometrias.
Enrolamento (cadastro)
Processo de inserir o indivíduo no ABIS para que ele passe a constar nas buscas futuras.
Verificação (1:1)
Comparação dos documentos do indivíduo contra um registro específico na base, identificado pela mesma chave.
Busca (1:N)
Comparação biométrica do indivíduo contra toda a base, retornando candidatos com correspondência.
Perfil encontrado
Registro existente na base que apresenta correspondência biométrica (face, digital ou assinatura) com o registro recém-criado.
CIVIL
Origem do candidato: vindo da base civil (base de cidadãos).
REGISTRO
Origem do candidato: vindo de outros encounters já existentes no Identity.
PGUID / TGUID
Identificadores únicos atribuídos pelo ABIS ao indivíduo (PGUID) e ao registro biométrico (TGUID).
Live Capture Extension
Extensão de navegador que permite à aplicação web acessar os dispositivos biométricos.
Live Capture Connector
Aplicativo do sistema operacional que ponte entre a extensão do navegador e os drivers dos dispositivos.
PWA
Progressive Web App — modelo de aplicação web que pode ser instalada como app nativo e funcionar offline.
Atualizado
Isto foi útil?

