Capítulo 38 — Execução do projeto final

Mapa da aula

Aula 38 publicada. Mapa, exemplo, EX075.

flowchart TD
  N0["38.1 Executando o plano"]
  N1["38.2 Reprodutibilidade"]
  N2["38.3 Mudanças de escopo"]
  N3["38.4 Registros de decisão"]
  N4["38.6 Atividade prática"]
  N5["38.8 Trabalhando com os orientadores"]
  N6["Síntese"]
  N0 --> N1 --> N2 --> N3 --> N4 --> N5 --> N6
  N6 --> EX["Exemplo resolvido"]
  EX --> Q["Exercício EX075"]

Desenho lógico

flowchart LR
  N0["38.1 Executando o plano"]
  N1["38.2 Reprodutibilidade"]
  N2["38.3 Mudanças de escopo"]
  N3["38.4 Registros de decisão"]
  N4["38.6 Atividade prática"]
  N5["38.8 Trabalhando com os orientadores"]
  N6["Síntese"]
  N0 --> N1 --> N2 --> N3 --> N4 --> N5 --> N6 --> Q["EX075"]

[38.1 Executando o plano]
    |
    v
[38.2 Reprodutibilidade]
    |
    v
[38.3 Mudanças de escopo]
    |
    v
[38.4 Registros de decisão]
    |
    v
[38.6 Atividade prática]
    |
    v
[38.8 Trabalhando com os orientadores]
    |
    v
[Síntese]
    |
    v
[Exemplo resolvido] --> [Exercício EX075]

Objetivos de aprendizagem

Você vai (1) executar o plano do seu projeto final com marcos; (2) manter código e registros de laboratório reprodutíveis; (3) gerenciar as mudanças de escopo; e (4) documentar as decisões ao longo do caminho.

38.1 Executando o plano

Trabalhe em marcos: ambiente pronto; primeiros dados ou primeiro modelo; primeira análise; análise completa; rascunho do relatório. Em cada marco, compare o progresso com o plano e registre os desvios. Um progresso pequeno e frequente vale mais que grandes esforços tardios.

Planeje uma folga antes do marco do rascunho do relatório, já que a análise quase sempre leva mais tempo que o esperado. Se um marco atrasar, diga isso cedo e ajuste o que vem depois, em vez de comprimir a escrita nas últimas semanas. Uma nota curta em cada marco, dizendo o que foi feito e o que vem a seguir, facilita muito o relato posterior.

38.2 Reprodutibilidade

Use controle de versão para o código, a configuração e o texto. Registre as versões do ambiente. Escreva scripts que regenerem cada figura e tabela a partir das entradas brutas. Mantenha os geradores de dados sintéticos com sementes fixas, para que os resultados possam ser reproduzidos exatamente, como fazem os laboratórios deste livro.

Teste você mesmo a reprodutibilidade antes da entrega, clonando o repositório num ambiente limpo e rodando tudo do zero. Qualquer coisa que falhe ali falharia também para um examinador. Registre a data e o resultado dessa verificação no seu registro de laboratório, para poder mostrar que ela foi feita.

38.3 Mudanças de escopo

As descobertas mudam os planos. Se a documentação de um fornecedor mostrar que um laboratório planejado é impossível, registre a mudança, o seu motivo e o seu efeito sobre os objetivos, e acorde-a com o seu orientador. As mudanças de escopo silenciosas tornam a avaliação injusta e as conclusões pouco claras.

Mantenha as mudanças de escopo no mesmo lugar que os registros de decisão, para que o relatório final possa listá-las juntas. Uma mudança que estreita o trabalho é aceitável se for explicada; uma mudança escondida nos resultados não é. A sua avaliação será julgada pelo escopo acordado, então garanta que ele esteja atualizado.

38.4 Registros de decisão

Mantenha registros de decisão curtos: contexto, opções, decisão, consequências. "Escolhemos o ML-KEM-768, e não o -1024, para o laboratório porque a política sintética da HCU exige a categoria 3 e o grupo TLS usa o -768." Os registros de decisão tornam o relatório final mais fácil de escrever e de defender.

Escreva cada registro no momento da decisão. Um registro escrito meses depois tende a justificar o resultado, em vez de explicar o raciocínio, e os revisores costumam perceber a diferença. No projeto final, uma pasta de registros datados de uma página basta.

38.5 Exemplo resolvido

O projeto final do Capítulo 35 constrói um gerador de CBOM sintética da HCU com 60 ativos e semente fixa, um script de classificação que varia z de 10 a 25 anos e um gerador de relatórios. No marco 3, o estudante descobre que a classificação dos cinco primeiros muda em z = 12 porque os registros dos associados entram. Registro de decisão: relatar a mudança como um achado e acrescentar uma figura de sensibilidade, em vez de ajustar as hipóteses para tornar a classificação estável.

A figura de sensibilidade se tornou depois um dos principais resultados do projeto final. Ela foi mantida no relatório final.

38.6 Atividade prática

Configure o seu repositório com o código, o gerador de dados, o modelo de registro de laboratório e a pasta de registros de decisão; complete a revisão do seu primeiro marco.

A revisão do marco deve comparar o que você planejou com o que fez e registrar quaisquer mudanças. Verifique se um clone novo do repositório consegue rodar o gerador de dados e reproduzir os primeiros resultados. Se não conseguir, corrija isso antes de seguir adiante, porque o problema só cresce à medida que mais código e dados são acrescentados. Depois planeje o segundo marco com datas.

38.7 Erros comuns e limites

• Trabalho sem controle de versão.
• Figuras feitas à mão que não podem ser regeneradas.
• Ajustar as hipóteses para obter um resultado preferido.
• Deixar os registros de decisão para o fim, quando os motivos já foram esquecidos.
• Mudar o escopo sem registrar.
• Guardar os dados brutos apenas num laptop.
• Pular as revisões de marco quando o trabalho vai bem, que é quando os pequenos problemas são mais fáceis de corrigir.

Cada um desses torna o relatório final mais difícil de escrever e de defender. A maioria pode ser evitada com uma rotina semanal fixa de commits, anotações e uma breve verificação em relação ao plano.

38.8 Trabalhando com os orientadores

Compartilhe as revisões de marco com o seu orientador de forma breve e regular: o que foi feito, o que foi aprendido, o que está bloqueado e que decisão você precisa. Os orientadores só conseguem ajudar com os problemas de que sabem, e uma atualização curta por escrito cria um registro que depois mostra como o trabalho evoluiu.

Guarde as atualizações no repositório. Uma boa atualização cabe em poucas linhas e termina com uma pergunta clara quando você precisa de uma decisão. Registre a resposta nos seus registros de decisão, para que as mudanças acordadas de método ou de escopo fiquem visíveis depois e não sejam reabertas na fase de avaliação.

Exercícios

• EX075 — Registro de decisão. Escreva um registro de decisão para a escolha de um conjunto de dados sintético em vez de dados reais. Rubrica: 3 = contexto, opções, decisão, consequências.
• EX076 — Auditoria de reprodutibilidade. Liste cinco verificações que um colega deveria rodar para confirmar que o seu projeto final é reprodutível. Rubrica: 3 = cinco verificações concretas.

Síntese

Os marcos, o controle de versão, os scripts reprodutíveis, as mudanças de escopo registradas e os registros de decisão transformam o plano de um projeto final num trabalho crível.