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

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?

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.

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.

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.

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