Quais são as coisas que você coloca em um documento de análise de impacto?

9

Então, você está corrigindo erros e encontrou um que poderia afetar outros módulos do produto de software. Seus dados não são suficientes para apoiar sua reivindicação sobre os efeitos da correção e você foi solicitado a criar um documento de análise de impacto.

  1. Existe um processo definido sobre como fazer isso?
  2. Quais são as principais informações necessárias?
  3. Existem formatos / modelos conhecidos para este documento?
setzamora
fonte
11
Parece-me que alguém criou um termo chique para colocá-lo no local e fazer com que você corrija esse bug sem argumentos.
Aditya P
4
Esta pergunta e sua resposta me deixam feliz por não trabalhar nesse ambiente. "Matriz de rastreabilidade bidirecional"? "Formulários de análise e resolução de decisão"? Realmente? De quantas maneiras diferentes de não realizar o trabalho você precisa?
Rein Henrichs
2
@ Rein, é tudo trabalho. O trabalho não é apenas codificação. Além disso, não é de uma pessoa. Em pequenas organizações onde Análise, Design, Codificação e Estimação são feitas por uma pessoa, é realmente um inferno, mas com grandes equipes com especialização não é grande coisa.
M.Sameer 14/05
4
@AdityaGameProgrammer, @ Rein Henrichs: Eu não entendo seus comentários. Você sugere não fazer nenhum planejamento e gerenciamento? Obviamente, não há problema em começar a codificar diretamente se o projeto for realizado por uma pessoa e a alteração for fácil de implementar. Mas e os projetos em larga escala e as mudanças que podem ter um grande impacto nas diferentes partes de um projeto?
Arseni Mourzenko

Respostas:

5

Os modelos que vi na análise de impacto foram feitos dentro da empresa em que trabalho. Nós o usamos para avaliar as Solicitações de Mudança e antes de trabalhar nelas (e possivelmente para rejeitar algumas). Tinha seções como esta:

  • Impacto nos requisitos: nesta seção, o analista escreve o que precisa ser alterado nos casos de uso para dar suporte à alteração solicitada.
  • Impacto no design e na arquitetura: Nesta seção, o arquiteto e o designer mencionam quais partes do modelo precisam ser modificadas ou refeitas para dar suporte à mudança.
  • Impacto no teste: o CQ grava os casos de teste que precisam ser atualizados.
  • Estimativa e impacto no cronograma: o gerente do projeto estima o esforço necessário, o custo da mudança e o impacto no cronograma do projeto.

Para cobrir todos os possíveis impactos, você precisa percorrer as dependências. Se você possui uma Matriz de Rastreabilidade Bidirecional, será mais fácil.

Usamos a ordem acima porque o designer precisará conhecer o impacto do ponto de vista do analista para obter uma melhor compreensão da mudança, e o testador também precisa conhecer a opinião do analista e do arquiteto. Da mesma forma, o PM precisa de todas as informações para conhecer o custo e o cronograma.

Usamos isso com CRs, mas você pode usá-lo com erros da mesma maneira. Além disso, se você precisar fazer isso para escolher entre várias soluções de correção para solucionar o erro, será necessário repetir a análise de impacto para todas as soluções possíveis e consolidar todos os dados em um formulário de Análise e Resolução de Decisão (DAR) para saber qual solução é ao melhor. No formulário DAR, você deve adicionar alguns fatores de avaliação, como manutenção futura ou outros fatores que não estão incluídos implicitamente na análise de impacto. Em seguida, dê peso a cada fator e dê a pontuação de cada solução em cada fator. Finalmente multiplique e some a pontuação * peso e escolha o melhor. Observe que o custo pode ser incluído nos fatores ou o PM pode ter outra opinião.

M.Sameer
fonte
11
Isso parece ... burocrático. (Ou seja, parece que você está sendo governado por burros.) #
Donal Fellows
3
@Donal Fellows, Isso foi recomendado pelos consultores da CMMi e pelos consultores de melhoria de processos da IBM.
M.Sameer 14/05
3

Acredito com qualquer documentação que a abordagem ágil seja boa. Agora, existem alguns conceitos errados por aí que agile significa "sem documentação ou análise", mas esse não é o caso. As coisas que li sobre o ágil dizem: "use o que funciona". Entendo que isso significa que o documento deve ter comprimento e detalhes proporcionais à tarefa.

