Percurso 07Lição 3 / 8

Reveja o Discovery como um conjunto de documentos ligados

Siga um requisito pela especificação, arquitetura, fluxo de dados e documentos de segurança. Trate das revisões antes de o planeamento depender de pressupostos desatualizados.

Prática12 minRevisto

Publicado por Como escrevemos

Verifique a sua compreensãoPublica uma especificação revista depois de gerar os documentos que dela dependem. O que deve fazer?Faça o exercício
Publica uma especificação revista depois de gerar os documentos que dela dependem. O que deve fazer?

O que vai aprender

  • Explicar a importância da ordem dos documentos e do estado de publicação.
  • Identificar o impacto de uma especificação alterada nos documentos dependentes.
  • Distinguir conteúdo gerado, publicado, revisto e desatualizado.

Siga um requisito pelo conjunto

Este cenário continua o serviço fictício de pedidos de equipamento. A primeira especificação permite aos gestores introduzir pedidos. A equipa acrescenta depois o autosserviço para os trabalhadores.

Essa alteração afeta mais do que um ecrã. Os trabalhadores precisam de uma identidade e de acesso aos seus próprios pedidos. A visibilidade dos gestores precisa de um limite definido. O fluxo de dados e a análise de segurança têm de refletir ambas as funções.

Use os passos Context, Conversation e Documents do Discovery para estabelecer e examinar essa intenção. Num produto importado, a análise do repositório substitui a conversa. Siga o fluxo de importação separado.

Conheça os documentos obrigatórios

Existem oito documentos obrigatórios, incluindo a especificação:

DocumentoPergunta a verificar neste cenário
EspecificaçãoQuem pode pedir equipamento e para que finalidade?
Fluxos de utilizaçãoComo é que um trabalhador submete e acompanha um pedido?
ArquiteturaOnde se aplica a decisão de acesso?
Decisões tecnológicasA conceção usa os serviços de identidade e de dados aprovados?
Fluxo de dadosQue componentes recebem os dados dos trabalhadores e dos pedidos?
AIPD (DPIA em inglês)A avaliação de privacidade reflete o tratamento real dos dados?
Modelo de ameaçasUm trabalhador pode ler o pedido de outro?
Registo de riscosQuem é responsável por cada risco por resolver e pelo seu tratamento?

A geração segue as dependências e a ordem de publicação. Reveja um documento inicial antes de aceitar os pressupostos que os documentos posteriores usam. Uma AIPD gerada é material de avaliação. A sua presença não demonstra, por si só, conformidade legal.

Look & Feel e Service Blueprint são opcionais. Use-os quando uma proposta visual da interface ou uma descrição do serviço ajudar a equipa a avaliar o produto.

Distinga publicação de revisão

A especificação começa como rascunho. A geração seguinte usa a versão publicada. A edição cria um novo rascunho. As alterações passam a ser usadas no trabalho seguinte quando publica a nova versão.

Os outros documentos incluem informação sobre publicação e revisão. Generate remaining pode gerar o conjunto em falta por ordem, sendo necessário rever cada resultado. A conclusão da geração não é uma conclusão humana de que os pressupostos estão corretos.

No serviço de equipamento, examine a regra de acesso em todos os documentos relevantes. Uma especificação correta e um fluxo de dados desatualizado não constituem uma conceção coerente.

Trate as alterações de forma deliberada

Quando volta a publicar a especificação, os documentos gerados que dela dependem podem ficar Outdated. A Taiga não os reescreve sem aviso. Uma alteração noutro documento de origem também pode afetar documentos posteriores na cadeia.

Volte a gerar os documentos afetados enquanto o Discovery está aberto. Generate remaining inclui documentos desatualizados. Examine os novos resultados, sobretudo os pressupostos que mudaram em vários documentos.

Os oito documentos obrigatórios têm de estar publicados para Finish Discovery ficar disponível. Um documento Outdated não impede a conclusão. Verifique a coerência por si, em vez de tratar o botão como evidência de que todas as revisões estão concluídas.

A conclusão bloqueia o conjunto e abre o fluxo seguinte do produto. Reabra o Discovery a partir de um documento quando precisar de alterar um conjunto bloqueado.

Entregue uma intenção coerente ao planeamento

Antes de planear, indique as funções atuais dos utilizadores, as restrições aceites e as decisões por resolver. Verifique que as propostas de iniciativas citam documentos que descrevem o mesmo produto.

Um resultado de revisão útil é concreto: «O autosserviço para os trabalhadores está refletido nos fluxos, na conceção da autorização, no fluxo de dados e no tratamento de ameaças.» Prossiga para as iniciativas para transformar essa intenção em trabalho.

Faça o exercício

O serviço fictício de equipamento passa de utilização exclusiva por gestores para autosserviço dos trabalhadores. Identifique os efeitos nos fluxos de utilização, na arquitetura, no fluxo de dados, na AIPD, no modelo de ameaças e no registo de riscos. Descreva os documentos que examinaria ou voltaria a gerar antes de concluir o Discovery.

Descarregar ficha (Markdown)
Verifique a sua compreensão ↑

Continuar a aprender

Fontes e leituras adicionais

← Lição anterior: Traga uma base de código existente para a Taiga