Capítulo 48 — Dossiê de evidências
Mapa da aula
Aula 48 publicada. Mapa, exemplo, EX142.
flowchart TD
N0["48.1 Propósito"]
N1["48.2 Estrutura"]
N2["48.3 Vinculando as afirmações"]
N3["48.4 Público"]
N0 --> N1 --> N2 --> N3
N3 --> EX["Exemplo resolvido"]
EX --> Q["Exercício EX142"]
Desenho lógico
flowchart LR
N0["48.1 Propósito"]
N1["48.2 Estrutura"]
N2["48.3 Vinculando as afirmações"]
N3["48.4 Público"]
N0 --> N1 --> N2 --> N3 --> Q["EX142"]
[48.1 Propósito]
|
v
[48.2 Estrutura]
|
v
[48.3 Vinculando as afirmações]
|
v
[48.4 Público]
|
v
[Exemplo resolvido] --> [Exercício EX142]
Objetivos de aprendizagem
Você vai (1) montar um dossiê de evidências para dados governados; (2) vincular as afirmações às evidências; (3) empacotá-lo para avaliadores e reguladores.
48.1 Propósito
Kofi monta um dossiê de evidências para o projeto final e para o trabalho mais amplo de governança das perdas. O dossiê deve permitir que um avaliador ou regulador verifique as afirmações sem pedir explicações a Kofi. Cada afirmação, como a de que os dados de pressão têm donos nomeados ou a de que os controles detectam sensores travados, aponta para evidências: registros de titularidade, registros de testes, constatações de revisão, relatórios de ensaios e registros de decisão. Ele explica que um dossiê é um argumento sustentado por evidências, e não uma pilha de documentos. Cada vínculo é conferido antes de o dossiê ser emitido.
48.2 Estrutura
Kofi estrutura o dossiê em torno dos requisitos: para cada requisito, a afirmação, os controles, as evidências e as limitações. Um índice permite saltar para qualquer requisito. Os arquivos de evidência são guardados com datas e versões, e sua integridade é registrada com hashes calculados com o hashlib do Python, para que os leitores possam confirmar que os arquivos não mudaram desde a montagem. Ele inclui também o registro da revisão independente e suas respostas, que mostram como o projeto evoluiu. O hash de cada arquivo aparece no índice ao lado de seu título, data e número de versão.
48.3 Vinculando as afirmações
Kofi verifica se cada afirmação tem evidência e encontra duas sem ela: a de que os curadores foram treinados e a de que as regras de retenção se aplicam aos dados de pressão. Para o treinamento, ele obtém as listas de presença. Para a retenção, descobre que a regra existe na política, mas nunca foi configurada para os dados de pressão; então ele a configura, testa e acrescenta o resultado. Ele observa que montar as evidências pode revelar distâncias entre a política e a prática que ninguém havia notado. As duas novas evidências entram no índice com seus hashes.
48.4 Público
Kofi escreve um resumo para não especialistas e deixa os detalhes técnicos nos apêndices. Ele pede a uma colega que não conhece o projeto que encontre as evidências de três afirmações escolhidas ao acaso, cronometrando a busca. Cada uma leva menos de cinco minutos. A Profa. Varga observa que os dossiês funcionam quando os leitores conseguem navegar neles sozinhos, e que a disciplina de comprovar cada afirmação torna os engenheiros mais cuidadosos com o que afirmam desde o início. Kofi revisa duas entradas do índice que atrasaram a colega, deixando seus títulos mais claros e acrescentando remissões a partir dos requisitos relacionados.
Exemplo resolvido
Kofi estrutura um dossiê por requisito, com arquivos de evidência protegidos por hash, encontra duas afirmações sem sustentação e fecha uma lacuna na configuração da retenção, e testa a navegação com uma colega que não conhece o projeto.
Caso sintético. O dossiê é sintético.
Erros e limites
Afirmações sem evidência enfraquecem o dossiê inteiro; retire-as ou sustente-as.
Exercícios
- EX142 — Propósito do hash. Por que os arquivos de evidência recebem hash? Rubrica: 3 = para confirmar que não mudaram;; 2 = parcialmente correto;; 1 = vago;; 0 = nenhuma.
- EX143 — Lacuna de retenção. O que a afirmação sobre retenção revelou? Rubrica: 3 = a regra nunca foi configurada para os dados de pressão;; 2 = parcialmente correto;; 1 = vago;; 0 = nenhuma.
- EX144 — Teste de navegação. Como a navegação foi testada? Rubrica: 3 = uma colega que não conhecia o projeto encontrou as evidências de afirmações aleatórias;; 2 = parcialmente correto;; 1 = vago;; 0 = nenhuma.
Continue estudando — aula 48 (capítulo 48 de 50)
← Capítulo 47 · Índice das aulas · Capítulo 49 →
Continue para a próxima aula já escrita.