O que é:

Os logs são registros de todas as atividades do sistema. São úteis para entender o que aconteceu, quando aconteceu e identificar possíveis problemas.

️ Como ver os logs:

1. Acesse o Dashboard
2. Na parte inferior da tela, localize o bloco "Preview do Log"
3. Clique nele para expandir o visualizador de logs
4. Na janela expandida:
   • À esquerda: lista de arquivos de log (organizados por data)
   • À direita: conteúdo do arquivo selecionado

️ Como navegar entre arquivos de log:

1. No visualizador de logs expandido, clique no arquivo desejado na lista da esquerda
2. O conteúdo aparecerá automaticamente à direita
3. Os arquivos mais recentes aparecem primeiro (no topo da lista)

Como interpretar as cores nos logs:

Cor	Significado
Azul	Data e hora do registro
🟢 Verde	Informação (tudo ok)
Vermelho	Erro (algo deu errado)

5. FLUXOS COMUNS DO DIA A DIA

Fluxo 1: Verificar se o sistema está funcionando

Objetivo: Confirmar que tudo está operacional antes de iniciar as atividades do dia.

️ Passo a passo:

1. Abra o Insoft QFace App
2. Vá para o Dashboard
3. Verifique o cartão "Status da API":
   • Se mostrar "Online" (badge verde): sistema funcionando, pode seguir normalmente
   • Se mostrar "Parado" (badge vermelho): vá para o passo 4
4. Clique no cartão "Status da API" para ir à Gestão da API
5. Clique em " Iniciar"
6. Aguarde a confirmação de sucesso
7. Volte ao Dashboard e verifique se agora aparece "Online"

Fluxo 2: Iniciar o sistema pela manhã

Objetivo: Preparar o sistema para o expediente.

️ Passo a passo:

1. Ligue o computador normalmente

2. Abra o Insoft QFace App

   Se o serviço foi instalado como serviço Windows, a API já pode estar rodando automaticamente!

3. Verifique o Dashboard — se a API estiver "Online" e o dispositivo QFace "Conectado", está pronto!

4. Se a API estiver "Parado", acesse API → Gestão da API e clique em " Iniciar"

5. Se o dispositivo QFace estiver "Desconectado", acesse Gestão QFace e clique em " Reconectar"

Fluxo 3: Acompanhar uma conversão de fotos em andamento

Objetivo: Monitorar o cadastro biométrico de um lote de colaboradores.

️ Passo a passo:

1. O sistema externo (ERP, sistema de ponto, etc.) inicia o envio de fotos
2. O Insoft QFace App abre automaticamente a tela de Conversão de Fotos
3. Observe os cartões na tela — cada um representa um colaborador:
   • Aguardando (cinza): ainda não foi processado
   • Sucesso (verde): foto convertida com sucesso
   • Erro (vermelho): houve problema com essa foto
4. Aguarde até todos os cartões mostrarem o resultado final
5. Se houver erros, anote os IDs dos colaboradores com problema e informe ao responsável

Fluxo 4: Acompanhar uma captura ao vivo

Objetivo: Auxiliar na captura de foto de um colaborador pelo leitor QFace.

️ Passo a passo:

1. O sistema externo solicita a captura
2. O Insoft QFace App abre automaticamente a tela de Captura de Fotos
3. Oriente o colaborador a:
   • Se posicionar em frente ao leitor QFace
   • Olhar diretamente para o leitor
   • Ficar parado durante a contagem
4. Observe a contagem regressiva na tela (5, 4, 3, 2, 1...)
5. O leitor captura o rosto automaticamente
6. Verifique o resultado da qualidade:
   • 🟢 Qualidade Excelente / Razoável: captura concluída com sucesso
   • Qualidade muito baixa: a captura será solicitada novamente pelo sistema

Fluxo 5: Alterar configurações e aplicar mudanças

Objetivo: Modificar alguma configuração e garantir que ela seja aplicada.

️ Passo a passo:

