41 lines
2.5 KiB
Markdown
41 lines
2.5 KiB
Markdown
# 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
|