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

9

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

  1. Есть ли определенный процесс, как это сделать?
  2. Какая ключевая информация нужна?
  3. Существуют ли какие-либо известные форматы / шаблоны для этого документа?
setzamora
источник
1
мне кажется, что кто-то придумал причудливый термин, чтобы поставить вас на место и заставить вас исправить эту ошибку без каких-либо аргументов.
Адитья П
4
Этот вопрос и его ответ делают меня счастливым, я не работаю в такой среде. "Двунаправленная матрица прослеживаемости"? «Анализ решений и формы разрешения»? В самом деле? Сколько разных способов не получить работу вам нужно?
Рейн Хенрикс
2
@ Рейн, это все работа. Работа это не только кодирование. Кроме того, это не один человек. В небольших организациях, где анализ, проектирование, кодирование, оценка выполняется одним человеком, это действительно ад, но для больших команд со специализацией это не имеет большого значения.
М.Самир
4
@AdityaGameProgrammer, @ Рейн Хенрикс: я не понимаю ваши комментарии. Вы предлагаете вообще не заниматься планированием и управлением? Конечно, можно начать кодирование напрямую, если проект выполняется одним человеком, и изменение легко осуществить. Но как насчет крупных проектов и изменений, которые могут оказать большое влияние на различные части проекта?
Арсений Мурзенко

Ответы:

5

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

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

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

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

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

M.Sameer
источник
1
Это звучит… бурно-круто. (То есть звучит так, как будто тебя управляют ослы.)
Донал Феллоуз
3
@Donal Fellows, это было рекомендовано консультантами CMMi и консультантами по улучшению процессов из IBM.
М.Самир
3

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

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

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

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

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

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

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

Бернард Ди
источник
-1

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

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

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

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

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

Рагу
источник
-2

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

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

ура

Nano
источник
Рекомендуемое чтение: Ваш ответ в другом замке: когда ответ не ответ? «Позвольте мне быть ясным: этот вид ответа не является ответом . Если вы видите это, пометьте его. Модераторы, если вы видите его помеченным, удалите его »
gnat
На самом деле я не согласен. Мой пост является ответом, ответом специально для пункта 3 оригинального вопроса «Существуют ли какие-либо известные форматы / шаблоны для этого документа?». Так что у вас есть один с доски Telco. Возможно, он не предназначен специально для разработки программного обеспечения, но в этом PDF-файле есть несколько интересных разделов, которые можно использовать для создания собственного шаблона Impact Analysis. Прежде чем вы не одобряете посты, проанализированные по вашему собственному предвзятому мнению, было бы интересно узнать, что первоначальный пользователь, опубликовавший вопрос, думает о моих комментариях. Приветствия.
Нано
Хороший вопрос - согласитесь, что это действительно делает его формально квалифицируемым как ответ (при этом часть вопроса затрагивает явно не по теме запрос ресурсов )
gnat