Relatórios, congelamento, liberação¶
Um relatório é um artefato gerado, produzido por marco de um engajamento (uma primeira entrega, relatórios de reteste intermediários, um relatório final). Entender um relatório é entender dois eixos independentes e um momento irreversível.
Geração é um eixo¶
Um relatório gerado tem um status de produção: pending enquanto o job roda, ready quando o arquivo
existe em disco (com caminho, tamanho e hash registrados), ou failed com um motivo. Um relatório
ready é um PDF de verdade (ou o formato escolhido) que o PEART produziu, com um hash de conteúdo que
ele pode mostrar como impressão digital de integridade.
Liberação é o outro eixo¶
Liberação é separada da geração. Um relatório ready é interno até ser liberado, quando então passa
a ser visível ao cliente pelo portal. A liberação é o momento em que o relatório cruza a fronteira do seu
trabalho para as mãos do cliente, e o portal só serve relatórios liberados, escopados ao cliente a que
pertencem.
O que a liberação congela¶
A liberação congela o relatório num registro fixo. As revisões publicadas de achado que ele contém, e os mapeamentos de conformidade de cada achado, são capturados como estavam na liberação, com sua procedência, então um relatório entregue continua afirmando o que afirmou mesmo que os achados vivos sigam evoluindo depois. O prazo de remediação é fixado na liberação da mesma forma. Retirar uma liberação e liberar de novo recongela a partir do estado atual.
O resumo de reteste¶
Nem toda entrega é um relatório completo. O resumo de reteste é um documento de tipo próprio: um PDF curto que diz em que pé estão os achados do engajamento depois dos ciclos de reteste, sem repetir o relatório inteiro.
Tipo e formato são coisas diferentes. O formato é a codificação (PDF, Markdown, XLSX); o tipo diz o que
o documento é, completo ou resumo de reteste. O resumo existe somente em PDF, que é a forma que
circula e a que pode ser assinada.
O resumo nomeia o relatório completo que resume. Essa referência é escolhida e congelada na geração: identificador, formato, data de geração e o hash do documento gerado. Se nenhum relatório completo estava liberado naquele momento, o resumo diz isso por escrito, em vez de apontar para o nada.
Por isso, retirar um relatório completo retira também todo resumo liberado do mesmo engajamento, na mesma operação. Os números do resumo vêm das revisões congeladas do engajamento, então, com o relatório completo retirado, um resumo nas mãos do cliente estaria afirmando algo que a consultoria acabou de tornar sem efeito. Liberar de novo é um gesto; um documento com afirmação falsa circulando não volta.
Relatórios e o portal¶
O cliente alcança os relatórios liberados pelo portal, sobre um canal autenticado, escopado e TLS. Um perfil de relatório governa o que a visão do cliente mostra. Todo marco liberado é baixável ali, então os entregáveis vivem num lugar controlado em vez de anexos de email.