Prospeccao_SeConectai/Schema/etapas/10-testes-validacao-final.md

Etapa 10 — Testes e validação final

Objetivo

Validar o sistema de ponta a ponta rodando inteiramente via Docker, cobrindo o fluxo completo desde disparo de busca até exportação de leads, e revisar pontos de manutenção antes de considerar o projeto pronto para uso real.

Tarefas

1. Teste de fluxo completo (ambiente Docker):
   • Subir o ambiente do zero (docker compose up --build)
   • Logar no dashboard
   • Disparar uma nova busca por um ramo/localização real
   • Acompanhar o status até concluida
   • Validar na listagem de leads que os dados vieram padronizados (telefone em E.164, CNPJ válido quando presente, nome formatado)
   • Exportar CSV e conferir os dados
2. Teste de deduplicação:
   • Rodar a mesma busca (ou uma busca sobreposta, ex: mesmo ramo em raio maior) duas vezes
   • Confirmar que leads já existentes não duplicam, apenas atualizam o vínculo de busca
3. Teste de resiliência do scraper:
   • Simular/observar um cenário de bloqueio (ou revisar os logs de uma execução real que tenha batido em captcha)
   • Confirmar que o proxy foi marcado como degradado/bloqueado e que o backoff funcionou
4. Teste de curadoria de ramos:
   • Rodar uma busca com um termo cuja categoria ainda não tem alias mapeado
   • Confirmar que o lead aparece em /leads/sem-ramo e que vincular um ramo manualmente funciona e reflete na listagem principal
5. Revisão de segurança básica:
   • Confirmar que endpoints protegidos realmente exigem token válido
   • Confirmar que senhas/segredos não estão hardcoded em nenhum arquivo versionado
6. Revisão de performance:
   • Rodar uma busca com muitos resultados (50+) e medir tempo total do fluxo completo
   • Identificar gargalos óbvios (ex: scroll muito lento, N+1 queries na listagem de leads) e registrar como itens de melhoria futura em PROGRESSO.md, mesmo que não sejam corrigidos nesta etapa
7. Atualizar PROGRESSO.md marcando todas as etapas como concluídas e registrando quaisquer pendências conhecidas para uma futura etapa 11+

Critérios de aceite

• Fluxo completo validado rodando 100% via Docker, sem passos manuais fora do documentado
• Deduplicação confirmada em cenário real de busca repetida
• Comportamento de bloqueio/backoff observado e confirmado funcionando
• Curadoria de ramos validada de ponta a ponta
• Nenhum segredo hardcoded encontrado na revisão
• Gargalos de performance conhecidos documentados (mesmo que não resolvidos ainda)
• PROGRESSO.md refletindo o estado real final do projeto