Initial commit

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

@@ -0,0 +1,40 @@
+# 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