Capítulo 7 — Síntese da tese e arquivo de reprodutibilidade
Mapa da aula
Aula 07 publicada. Mapa, exemplo, EX039.
flowchart TD
N0["7.1 Construção do argumento"]
N1["7.2 Contribuições proporcionais"]
N2["7.3 O arquivo de reprodutibilidade"]
N3["Laboratório — Manifesto do arquivo e verificação"]
N4["7.4 Confidencial versus compartilhável"]
N5["7.5 Escrever bem as limitações"]
N6["Síntese"]
N0 --> N1 --> N2 --> N3 --> N4 --> N5 --> N6
N6 --> EX["Exemplo resolvido"]
EX --> Q["Exercício EX039"]
Desenho lógico
flowchart LR
N0["7.1 Construção do argumento"]
N1["7.2 Contribuições proporcionais"]
N2["7.3 O arquivo de reprodutibilidade"]
N3["Laboratório — Manifesto do arquivo e verificação"]
N4["7.4 Confidencial versus compartilhável"]
N5["7.5 Escrever bem as limitações"]
N6["Síntese"]
N0 --> N1 --> N2 --> N3 --> N4 --> N5 --> N6 --> Q["EX039"]
[7.1 Construção do argumento]
|
v
[7.2 Contribuições proporcionais]
|
v
[7.3 O arquivo de reprodutibilidade]
|
v
[Laboratório — Manifesto do arquivo e verificação]
|
v
[7.4 Confidencial versus compartilhável]
|
v
[7.5 Escrever bem as limitações]
|
v
[Síntese]
|
v
[Exemplo resolvido] --> [Exercício EX039]
Objetivos de aprendizagem
Você vai (1) sintetizar os estudos num argumento de tese coerente; (2) declarar as contribuições e os limites na proporção das evidências; (3) construir um arquivo de reprodutibilidade com verificações de integridade; (4) separar os artefatos compartilháveis dos dados confidenciais.
7.1 Construção do argumento
A tese de Amara tem quatro partes empíricas: o manual de codificação e sua concordância, a replicação da linha de base, o piloto e o estudo principal com validação. O capítulo de síntese as liga num único argumento. A medição confiável tornou a linha de base digna de confiança; a linha de base expôs um erro no dashboard; o piloto refinou o protocolo; e o estudo principal estimou um efeito modesto que sobreviveu à validação e à crítica. Cada elo nomeia sua evidência. Uma tese não é uma coleção de artigos, mas um argumento em que cada parte fornece uma premissa, e a síntese mostra ao leitor como as premissas sustentam a conclusão.
7.2 Contribuições proporcionais
Ela lista as contribuições com a força da evidência de cada uma. Forte: um manual de codificação reutilizável com concordância substancial e um pacote público de replicação sintética. Moderada: uma estimativa de cerca de um quinto a menos de defeitos de arquitetura pós-lançamento numa organização. Fraca e exploratória: a associação entre fidelidade e efeito. Ela lista o que a tese não mostra: efeitos em outros setores, efeitos sobre defeitos não descobertos ou sobre a qualidade do design no longo prazo. A proporção importa porque os leitores da indústria podem adotar práticas com base no resumo de uma tese, e o exagero pode desperdiçar seus recursos ou criar uma falsa confiança.
7.3 O arquivo de reprodutibilidade
Os registros reais de defeitos não podem sair da Tessaro, então o arquivo de Amara contém os scripts de análise, o manual de codificação, o checklist de fidelidade, um conjunto de dados sintético gerado para reproduzir a estrutura e as estatísticas resumidas dos dados reais e um documento que explica como os dados reais podem ser solicitados mediante acordo. Cada arquivo é listado num manifesto com seu digest SHA-256, para que qualquer pessoa possa conferir se o que baixou é o que ela arquivou. O laboratório abaixo constrói um manifesto assim para arquivos sintéticos e o verifica. Ela deposita o arquivo com um identificador persistente no repositório da universidade.
Laboratório — Manifesto do arquivo e verificação
# Build and verify a SHA-256 manifest for a synthetic replication package.
import hashlib
files = {"analysis/did.py": b"# synthetic analysis script\n", "data/synthetic_teams.csv": b"team,wave,pre,post\nT01,1,3.6,2.9\n",
"docs/coding_manual.md": b"# Coding manual v3\n", "docs/fidelity_checklist.md": b"- DFD drawn\n- STRIDE per element\n"}
manifest = {p: hashlib.sha256(b).hexdigest() for p, b in files.items()}
files["data/synthetic_teams.csv"] += b"T02,2,4.1,3.0\n" # simulated later edit
for p, b in files.items():
print(f"{p:28} {'OK' if hashlib.sha256(b).hexdigest() == manifest[p] else 'MISMATCH'}")
Execute com python3 lab_archive.py. Saída verificada:
analysis/did.py OK
data/synthetic_teams.csv MISMATCH
docs/coding_manual.md OK
docs/fidelity_checklist.md OK
7.4 Confidencial versus compartilhável
Amara aplica uma regra simples: compartilhar tudo o que não identifique pessoas, clientes ou fraquezas exploráveis. Os manuais de codificação, os scripts e os dados sintéticos são compartilhados. As descrições reais dos defeitos, que poderiam revelar vulnerabilidades ativas nos sistemas da Tessaro, não são. As transcrições das entrevistas são resumidas em temas, sem citações que possam identificar os arquitetos. Ela pede à equipe de segurança da Tessaro que revise o arquivo em busca de divulgações acidentais, e eles encontram um comentário de script que nomeia um sistema interno, que ela remove. O compartilhamento responsável torna o trabalho reprodutível sem criar um mapa das fraquezas da parceira.
7.5 Escrever bem as limitações
A seção de limitações é específica. Em vez de dizer que os resultados podem não se generalizar, Amara escreve que a Tessaro tem um conselho central de arquitetura e um rastreamento de defeitos maduro, de modo que as organizações que não têm um ou outro podem ver efeitos diferentes. Em vez de dizer que a medição pode ser imperfeita, ela informa o valor da concordância e nomeia os tipos de defeito que os codificadores acharam mais difíceis de classificar. Limitações específicas ajudam pesquisadores futuros a desenhar estudos melhores e mostram aos examinadores que a candidata entende as evidências bem o bastante para saber exatamente onde elas param. Limitações vagas, ao contrário, soam como ritual e costumam ser puladas.
Exemplo resolvido
Amara escreve um capítulo de síntese que liga quatro estudos, classifica as contribuições como fortes, moderadas ou fracas, constrói um manifesto SHA-256 para um pacote de replicação sintética e remove um comentário revelador depois da revisão da parceira.
Caso sintético. O conteúdo do arquivo e a revisão da parceira são sintéticos.
Erros e limites
Os conjuntos de dados sintéticos podem omitir correlações que importam para algumas análises. Os manifestos detectam mudanças, mas não autenticam a autora, a menos que sejam assinados.
Exercícios
-
EX039 — Tese versus artigos. Em que uma tese difere de um conjunto de artigos? Rubrica: 3 = é um único argumento em que cada parte fornece uma premissa;; 2 = argumento;; 1 = é igual;; 0 = nenhuma.
-
EX040 — Contribuições classificadas. Que contribuição Amara classificou como fraca e exploratória? Rubrica: 3 = a associação entre fidelidade e efeito;; 2 = nomeada;; 1 = a estimativa do efeito;; 0 = nenhuma.
-
EX041 — Resultado do manifesto. O que o laboratório relatou depois que um arquivo arquivado foi alterado? Rubrica: 3 = o arquivo alterado falhou na verificação e os outros passaram;; 2 = falha registrada;; 1 = todos passaram;; 0 = nenhuma.
-
EX042 — Papel dos dados sintéticos. Por que o arquivo contém dados sintéticos, e não reais? Rubrica: 3 = os registros reais de defeitos são confidenciais e poderiam revelar vulnerabilidades ativas;; 2 = confidenciais;; 1 = não são necessários;; 0 = nenhuma.
-
EX043 — Comentário no script. O que a revisão da Tessaro encontrou no arquivo? Rubrica: 3 = um comentário de script que nomeia um sistema interno, depois removido;; 2 = comentário;; 1 = vago;; 0 = nenhuma.
-
EX044 — Limitação específica. Reescreva de forma específica os resultados podem não se generalizar. Rubrica: 3 = a Tessaro tem um conselho central de arquitetura e rastreamento maduro; organizações sem isso podem ser diferentes;; 2 = específica;; 1 = vaga;; 0 = nenhuma.
Síntese
A síntese de uma tese argumenta de forma proporcional a partir de evidências encadeadas e deixa um arquivo verificado e anonimizado com responsabilidade.
Continue estudando — aula 07 (capítulo 07 de 08)
← Capítulo 06 · Índice das aulas · Capítulo 08 →
Continue para a próxima aula já escrita.