1. Acesse Configurações no menu lateral
2. Navegue pela aba desejada
3. Realize as alterações necessárias
4. Clique em " Salvar Configurações"
5. Se aparecer um aviso amarelo "Reiniciar API para aplicar as alterações":
   • Clique em "Reiniciar API" (botão no aviso) OU
   • Vá para API → Gestão da API e clique em " Reiniciar"
6. Aguarde a confirmação de que a API foi reiniciada com sucesso

Fluxo 6: Consultar histórico de atividades

Objetivo: Verificar o que aconteceu no sistema em determinado período.

️ Passo a passo:

1. Acesse o Dashboard
2. Clique no bloco de "Preview do Log"
3. Na janela de logs, escolha o arquivo de log pelo nome (geralmente contém a data)
4. Leia as entradas mais recentes (aparecem na parte inferior do conteúdo)
5. Procure por entradas em vermelho para identificar possíveis erros

️ 6. ERROS COMUNS E COMO RESOLVER

Problema 1: A API aparece como "Parado" ou "Offline" no Dashboard

Possíveis causas:

• O serviço da API não foi instalado ainda
• O serviço foi parado manualmente
• O computador foi reiniciado e o serviço não inicia automaticamente

Como resolver:

1. Vá para API → Gestão da API
2. Verifique a linha "Serviço Windows":
   • Se mostrar "✗ Não Instalado": clique em " Instalar Serviço Windows" e aguarde
   • Se mostrar "✓ Instalado" mas o estado for "Stopped": clique em " Iniciar"
3. Aguarde alguns segundos e verifique se o status muda para "🟢 Em Execução"
4. Se não resolver, volte ao Dashboard para confirmar se agora aparece "Online"

Problema 2: Leitor QFace aparece como "Desconectado"

Possíveis causas:

• O leitor QFace está desligado ou sem energia
• O cabo de rede do leitor foi desconectado
• O endereço de rede (IP) do leitor mudou
• O computador e o leitor estão em redes diferentes

Como resolver:

1. Verifique fisicamente se o leitor QFace está ligado (deve ter luzes acesas)
2. Verifique se o cabo de rede do leitor está conectado corretamente
3. Vá para Gestão QFace e clique em " Reconectar"
4. Se ainda não conectar, acesse Configurações → Aba QFace e verifique se a Porta do Dispositivo está correta
5. Se o problema persistir, acione o suporte técnico informando que o leitor não está acessível pela rede

Problema 3: Conversão de fotos falha com erro

Possíveis causas:

• A foto enviada não contém um rosto humano visível
• A foto está com qualidade muito baixa (escura, borrada, muito pequena)
• O leitor QFace estava desconectado no momento da conversão
• A foto enviada não é um arquivo de imagem válido (JPEG ou PNG)

Como resolver:

1. Veja na tela de Conversão quais colaboradores tiveram erro
2. Anote os IDs dos colaboradores com problema
3. Informe ao responsável que enviou as fotos para verificar:
   • A foto deve ter o rosto frontal e bem iluminado
   • A imagem deve ter boa resolução (pelo menos 200x200 pixels)
   • O formato deve ser JPEG ou PNG
   • Não pode haver objetos cobrindo o rosto (óculos escuros, máscara, chapéu)
4. Após corrigir as fotos, o sistema externo pode reenviar apenas os colaboradores com erro

Problema 4: Captura ao vivo não funciona / tela preta na câmera

Possíveis causas:

• O Windows bloqueou o acesso à câmera para este aplicativo
• O driver da câmera do leitor QFace não está instalado corretamente
• Outro programa está usando a câmera ao mesmo tempo

Como resolver:

1. Acesse Configurações no menu lateral
2. Procure por um botão ou link "Abrir Configurações de Câmera"
3. Na janela do Windows que abrir, certifique-se que a opção "Permitir que aplicativos acessem sua câmera" está ativada
4. Feche outros programas que possam estar usando a câmera (como Skype, Teams, Zoom)
5. Feche e reabra o Insoft QFace App
6. Se o problema persistir, contate o suporte técnico para reinstalação dos drivers

