Trilha 07Lição 3 / 8

Revise Discovery como um conjunto conectado de documentos

Rastreie um requisito pela especificação, arquitetura, fluxo de dados e documentos de segurança. Trate revisões antes que o planejamento dependa de premissas desatualizadas.

Prática12 minRevisado

Publicado por Como escrevemos

Confira seu entendimentoVocê publica uma especificação revisada depois de gerar seus documentos dependentes. O que deve fazer?Faça o exercício
Você publica uma especificação revisada depois de gerar seus documentos dependentes. O que deve fazer?

O que você vai aprender

  • Explicar por que a ordem dos documentos e o estado de publicação importam.
  • Encontrar o impacto de uma especificação alterada nos documentos dependentes.
  • Diferenciar conteúdo gerado, publicado, revisado e desatualizado.

Acompanhe um requisito pelo conjunto

Este cenário continua o serviço fictício de solicitação de equipamentos. A primeira especificação permite que gerentes registrem solicitações. Depois, a equipe acrescenta autosserviço de funcionários.

Essa mudança afeta mais que uma tela. Funcionários precisam de identidade e de acesso às próprias solicitações. A visibilidade dos gerentes precisa de limites definidos. O fluxo de dados e a análise de segurança devem refletir os dois papéis.

Use as etapas Context, Conversation e Documents de Discovery para estabelecer e inspecionar essa intenção. Em um produto importado, a análise do repositório substitui a conversa; siga o fluxo separado de importação.

Conheça os documentos obrigatórios

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

DocumentoPergunta a verificar neste cenário
EspecificaçãoQuem pode solicitar equipamentos e para qual finalidade?
Fluxos de usuárioComo um funcionário envia e acompanha uma solicitação?
ArquiteturaOnde a decisão de acesso é imposta?
Decisões de tecnologiaO projeto usa os serviços aprovados de identidade e dados?
Fluxo de dadosQuais componentes recebem dados de funcionários e solicitações?
DPIAA avaliação de privacidade reflete o tratamento real?
Modelo de ameaçasUm funcionário pode ler a solicitação de outro?
Registro de riscosQuem é responsável por cada risco não resolvido e seu tratamento?

A geração segue dependências e ordem de publicação. Revise um documento inicial antes de aceitar as premissas usadas por documentos posteriores. Uma DPIA gerada é material de avaliação; sua presença, sozinha, não comprova conformidade legal.

Look & Feel e Service Blueprint são opcionais. Use-os quando uma proposta visual renderizada ou uma descrição de serviço ajudar a equipe a avaliar o produto.

Diferencie publicação de revisão

A especificação começa como rascunho. A geração posterior usa a versão publicada. Editar cria um novo rascunho; as alterações passam a valer nas etapas posteriores quando você publica a nova versão.

Outros documentos têm informações de publicação e revisão. Generate remaining pode gerar o conjunto ausente em sequência, e cada resultado precisa de revisão. A conclusão da geração não é uma conclusão humana de que as premissas estão corretas.

Para o serviço de equipamentos, inspecione a regra de acesso em todos os documentos relevantes. Uma especificação correta e um fluxo de dados desatualizado não formam um projeto consistente.

Trate alterações de forma consciente

Quando você republica a especificação, documentos gerados dependentes podem ficar Outdated. A Taiga não os reescreve silenciosamente. Uma mudança em outro documento de origem também pode afetar documentos mais adiante na cadeia.

Gere novamente os documentos afetados enquanto Discovery estiver aberto. Generate remaining inclui documentos desatualizados. Inspecione os novos resultados, especialmente premissas que mudaram em vários documentos.

Todos os oito documentos obrigatórios precisam estar publicados antes de Finish Discovery ficar disponível. Um documento Outdated não impede a conclusão. Verifique a consistência em vez de tratar o botão como evidência de que todas as revisões terminaram.

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

Entregue uma intenção coerente ao planejamento

Antes de planejar, informe os papéis atuais dos usuários, as restrições aceitas e as decisões não resolvidas. Verifique se as propostas de iniciativas citam documentos que descrevem o mesmo produto.

Um resultado útil de revisão é concreto: “O autosserviço de funcionários está refletido nos fluxos, no projeto de autorização, no fluxo de dados e no tratamento de ameaças.” Continue com iniciativas para transformar essa intenção em trabalho.

Faça o exercício

O serviço fictício de equipamentos muda de uso exclusivo por gerentes para autosserviço de funcionários. Identifique os efeitos sobre fluxos de usuário, arquitetura, fluxo de dados, DPIA, modelo de ameaças e registro de riscos. Descreva quais documentos inspecionaria ou geraria novamente antes de concluir Discovery.

Baixar planilha de exercício (Markdown)
Confira seu entendimento ↑

Continuar aprendendo

Fontes e leituras adicionais

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