Os modelos podem ser úteis como uma lista de verificação, mas não exigiria que todas as seções fossem preenchidas para alterações pequenas ou de baixo risco. Para uma alteração de uma linha, talvez você não precise de um documento. Nunca usei um modelo para um documento de análise de impacto, mas lido regularmente com requisitos de negócios ou especificações técnicas. Um modelo pode ser muito restritivo; uma boa orientação é considerar quem será o público. Se for para gerentes que não são técnicos, concentre-se na justificativa comercial para a mudança. Se for para pessoas técnicas, forneça um pouco de experiência para que uma nova pessoa na equipe não se perca e dê a elas o suficiente para seguir em frente, se tiverem que apoiar a mudança. Além disso, se você quiser algo ainda mais leve e menos atrito, não use um documento, coloque-o em um wiki.

Informações a incluir:

  • Breve descrição do problema
  • Explique ou mostre exemplo de como o defeito está causando falha e / ou ineficiência
  • Incluir estimativa de complexidade
  • Incluir estimativa de custo e tempo para correção

Esse é um mínimo decente. O outro post destacou algumas coisas bastante pesadas sobre CMMi da IBM; isso é ótimo se você tiver tempo e recursos para isso (e quando estiver construindo sistemas para a NASA onde a vida humana está em risco, é melhor as pessoas levarem a sério), mas para equipes pequenas você provavelmente não precisará ser tão pesado . Tenha cuidado com a estimativa, como sempre. Os gerentes tendem a assumir que uma estimativa é a real.

Observe que existem perigos na abordagem ágil. Alguns desenvolvedores acham que isso significa "nenhum documento necessário, basta começar a piratear" (o que pode ser bom em algumas situações). Além disso, outros pegam a latitude dada à tarefa e simplesmente escrevem documentos realmente ruins que realmente não ajudam (não necessariamente OK na maioria das situações). Parte do problema é que escrever bem requer algum esforço, habilidade e tempo; a maioria de nós não tem pelo menos duas dessas coisas;)

Eu sempre fui grande em documentação, porque prova que você pelo menos pensa bastante para se qualificar como tendo um plano. Mas, na minha velhice, também percebi que muita documentação pode se tornar um problema de manutenção e que poucas pessoas se importam o suficiente para manter a documentação atualizada.

Bernard Dy
fonte
-1

O documento de análise de impacto é realmente necessário em projetos de larga escala, especialmente onde os programadores estão trabalhando geograficamente em diferentes locais.

O documento da Análise de impacto deve ser aprovado pelo líder para garantir que a alteração não afete o outro componente que está funcionando bem na produção.

A Análise de impacto é necessária para garantir que o requisito seja completamente compreendido e que todos os componentes a serem alterados sejam identificados para evitar retrabalho.

A Análise de Impacto também é necessária para a responsabilidade das partes interessadas do cliente. Caso contrário, quando ocorrer um problema após a implantação, o desenvolvedor se tornará o bode expiatório.

A análise de impacto é a base para a estimativa. Sem isso, a estimativa não tem suporte. Pode estar muito alto ou muito baixo. Com a Análise de impacto, se o esforço real exceder, é fácil explicar também.

Raghu
fonte
-2

Aqui você tem um modelo normalizado para um relatório de análise de impacto. Ele é personalizado para um ramo específico da indústria, mas possui seções úteis que podem servir de inspiração para escrever seu próprio documento.

O link: http://www.itu.int/en/itu-d/projects/documents/templateimpactanalysis.pdf

Felicidades

Nano
fonte
Leitura recomendada: Sua resposta está em outro castelo: quando uma resposta não é uma resposta? "deixe-me ser claro: este tipo de resposta é não uma resposta Se você ver isso, marcá-lo Moderadores, se você vê-lo sinalizado,.. excluí-lo "
mosquito
Na verdade eu discordo. Minha postagem É uma resposta, uma resposta especificamente para o item 3 da pergunta original "Existem modelos / formatos conhecidos para este documento?". Então, você tem um da placa da Telco. Talvez não seja especificamente adaptado ao desenvolvimento de software, mas há algumas seções interessantes nesse pdf que podem ser usadas como inspiração para criar seu próprio modelo de Análise de impacto. Antes de desencorajar as postagens analisadas por sua própria opinião tendenciosa, seria interessante saber o que o usuário original que postou a pergunta pensa da minha opinião. Felicidades.
Nano
bom ponto - concordam que este fato faz com que seja formalmente qualificar como uma resposta (ao fazer a parte da pergunta que aborda uma solicitação de recurso off-topic descaradamente )
mosquito