Casos de teste e regressão
Casos de teste transformam eventos importantes em verificações automáticas. Sempre que o conteúdo muda, o RuleForge roda os casos e avisa se algo deixou de funcionar. Essa prática se chama regressão.
Por que usar
Uma regra detectando corretamente hoje pode deixar de detectar depois de uma alteração. Sem casos de teste, você só descobre isso em produção. Com casos, o RuleForge te avisa antes.
O que um caso registra
- Nome e descrição.
- O evento de exemplo.
- O formato do log.
- O que se espera como resultado: qual decoder deve ser aplicado, qual regra deve disparar, quais campos devem ser extraídos.
Criar um caso
- No projeto, abra Casos.
- Clique em Novo caso.
- Informe nome, formato do log e o evento.
- Salve.
- Adicione as expectativas (o que deve acontecer quando o evento for processado).
Dica: capture os eventos reais que você investigou durante o trabalho. Eles se tornam a melhor base de casos.
Rodar casos
- Rodar um caso individual — útil depois de uma alteração específica que afeta só aquela detecção.
- Rodar regressão em lote — roda todos os casos do projeto. Use antes de abrir uma revisão ou criar uma versão.
O resultado mostra quais passaram, quais falharam e, para os que falharam, o que divergiu da expectativa.
Boas práticas
- Registre casos para os cenários mais sensíveis desde cedo.
- Preencha as expectativas com cuidado — um caso mal definido gera "falhas" confusas.
- Sempre rode a regressão antes de abrir uma revisão.
- Mantenha os casos vivos: quando uma detecção muda de propósito, atualize o caso correspondente.
Erros comuns
"A regressão falhou, mas não entendo o motivo"
Verifique se as expectativas do caso refletem o comportamento correto. Uma expectativa desatualizada é motivo frequente de falsa falha.
"Não consigo editar um caso"
Seu papel pode permitir executar, mas não editar. Consulte Papéis e permissões.
"O resultado mudou quando troquei de workspace"
É esperado. O conteúdo do workspace ativo influencia o resultado do caso.