Problema 5: Não consigo instalar o serviço — erro de permissão

Possíveis causas:

• O aplicativo não está sendo executado com permissões de administrador
• O antivírus do computador está bloqueando a instalação

Como resolver:

1. Feche o Insoft QFace App
2. Clique com o botão direito no ícone do programa na área de trabalho
3. Selecione "Executar como Administrador"
4. Clique em "Sim" na janela de permissão do Windows
5. Tente instalar o serviço novamente
6. Se ainda falhar, comunique ao setor de TI que o antivírus pode estar bloqueando a ação

Problema 6: A captura ao vivo foi encerrada com "Tempo limite atingido"

O que aconteceu:

O sistema aguarda um tempo máximo para o colaborador posicionar o rosto na câmera. Se esse tempo acabar sem uma captura bem-sucedida, a operação é cancelada.

Como resolver:

1. O sistema externo precisará solicitar a captura novamente
2. Desta vez, certifique-se de que o colaborador esteja posicionado na frente do leitor antes da contagem regressiva terminar
3. Garanta que o ambiente esteja bem iluminado e sem objetos bloqueando o rosto

Problema 7: Configurações salvas mas não surtiram efeito

Possível causa:

Algumas configurações exigem que a API seja reiniciada para serem aplicadas.

Como resolver:

1. Após salvar as configurações, verifique se apareceu um aviso pedindo para reiniciar a API
2. Vá para API → Gestão da API
3. Clique em " Reiniciar"
4. Aguarde a confirmação e teste novamente

7. PERGUNTAS FREQUENTES (FAQ)

O programa precisa ficar aberto o tempo todo?

Não necessariamente. Se o serviço da API foi instalado como Serviço Windows (botão " Instalar Serviço Windows"), a API continuará funcionando mesmo com o aplicativo fechado. O aplicativo Insoft QFace App só precisa estar aberto quando você quiser monitorar o sistema, alterar configurações ou acompanhar capturas ao vivo.

O que acontece se eu fechar o programa durante uma conversão?

Se a conversão foi iniciada por um sistema externo e a API está rodando como serviço Windows, a conversão continuará normalmente em segundo plano. O aplicativo só exibe o progresso — não é ele que realiza a conversão.

O sistema funciona sem internet?

Sim! O Insoft QFace App funciona completamente offline, em rede local. Ele se comunica com o leitor QFace pela rede interna da empresa. Conexão com internet só seria necessária se houver uma API externa configurada em outro servidor fora da rede local.

Posso usar o programa em mais de um computador ao mesmo tempo?

O programa deve ser instalado e executado no mesmo computador onde o serviço de API está instalado. Múltiplos computadores podem acessar a API através de outros sistemas integrados, mas o aplicativo Insoft QFace App em si é para uso local.

Como sei se o leitor QFace está funcionando corretamente?

Acesse Gestão QFace e verifique se aparece "Conectado" (badge verde). Se quiser confirmar que ele está respondendo, clique em "🧪 Testar". Se o teste for bem-sucedido, o leitor está operacional.

O que é o "template biométrico"?

É uma representação digital do rosto de uma pessoa — um conjunto de dados que descreve as características únicas do rosto, como a distância entre os olhos, o contorno do queixo, etc. Não é uma foto — é um código matemático que pode ser usado para identificação, mas que não permite "reconstruir" a foto original. É mais seguro e ocupa muito menos espaço que uma imagem.

As fotos dos colaboradores ficam salvas no programa?

Sim, caso a opção "Salvar Imagens" esteja ativada nas Configurações (aba Avançado), as fotos processadas ficam salvas em uma pasta no computador. Os templates biométricos também podem ser salvos conforme a configuração. Para alterar esse comportamento, acesse Configurações → Aba Avançado.

Por quanto tempo os registros ficam salvos?

