Capítulo 29 — Construção do projeto final

Capítulo 29 — Construção do projeto final

Mapa da aula

Aula 29 publicada. Mapa, exemplo, EX085.

flowchart TD
  N0["29.1 Escopo do projeto final"]
  N1["29.2 Verificações de qualidade e de segurança"]
  N2["29.3 Documentação"]
  N3["Síntese"]
  N0 --> N1 --> N2 --> N3
  N3 --> EX["Exemplo resolvido"]
  EX --> Q["Exercício EX085"]

Desenho lógico

flowchart LR
  N0["29.1 Escopo do projeto final"]
  N1["29.2 Verificações de qualidade e de segurança"]
  N2["29.3 Documentação"]
  N3["Síntese"]
  N0 --> N1 --> N2 --> N3 --> Q["EX085"]

[29.1 Escopo do projeto final]
    |
    v
[29.2 Verificações de qualidade e de segurança]
    |
    v
[29.3 Documentação]
    |
    v
[Síntese]
    |
    v
[Exemplo resolvido] --> [Exercício EX085]

Objetivos de aprendizagem

Você vai (1) construir uma entrega de projeto final que integre as competências do curso; (2) aplicar verificações de qualidade e de segurança; (3) documentá-la para outras pessoas.

29.1 Escopo do projeto final

O projeto final de Rosa é um kit de saúde dos serviços de confiança para prefeituras pequenas: um modelo de inventário, o planejador de renovações, o resumidor de logs, a regra de monitoramento e os runbooks. Todas as ferramentas usam bibliotecas padrão ou clientes avaliados e chamam funções criptográficas consolidadas; nenhuma implementa criptografia. O kit é distribuído apenas com dados de amostra sintéticos. Sua tutora aprova o escopo porque ele integra inventário, automação, monitoramento e passagem, os temas centrais do curso. Ela define um congelamento de funcionalidades duas semanas antes da entrega, deixando tempo para os testes e a documentação, em vez de recursos de última hora.

29.2 Verificações de qualidade e de segurança

Rosa escreve testes para cada script, com as saídas esperadas a partir dos dados de amostra, espelhando os resultados de laboratório que tinha registrado antes. Ela roda um scanner de segredos, fixa as dependências e pede a um colega que revise o código usando a lista de verificação do ateliê da equipe. A revisão descobre que o resumidor de logs travaria diante de linhas inesperadas; ela o faz contar e relatar as linhas que não consegue analisar. Ela também confere que a documentação nunca sugere desativar a verificação como correção. Todos os testes rodam automaticamente a cada commit, e um teste que falha bloqueia o merge. Ela registra os comentários da revisão e suas respostas no repositório, para que os avaliadores vejam como o retorno moldou o kit final.

29.3 Documentação

O guia do kit explica a finalidade, a instalação, a configuração, as entradas e saídas de cada ferramenta, os limites e as referências usadas, incluindo a RFC 8555, a RFC 5280 e a NIST SP 800-57. Ele marca todos os dados de amostra como sintéticos. Uma seção chamada "O que este kit não faz" declara que ele não substitui uma autoridade certificadora, um HSM nem uma revisão profissional. Rosa acredita que declarar os limites com clareza protege os usuários de confiar no kit para mais do que ele consegue fazer. O guia inclui um início rápido com os dados de amostra, para que um leitor veja cada ferramenta funcionar em menos de quinze minutos. Ele também explica como relatar problemas e sugerir melhorias.

Exemplo resolvido

Rosa constrói um kit testado e revisado com planejador, resumidor, regra de monitoramento e runbooks, documentando as referências e declarando seus limites.

Caso sintético. O kit é inventado; as normas citadas são reais.

Erros e limites

Kits usados fora do contexto pretendido podem enganar. Testes com dados sintéticos não provam o comportamento com dados reais.

Exercícios

• EX085 — Conteúdo do projeto final. Liste três componentes do kit de Rosa. Rubrica: 3 = três entre modelo de inventário, planejador de renovações, resumidor de logs, regra de monitoramento, runbooks;; 2 = dois;; 1 = um;; 0 = nenhuma.

• EX086 — Correção da revisão. Que problema a revisão encontrou, e como foi corrigido? Rubrica: 3 = o resumidor travava com linhas inesperadas; agora as conta e relata;; 2 = ambos;; 1 = um;; 0 = nenhuma.

• EX087 — Seção de limites. O que diz a seção de limites? Rubrica: 3 = o kit não substitui uma AC, um HSM nem uma revisão profissional;; 2 = declaração;; 1 = vago;; 0 = nenhuma.

Síntese

Um projeto final integra as competências em ferramentas testadas, revisadas e documentadas com honestidade.

Continue estudando — aula 29 (capítulo 29 de 30)

← Capítulo 28 · Índice das aulas · Capítulo 30 →

Continue para a próxima aula já escrita.