Capítulo 45 — Revisão independente de projeto
Mapa da aula
Aula 45 publicada. Mapa, exemplo, EX089.
flowchart TD
N0["45.1 Independência e propósito"]
N1["45.2 Critérios de revisão"]
N2["45.3 Escrevendo as constatações"]
N3["45.4 Respondendo à revisão"]
N4["45.6 Atividade prática"]
N5["Síntese do capítulo"]
N0 --> N1 --> N2 --> N3 --> N4 --> N5
N5 --> EX["Exemplo resolvido"]
EX --> Q["Exercício EX089"]
Desenho lógico
flowchart LR
N0["45.1 Independência e propósito"]
N1["45.2 Critérios de revisão"]
N2["45.3 Escrevendo as constatações"]
N3["45.4 Respondendo à revisão"]
N4["45.6 Atividade prática"]
N5["Síntese do capítulo"]
N0 --> N1 --> N2 --> N3 --> N4 --> N5 --> Q["EX089"]
[45.1 Independência e propósito]
|
v
[45.2 Critérios de revisão]
|
v
[45.3 Escrevendo as constatações]
|
v
[45.4 Respondendo à revisão]
|
v
[45.6 Atividade prática]
|
v
[Síntese do capítulo]
|
v
[Exemplo resolvido] --> [Exercício EX089]
Objetivos de aprendizagem e conexão
Ao fim deste capítulo você será capaz de (1) conduzir uma revisão técnica independente do projeto de outra equipe usando critérios estruturados; (2) escrever constatações específicas, evidenciadas e acionáveis; (3) classificar as constatações por gravidade e recomendar encaminhamentos; e (4) receber uma revisão do seu próprio projeto e respondê-la. Ele aplica o rigor ao estilo de Fagan (Capítulo 14) a projetos inteiros e prepara o Projeto final II.
45.1 Independência e propósito
Um revisor independente não trabalhou no projeto e não se reporta a seus autores. A independência pega erros que os autores não conseguem ver — pressupostos compartilhados, pontos cegos, verificação otimista. O propósito é melhorar o projeto e a decisão sobre ele, e não marcar pontos. Para o TMRP, o revisor do dossiê do projeto final é alguém que não trabalhou no gateway e não se reporta a seus autores. Essa independência é a razão pela qual o revisor percebeu que o caso de garantia citava o T3 como aprovado enquanto a matriz ainda o registrava como reprovado, uma inconsistência pela qual os autores tinham passado muitas vezes sem notar.
45.2 Critérios de revisão
Revise contra: os requisitos (completos, verificáveis, rastreados); a arquitetura (orientada pelas consequências, comportamento diante de falhas e ataques analisado); os controles (especificados com desempenho, camadas independentes); as análises (pressupostos declarados, números consistentes); a verificação (o plano cobre os requisitos, reprovações tratadas com honestidade); as operações (procedimentos, treinamento, recuperação); a manutenibilidade; e o caso de garantia (alegações apoiadas, derrotadores declarados). Cada critério corresponde a um capítulo deste livro: requisitos ao Capítulo 21, arquitetura ao Capítulo 26, controles ao Capítulo 27, verificação aos capítulos 30 e 40, operações ao Capítulo 37 e o caso de garantia ao Capítulo 35. Os revisores do dossiê do TMRP usaram essa lista como checklist.
45.3 Escrevendo as constatações
Uma constatação declara: o que foi observado (com uma referência ao documento ou à evidência), por que importa (consequência), o critério em que falha e uma recomendação. Gravidade: crítica (a alegação não pode ser apoiada, ou há risco à segurança operacional), maior (lacuna significativa que exige mudança antes da aprovação), menor (melhoria), observação (nenhuma mudança exigida). Evite constatações vagas ("a segurança parece fraca") e o projeto pelo revisor (prescrever sua solução favorita quando várias serviriam). As constatações do TMRP no exemplo resolvido abaixo seguem essa forma. A F4, sobre a fração da bateria, é menor porque a alegação sobrevive com uma fonte acrescentada.
45.4 Respondendo à revisão
Os autores respondem a cada constatação: aceitar (com mudança), rejeitar (com raciocínio e evidências) ou adiar (com dono e data). O revisor confere as respostas e encerra ou escalona as constatações. Divergências que não podem ser resolvidas vão para o dono da decisão, com as duas posições registradas. Para o TMRP, os autores aceitaram a F2 e acrescentaram o alarme de estação inativa, e aceitaram a F3 relatando R6 como não atendido e orçando opções no ADR-015. Cada resposta nomeou um dono, e o revisor conferiu a campanha executada de novo antes de encerrar a F2.
45.5 Exemplo resolvido: constatações sobre o dossiê do TMRP (sintético)
- F1 (crítica): a subalegação C2 do caso de garantia cita o T3 como aprovado, mas a matriz de rastreabilidade (Laboratório 14) registra o T3 como reprovado, e o novo teste na v2 não está registrado. Recomendação: registrar as evidências do novo teste ou rebaixar a alegação.
- F2 (maior): o receptor não alarma diante de dados ausentes (descartes silenciosos no Laboratório 15); R7 não pode ser alegado para eventos de perda de dados. Recomendação: acrescentar o alarme de estação inativa e executar de novo a campanha.
- F3 (maior): o ensaio de restauração (Capítulo 47) mostra 12 h contra as 8 h de R6; o dossiê declara R6 como atendido. Recomendação: relatar R6 como não atendido e apresentar opções.
- F4 (menor): o dimensionamento das baterias usa uma fração utilizável de 0,6 sem fonte; cite os dados do fabricante das baterias.
- F5 (observação): a avaliação ponderada dos conceitos (§25.4) é sensível ao peso da operabilidade; a decisão continua defensável.
45.6 Atividade prática
Troque dossiês de projeto final com outro estudante, revise segundo os critérios da §45.2 e escreva pelo menos seis constatações com gravidades. Escolha um revisor que não tenha ajudado no seu projeto. Para cada constatação, inclua a observação com sua referência, a consequência, o critério em que falha e uma recomendação. Use os quatro níveis de gravidade com honestidade. Depois troquem de papéis e responda às constatações sobre seu próprio dossiê com aceitar, rejeitar ou adiar, dando evidências para cada rejeição. Guarde os dois registros no seu dossiê. Atenha-se às evidências.
45.7 Erros comuns e limites
- Revisões feitas por pessoas que ajudaram no projeto.
- Constatações vagas ou sem evidências.
- Inflação ou deflação da gravidade.
- Autores que rejeitam constatações sem evidências.
A revisão do TMRP evitou esses erros: o revisor era independente, cada constatação citava um documento, as gravidades correspondiam às consequências, e as respostas dos autores eram apoiadas em evidências e conferidas antes do encerramento. A F5 foi mantida como observação, sem ser inflada. A F1 foi classificada como crítica porque a alegação não podia ser apoiada tal como escrita, e não porque o erro fosse constrangedor, e os autores não rejeitaram nenhuma constatação sem evidências que apoiassem a rejeição.
Exercícios — capítulo 45
EX089 — Reescreva constatações fracas. Objetivo: escrever constatações acionáveis. Entradas: "a gestão de chaves não está ótima"; "os testes parecem incompletos"; "eu usaria OPC UA no lugar". Passos: reescreva cada uma como uma constatação adequada ou explique por que deveria ser retirada. Evidência esperada: três reescritas. Rubrica: 3 = observação específica, consequência, critério, recomendação; a terceira retirada ou reformulada como preocupação baseada em requisitos; 2 = uma vaga; 1 = mera troca de palavras; 0 = nada.
EX090 — Responda à F2 e à F3. Objetivo: responder à revisão. Entradas: §45.5. Passos: escreva as respostas dos autores à F2 e à F3, com encaminhamentos, mudanças, donos e datas. Evidência esperada: duas respostas. Rubrica: 3 = F2 aceita com mudança de projeto e novo teste, F3 aceita com relato honesto e opções (paralelizar a recuperação, imagens pré-construídas, revisar o requisito com acordo das partes interessadas); 2 = defensiva; 1 = rejeita; 0 = nada.
Síntese do capítulo
A revisão independente encontra o que os autores não conseguem ver. Revise contra critérios explícitos, escreva constatações específicas, evidenciadas e acionáveis, com gravidades honestas, e responda a cada constatação com aceitar, rejeitar ou adiar — registrado e conferido.
Continue estudando — capítulo 45 de 50
← Capítulo 44 · Índice de capítulos do curso · Capítulo 46 →
Siga para a próxima lição escrita.