Por padrão, os registros são mantidos por 7 dias. Você pode alterar esse prazo em Configurações → Aba Avançado → "Dias de Retenção".

Posso mudar o tema do programa para fundo escuro (modo noturno)?

Sim! Acesse Configurações → Aba Geral e selecione o tema " Escuro". A mudança é aplicada imediatamente, sem precisar salvar ou reiniciar.

O que significa "Start Pending" ou "Stop Pending" no status do serviço?

Significa que o serviço está no meio de um processo:

• Start Pending: a API está sendo iniciada (aguarde alguns segundos)
• Stop Pending: a API está sendo encerrada (aguarde alguns segundos)
  Esses estados são temporários. Aguarde e o status se atualizará automaticamente.

Posso ter mais de um leitor QFace conectado?

Na configuração atual, o sistema se conecta a um leitor QFace por vez, identificado pelo endereço configurado em Configurações → Aba QFace.

🧠 8. DICAS IMPORTANTES

Boas práticas de uso

• Verifique o Dashboard diariamente no início do expediente para garantir que tudo está operacional
• Instale o serviço como Serviço Windows — isso garante que a API inicie automaticamente com o computador, sem necessidade de intervenção manual toda manhã
• Reinicie a API após alterar configurações — algumas configurações só são aplicadas após reiniciar
• Mantenha os logs em dia — consulte os logs regularmente para identificar problemas antes que se tornem graves
• Não feche o aplicativo durante capturas ao vivo — embora a API continue funcionando, a tela de captura precisa estar aberta para concluir o processo

O que evitar

• Não pare a API durante uma conversão ou captura em andamento — isso pode causar erros e deixar o sistema em estado inconsistente
• Não altere manualmente os arquivos de configuração — use sempre a tela de Configurações do aplicativo
• Não instale o serviço duas vezes — se já estiver instalado, o botão de instalação não aparecerá. Se precisar reinstalar, remova primeiro e depois instale novamente
• Não ignore mensagens de erro — elas contêm informações importantes sobre o que precisa ser corrigido
• Não tente usar dois programas que acessem a câmera ao mesmo tempo — isso causará conflito e a captura falhará

Como usar melhor o sistema

• Use o tema Escuro para uso prolongado — reduz a fadiga visual
• Mantenha o leitor QFace sempre ligado durante o expediente para evitar atrasos quando uma conversão ou captura for solicitada
• Oriente os colaboradores sobre como se posicionar corretamente na frente do leitor QFace antes de realizar capturas
• Acesse os logs sempre que algo parecer errado — eles contêm os detalhes do que aconteceu
• Anote o IP do leitor QFace em um local seguro — se o leitor for trocado ou reinstalado, você precisará dessa informação para reconfigurar o sistema

9. SUPORTE

Quando procurar suporte técnico?

Procure o suporte técnico da Insoft4 Informática quando:

• A API não inicia mesmo após tentar os passos de resolução deste guia
• O leitor QFace nunca conecta, mesmo com o equipamento ligado e na rede
• Erros aparecem repetidamente sem causa aparente
• O programa apresenta comportamento estranho ou trava com frequência
• Você precisar reinstalar o sistema completo
• Precisar configurar o sistema em um novo computador

Informações que você deve ter em mãos ao contatar o suporte

Para agilizar o atendimento, tenha disponível as seguintes informações:

Onde ficam os arquivos de log?

Os arquivos de log ficam salvos automaticamente na pasta de instalação do programa. Eles podem ser solicitados pelo suporte técnico para análise. Para acessá-los diretamente pelo aplicativo, use o Dashboard → Preview do Log → expandir.

Este guia foi elaborado para ajudá-lo a usar o Insoft QFace App com confiança e autonomia.
Em caso de dúvidas não cobertas por este material, entre em contato com o suporte técnico da Insoft4 Informática LTDA.

Guia do Usuário — Insoft QFace App v1.0.0 — Abril de 2026 — Insoft4 Informática LTDA