Какие вещи вы помещаете в документ анализа воздействия?

Таким образом, вы исправляете ошибки, а затем встречаете одну, которая может повлиять на другие модули программного продукта. Ваши данные недостаточны для подтверждения вашего утверждения о последствиях исправления, и вас попросили создать документ анализа воздействия.

1. Есть ли определенный процесс, как это сделать?
2. Какая ключевая информация нужна?
3. Существуют ли какие-либо известные форматы / шаблоны для этого документа?

Шаблоны, которые я видел для анализа воздействия, были созданы внутри компании, в которой я работаю. Мы используем его для оценки запросов на изменение и перед их обработкой (и, возможно, для отклонения некоторых). У этого были секции как это:

• Влияние на требования. В этом разделе Аналитик записывает, что необходимо изменить в сценариях использования, чтобы поддержать запрошенное изменение.
• Влияние на дизайн и архитектуру. В этом разделе архитектор и дизайнер упоминают, какие части модели необходимо изменить или переделать для поддержки изменения.
• Влияние на тестирование: QC пишет, что тестовые случаи должны быть обновлены.
• Оценка и влияние на график. Руководитель проекта оценивает необходимые усилия, стоимость изменений и влияние на график проекта.

Чтобы покрыть все возможные воздействия, вам нужно пройти через зависимости. Если у вас есть Матрица двунаправленного отслеживания, это будет проще.

Мы использовали вышеприведенный порядок, потому что дизайнеру нужно будет знать влияние с точки зрения аналитика, чтобы лучше понять изменения, а также тестеру нужно знать мнение аналитика и архитектора. Точно так же премьер-министру нужна вся информация, чтобы знать стоимость и график.

Мы использовали это с CRs, но вы можете использовать это с ошибками таким же образом. Кроме того, если вам нужно сделать это, чтобы выбрать одно из нескольких решений для устранения ошибки, вам нужно будет повторить анализ воздействия для каждого возможного решения и объединить все данные в одну форму анализа и решения (DAR), чтобы узнать, какое решение является лучший. В форме DAR вы должны добавить некоторые факторы оценки, такие как ремонтопригодность в будущем или другие факторы, которые неявным образом не включены в анализ воздействия. Затем присвойте каждому фактору вес и дайте каждому баллу решения по каждому фактору. Наконец, умножьте и суммируйте балл * вес и выберите лучший. Обратите внимание, что стоимость может быть включена в факторы, или PM может иметь другое мнение.

Я считаю, что в любой документации хороший подход - гибкий. Теперь есть некоторые заблуждения, что agile означает «нет документации или анализа вообще», но это не так. Вещи, которые я читал о agile, говорят: «используй то, что работает». Я полагаю, это означает, что документ должен быть длинным и детализированным, соразмерным задаче.

Шаблоны могут быть полезны в качестве контрольного списка, но я бы не потребовал заполнения каждого раздела для небольших изменений или изменений с низким уровнем риска. Для смены одной строки, возможно, вам вообще не нужен документ. Я никогда не использовал шаблон для документа анализа воздействия, но я регулярно работаю с бизнес-требованиями или техническими характеристиками. Шаблон может быть слишком ограничительным; хорошее руководство - рассмотреть, кто будет аудиторией. Если это менеджеры, которые не являются техническими, сфокусируйтесь на бизнес-обосновании изменений. Если это для технических людей, предоставьте небольшую справочную информацию, чтобы новый человек в команде не потерян и дал им достаточно, чтобы начать работу, если они должны поддержать изменения. Кроме того, если вы хотите что-то еще более легкое и без трения, не используйте документ вообще, поместите его в вики.

Информация для включения:

• Краткое описание проблемы
• Объясните или покажите пример того, как дефект вызывает сбой и / или неэффективность
• Включите оценку сложности
• Включите оценку стоимости и времени для исправления

Это достойный минимум. В другом посте рассказывалось о некоторых довольно тяжелых материалах CMMi от IBM; это замечательно, если у вас есть время и ресурсы для этого (и когда вы создаете системы для НАСА, где на карту поставлена ​​человеческая жизнь, тогда людям лучше относиться к этому серьезно), но для небольших команд вам, вероятно, не нужно быть таким тяжелым , Будьте осторожны с оценкой, как всегда. Менеджеры склонны полагать, что оценка является реальной.

Обратите внимание, что в гибком подходе есть опасности. Некоторые разработчики считают, что это означает, что «документы не нужны, просто начните взламывать» (что может быть хорошо в некоторых ситуациях). Кроме того, другие возьмут широту, данную задаче, и просто напишут действительно дурацкие документы, которые не очень помогают (в большинстве случаев не всегда хорошо). Частично проблема заключается в том, что написание письма требует определенных усилий, навыков и времени; большинство из нас не хватает по крайней мере двух из этих вещей;)

Я всегда хорошо разбирался в документации, потому что это доказывает, что вы хотя бы задумывались над тем, чтобы претендовать на план. Но в старости я также осознал, что слишком много документации само по себе может стать проблемой обслуживания, и что недостаточно людей заботятся о том, чтобы обновлять документацию.

Документ Impact Analysis действительно необходим в крупномасштабном проекте, особенно если программисты работают географически в разных местах.

Документ анализа воздействия должен быть утвержден ведущим, чтобы убедиться, что изменение не повлияет на другой компонент, который работает нормально в производстве.

Анализ воздействия необходим для того, чтобы убедиться, что требование полностью понято и все компоненты, подлежащие изменению, определены, чтобы избежать доработки.

Анализ воздействия также необходим для подотчетности заинтересованных сторон. В противном случае, когда проблема возникает после развертывания, разработчик становится козлом отпущения.

Анализ воздействия является основой для оценки. Без этого оценка не имеет никакой позиции. Он может быть слишком высоким или слишком низким. С Impact Analysis, если фактическое усилие превышает, это легко объяснить.

Здесь у вас есть нормализованный шаблон для отчета по анализу воздействия. Он настроен для конкретной отрасли, но, тем не менее, имеет полезные разделы, которые могут послужить вдохновением для написания собственного документа.

Ссылка: http://www.itu.int/en/itu-d/projects/documents/templateimpactanalysis.pdf

ура