Planos de Teste — /test-plans
Um Plano de Teste é o teste de fumaça de uma Interface: uma lista ordenada de cenários que roda de uma vez e diz o que passou e o que não passou.
É o que hoje mora no Postman de alguém — e é por isso que ele não viaja junto quando a integração é instalada em outro cliente, não é revisado por ninguém e não é reexecutado quando a integração muda.
Cada cenário executa pelo mesmo caminho do Banco de Testes, que por sua vez é o caminho de produção. Nada aqui reimplementa coleta ou entrega — então um plano verde é uma afirmação sobre o sistema de verdade.
O plano
| Campo | O que significa |
|---|---|
| Nome e descrição | Como o time se refere a este conjunto de casos |
| Interface | Escolhida na criação e não muda depois: os cenários apontam para Coletas e Entregas dela |
| Visibilidade | Público = quem já tem acesso à Interface enxerga; Privado = só você |
| Exclusão travada | Outras pessoas continuam podendo editar e executar; só o dono exclui |
O escopo do plano não é declarado — ele emerge dos cenários. A lista mostra por quais Aplicações e Definições aquele plano passa, calculado do que está dentro dele. Um campo declarado à parte mentiria no dia em que alguém acrescentasse um cenário novo.
Cenários
Um cenário é um disparo do Banco de Testes com o que se espera dele escrito junto: alvo (Coleta ou Entrega), Definição, modo, payload e parâmetros, mais as expectativas. Os alvos são os mesmos do Banco de Testes — sem as Entregas das ferramentas de Help Desk.
A ordem importa e é sua: os cenários sobem e descem na lista, e a execução segue essa sequência.
Expectativas
| Expectativa | Confere |
|---|---|
| Status final | O desfecho da mensagem (processada, erro de entrega, erro de negócio…) |
| HTTP | O código devolvido pelo destino |
| Duração máx. (ms) | O teto de tempo aceitável para aquele cenário |
| Retorno contém / não contém | Um trecho que precisa (ou não pode) aparecer na resposta |
Deixe em branco o que não quiser conferir.
O que não deu para conferir não vira verde nem vermelho: aparece em cinza, com o motivo. Um cenário sem nenhuma expectativa avaliável é marcado como sem asserção, e não como aprovado — senão um plano ficaria todo verde sem ter testado nada.
Cenários sugeridos por IA
O botão Sugerir cenários com IA monta uma lista de casos a partir do que o CMS já sabe da Interface: as Definições dela, o contrato de payload observado no tráfego real e os Erros de Negócio cadastrados. O script do Transformador não é enviado.
Os cenários sugeridos nascem desativados. Nada é executado pela sugestão: ligar e rodar continua sendo decisão de uma pessoa. Ver Governança de IA para o registro e a moderação dessas conversas.
Executar
O botão Executar roda os cenários ativos na ordem. Quando o plano escreve de verdade em algum destino, a confirmação lista quais destinos são esses e pede o nome do plano digitado — a mesma lógica do Ciclo completo no Banco de Testes, aplicada de uma vez a um conjunto.
O resultado de cada cenário é um destes:
| Resultado | Quando |
|---|---|
| Aprovado | Todas as expectativas avaliáveis bateram |
| Reprovado | Alguma expectativa não bateu — a tela mostra o esperado e o obtido |
| Sem asserção | Executou, mas não havia nada conferível |
| Erro | O disparo em si falhou |
| Não executado | O cenário estava desativado |
Histórico e PDF
Cada rodada fica guardada com quem executou, quando, a duração e o placar (“7 de 9 aprovados”). Abrir uma execução mostra cenário a cenário, com o mesmo detalhamento do Banco de Testes: o que foi enviado, o que voltou, e a comparação entre esperado e obtido.
O retorno completo só fica guardado quando o cenário reprova. Guardar o corpo de toda resposta de todo cenário de toda rodada encheria o banco com o que ninguém vai ler; o que interessa depois é sempre a falha.
O botão Baixar PDF gera o relatório da rodada — identificação da execução, resumo dos cenários e o detalhe de cada um. É o documento que se anexa a uma homologação.
O plano viaja junto
Planos de Teste entram no Import/Export de configuração e no Pack. Quando a integração é instalada em outro cliente, os casos de teste vão junto — que é exatamente o que não acontecia quando eles moravam numa coleção do Postman.
Onde fica no menu
Laboratório de Integração, logo abaixo do Banco de Testes: um plano é a mesma ação do Banco de Testes, repetida e guardada.