AULA 21 / 61 · ACESSO GRATUITO

Evidência e rastreabilidade

Graciliano TolentinoEngenharia Caracol · Edição 2.0
Nesta aula
  1. O alcance de uma prova
  2. Uma cadeia preenchida
  3. Procedimento de registro
  4. Erros e reparos
  5. Exercício com solução

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.

Cadeia em duas linhas: requisito, decisão ADR, código; depois teste, evidência EV e gate. Cada elemento aponta para a afirmação que fundamenta.Ampliar diagrama
Rastrear a afirmação até a decisão. O exemplo mostra uma ligação possível. Nem todo requisito exige um ADR próprio. Uma evidência de teste vale para a versão, o ambiente e o alcance efetivamente observados.

Uma cadeia preenchida

ElementoRegistro para REQ-002
AfirmaçãoO endpoint público de listagem não entrega registros inativos
Decisão D-CAT-02Selecionar ativos antes de formar a representação pública; publicar só id, titulo e descricao
Implementaçãopratica/src/catalogo.mjs e pratica/src/servidor.mjs
Verificação previstaDados com dois ativos e um inativo; observar lista retornada e campos de cada item
Arquivos de testepratica/tests/catalogo.test.mjs e pratica/tests/servidor.test.mjs
EntregaVersã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.

text
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ção

O 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

ErroReparo específico
Screenshot como prova de filtragem na APIExaminar resposta HTTP e executar teste com inativo conhecido
Log sem versãoAssociar execução à revisão real; se isso não puder ser recuperado, repetir a prova
Saída extensa sem conclusãoIdentificar 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 S03
Conseguiu explicar o que aprendeu?

Tente 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.