Skip to content

Latest commit

 

History

History
270 lines (203 loc) · 6.15 KB

GUIA-RAPIDO.md

File metadata and controls

270 lines (203 loc) · 6.15 KB

🚀 GUIA RÁPIDO - SISTEMA DE RECONHECIMENTO FACIAL

Status: ✅ Sistema rodando em http://localhost:5000

📋 MENU PRINCIPAL

1. Cadastrar Novo Usuário 👤

👉 Acesse: http://localhost:5000/register.html

Passos:

  1. Clique em "📹 Iniciar Câmera"
  2. Posicione seu rosto na câmera
  3. Clique em "📸 Capturar Foto"
  4. Preencha seu nome (obrigatório)
  5. Preencha seu email (opcional)
  6. Clique em "✅ Cadastrar Usuário"
  7. Aguarde a confirmação!

✅ Pronto! Você foi cadastrado no sistema.

2. Reconhecer Rosto 🔍

👉 Acesse: http://localhost:5000/recognize.html

Passos:

  1. Clique em "📹 Iniciar Câmera"
  2. Posicione seu rosto na câmera
  3. Clique em "🔍 Capturar e Reconhecer"
  4. Veja o resultado!

Resultado Esperado:

  • ✅ Reconhecido: Mostra seu nome, foto, email e % de confiança
  • ⚠️ Não Reconhecido: Face detectada mas não está no banco
  • ❌ Sem Face: Nenhuma face detectada na foto

3. Testes Técnicos 🧪

👉 Acesse: http://localhost:5000/index.html

Para testes de detecção e pipeline ONNX.

🎯 EXEMPLO DE USO COMPLETO

Cenário: Cadastrar João e Maria, depois reconhecê-los

Etapa 1: Cadastrar João

1. Acesse /register.html
2. Inicie câmera
3. João posiciona rosto
4. Captura foto
5. Nome: "João Silva"
6. Email: "joao@email.com"
7. Cadastrar
✅ João cadastrado!

Etapa 2: Cadastrar Maria

1. (Mesma página /register.html)
2. Inicie câmera novamente
3. Maria posiciona rosto
4. Captura foto
5. Nome: "Maria Santos"
6. Email: "maria@email.com"
7. Cadastrar
✅ Maria cadastrada!

Etapa 3: Testar Reconhecimento do João

1. Acesse /recognize.html
2. Inicie câmera
3. João posiciona rosto
4. Capturar e Reconhecer
✅ Resultado: "João Silva" com 87% de confiança

Etapa 4: Testar Reconhecimento da Maria

1. (Mesma página /recognize.html)
2. Tentar Novamente (reinicia câmera)
3. Maria posiciona rosto
4. Capturar e Reconhecer
✅ Resultado: "Maria Santos" com 92% de confiança

Etapa 5: Testar com Pessoa Não Cadastrada

1. (Mesma página /recognize.html)
2. Tentar Novamente
3. Outra pessoa posiciona rosto
4. Capturar e Reconhecer
⚠️ Resultado: "Face Não Reconhecida"

📊 COMO INTERPRETAR OS RESULTADOS

Confiança (Similarity):

Valor Significado Ação
90-100% Certeza absoluta ✅ Pode confiar totalmente
80-89% Alta confiança ✅ Muito provável ser a pessoa
70-79% Boa confiança ✅ Provavelmente correto
60-69% Confiança mínima ⚠️ Verificar manualmente
<60% Não reconhecido ❌ Pessoa não cadastrada

Threshold Atual: 60%

  • Só reconhece se confiança ≥ 60%
  • Ajustável em UserDatabaseService.SIMILARITY_THRESHOLD

💡 DICAS PARA MELHORES RESULTADOS

✅ FAÇA:

  • ✅ Use boa iluminação (luz natural ou branca)
  • ✅ Posicione rosto de frente
  • ✅ Tire foto de perto (rosto visível)
  • ✅ Mantenha expressão neutra
  • ✅ Retire óculos escuros/máscaras

❌ EVITE:

  • ❌ Fotos muito escuras
  • ❌ Rosto de perfil ou inclinado
  • ❌ Foto muito longe
  • ❌ Múltiplas pessoas na foto
  • ❌ Fundo muito confuso

🔧 GERENCIAMENTO

Ver Usuários Cadastrados:

  • Na página /register.html role até o final
  • Lista mostra todos os usuários com fotos

Excluir Usuário:

  • Na lista de usuários, clique em "🗑️ Excluir"
  • Confirme a exclusão
  • Usuário será removido do banco

Ver Histórico de Reconhecimentos:

  • Na página /recognize.html role até o final
  • Histórico mostra últimos 10 reconhecimentos

📈 MÉTRICAS EXIBIDAS

Na Página de Reconhecimento:

  1. Tempo (ms):

    • Quanto tempo levou para processar
    • Normal: 200-300ms

  2. Confiança:

    • Porcentagem de similaridade
    • Quanto maior, melhor

  3. Threshold:

    • Valor mínimo para aceitar
    • Atual: 60%

🐛 PROBLEMAS COMUNS

❌ "No face detected"

Causa: Face não foi encontrada na foto
Solução:

  • Melhore iluminação
  • Aproxime câmera
  • Posicione rosto de frente

❌ "Multiple faces detected" (no cadastro)

Causa: Mais de uma face na foto
Solução:

  • Certifique-se de estar sozinho
  • Evite pessoas ao fundo
  • Use fundo neutro

⚠️ "Face Não Reconhecida"

Causa: Face detectada mas não corresponde a ninguém
Soluções:

  • Verifique se está cadastrado (veja lista)
  • Tente foto em condições similares ao cadastro
  • Cadastre-se se for primeira vez

🔄 Reconhecimento Incorreto

Causa: Similaridade entre pessoas ou threshold baixo
Soluções:

  • Cadastre múltiplas fotos da mesma pessoa
  • Aumente o threshold para 70-80%
  • Melhore qualidade das fotos

🎯 ATALHOS RÁPIDOS

Ação URL
📝 Cadastrar http://localhost:5000/register.html
🔍 Reconhecer http://localhost:5000/recognize.html
🧪 Testes http://localhost:5000/index.html
📚 API Docs http://localhost:5000/swagger
❤️ Health Check http://localhost:5000/api/health

📱 EXEMPLO REAL DE TELA

Cadastro Bem-Sucedido:

✅ Usuário "João Silva" cadastrado com sucesso!

👥 Usuários Cadastrados (1)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[Foto] João Silva
       joao@email.com
       Cadastrado em 29/11/2025 18:45
       [🗑️ Excluir]

Reconhecimento Bem-Sucedido:

✅ Usuário Reconhecido!

[Foto] João Silva
       📧 joao@email.com
       🕐 Cadastrado em 29/11/2025 18:45

████████████████░░░░ 87.5% de confiança

📊 Resultados:
   Tempo: 234ms
   Confiança: 87.5%
   Threshold: 60%

🎉 PRONTO PARA USAR!

O sistema está 100% funcional e pronto para:

  • ✅ Cadastrar quantos usuários quiser
  • ✅ Reconhecer faces em tempo real
  • ✅ Gerenciar usuários cadastrados
  • ✅ Ver métricas e histórico

Divirta-se testando! 🚀

Dúvidas? Consulte a documentação completa em SISTEMA-RECONHECIMENTO-COMPLETO.md