Evidência e rastreabilidade
Nesta aula
O alcance de uma prova
Evidência é informação identificável que sustenta uma afirmação dentro de limites. Uma imagem pode mostrar a aparência de uma tela; não demonstra, sozinha, que inativos nunca são enviados pela API. A saída de um comando pode demonstrar que certas verificações foram executadas numa versão; não comprova requisitos que elas não examinam. Antes de guardar um arquivo, escreva a afirmação que ele deveria sustentar.
Rastreabilidade é a ligação entre essa afirmação, seu requisito, a decisão adotada, os arquivos e a verificação correspondente. Ela permite responder por que existe um teste e que prova precisa ser revista após uma mudança. Em um projeto pequeno, uma tabela curta pode ser suficiente. Criar links sem explicar a relação apenas desloca a informação para outro lugar.
A força da evidência depende de versão, ambiente, entrada, procedimento, resultado e conclusão compatível com o resultado. Um log bruto pode conter erros ignorados; um resumo escrito pode omitir a falha. Conserve o que permite conferir a conclusão e indique limitações. S16, nas atividades de teste, diferencia produtos de teste e resultados; S07, na seção sobre registro de alterações, mostra como o histórico de versões ajuda a identificar mudanças.
Uma cadeia preenchida
| Elemento | Registro para REQ-002 |
|---|---|
| Afirmação | O endpoint público de listagem não entrega registros inativos |
| Decisão D-CAT-02 | Selecionar ativos antes de formar a representação pública; publicar só id, titulo e descricao |
| Implementação | pratica/src/catalogo.mjs e pratica/src/servidor.mjs |
| Verificação prevista | Dados com dois ativos e um inativo; observar lista retornada e campos de cada item |
| Arquivos de teste | pratica/tests/catalogo.test.mjs e pratica/tests/servidor.test.mjs |
| Entrega | Versão identificada no registro de execução e no gate do incremento |
Essa cadeia distingue ocultar visualmente e não entregar o registro. Esconder uma linha com CSS não satisfaz a afirmação do exemplo, pois o dado pode continuar acessível na resposta. Os testes do módulo verificam seleção; o teste do servidor verifica a fronteira HTTP, isto é, o intercâmbio entre cliente e servidor. A inspeção no navegador verifica a apresentação, com alcance diferente.
Registro planejado E-CAT-02
Afirmação: REQ-002, ausência de inativos na listagem pública
Diretório de execução: pratica
Comandos: node --version; npm test; npm run validate
Entrada controlada: dois casos ativos e um inativo
Esperado: só os dois ativos, com id, titulo e descricao
Resultado observado: ainda não registrado neste exemplo
Versão/ambiente: capturar na execução
Conclusão: evidência planejada; não autoriza liberaçãoO preenchimento é útil justamente porque não simula uma aprovação. Na execução, substitua a indicação de pendência por versão real, ambiente, saída e conclusão derivada. Não edite uma falha para parecer sucesso: registre a correção e preserve a tentativa anterior quando ela explicar a decisão.
Procedimento de registro
- Escreva requisito, afirmação e critério que será avaliado.
- Escolha uma prova que observe a fronteira correta: função, HTTP, navegador ou operação.
- Identifique entrada, comando ou passos manuais, versão e ambiente.
- Registre resultado observado, diferenças em relação ao esperado e limites da conclusão.
- Vincule a evidência ao gate e marque as mudanças que exigirão revalidação. Evite incluir segredos ou dados pessoais no registro.
Erros e reparos
| Erro | Reparo específico |
|---|---|
| Screenshot como prova de filtragem na API | Examinar resposta HTTP e executar teste com inativo conhecido |
| Log sem versão | Associar execução à revisão real; se isso não puder ser recuperado, repetir a prova |
| Saída extensa sem conclusão | Identificar critérios aprovados e falhas, sem ocultar a saída necessária à conferência |
Exercício com solução
Dados: uma captura mostra apenas Revisão de texto e Oficina de escrita. A resposta HTTP salva contém também Diagramação, marcada como inativa. A regra exige não revelar inativos. O responsável afirma que a captura prova REQ-002. Avalie e proponha a correção.
Ver solução comentada
Solução: a captura sustenta somente o estado visual observado. A resposta contradiz a afirmação de não entrega do inativo; o gate dessa capacidade deve ser bloqueado. Corrigir a seleção ou a formação da resposta na fronteira adequada, depois repetir teste do módulo, do servidor e a inspeção pertinente. Anexar resposta sem o inativo e identificar a versão corrigida.
- Rubrica: distinguir aparência de entrega do dado, rejeitar a conclusão excessiva e escolher prova que possa revelar o erro.
- O avanço exige cadeia completa, resultado aceitável e limites claros; completar a tabela sem executar a verificação não satisfaz o gate.
Fontes relacionadas
Consulte os limites e as seções de apoio de cada referência.
S16 S07 S03Tente o exercício antes de consultar a solução. Marque a aula para organizar sua leitura.
A conclusão desta leitura não equivale a certificação ou aceite de um projeto real. Teste os exemplos no escopo indicado e registre as limitações.