Сбор требований
После того как мы определили стейкхолдеров настало время сбора с них требований.
Представьте себе абсолютно любую программную систему. Такая система состоят из требований к ней и решений, которые основываются на этих требованиях.
Требования можно условно разложить на 4 категории:
- функциональные
- нефункциональные
- ограничения
- опасения/риски
Разберем каждый тип требования подробнее.
Функциональные требования
Функциональность – это способность системы выполнять работу, для которой она предназначена. Функциональные требования (FR) отвечают на вопрос "что". Что хочет видеть заказчик?
При проектировании гибкой архитектуры необходимо учитывать ключевой функционал системы.
- Ключевая функциональность обычно определяется как функциональность, которая имеет решающее значение для достижения бизнес-целей, которые мотивируют разработку системы.
- Другими критериями ключевой функциональности может быть то, что она предполагает высокий уровень технической сложности или требует взаимодействия многих архитектурных элементов.
Как правило, примерно 10 процентов ваших вариантов использования(use cases) или пользовательских историй(user stories), скорее всего, будут ключевыми.
Есть две важные причины, по которым при проектировании архитектуры необходимо учитывать ключевые функциональные возможности:
- Вам необходимо продумать, как функциональность будет распределяться по элементам (обычно модулям), чтобы обеспечить модифицируемость или возможность повторного использования, а также планировать рабочие задания. Неверные решения, принятые относительно распределения функциональности, приводят к накоплению технического долга. (Конечно, только в ретроспективе эти решения могут оказаться плохими.) Этот долг можно погасить с помощью рефакторинга, хотя это влияет на скорость выполнения проекта.
- Второй важной причиной фокусироваться на ключевых функциональностях это нефункциональные требования(NFR) системы. Некоторые NFR напрямую связаны с ключевыми функциями системы. О том как из FR получить NFR я расскажу подробнее в секции про NFR. Собранные требования должны быть переформулированы в формат use cases. Такая формулировка поможет нам при формировании NFR из FR.
Источники FR
Документация
Данный источник может быть использован при наличии в организации документации, которая может помочь в определении потребностей Заказчика. Примеры документации включают в себя: регламенты,
описания процессов, структура организации, спецификации продукта, различные процедуры, стандарты и инструкции, шаблоны документов и т.д.
Пример:
- При включении лампочки низкого уровня топлива, водитель должен иметь возможность найти список ближайших заправок, выбрать заправки только определенного бренда, просмотреть наличие на заправке нужного топлива, построить к ней маршрут.
User Story
User Story (пользовательская история) — короткая формулировка намерения пользователя и того, что продукт должен сделать для него.
Пример:
- Я как водитель, хочу на карте увидеть ближайшие ко мне заправки, чтобы вовремя заправиться.
- Я как водитель, хочу отфильтровать заправки определенного бренда, чтобы заправляться только на тех заправках которым я доверяю.
- Я как водитель, хочу посмотреть наличие на заправке нужного топлива, чтобы понапрасну не ехать.
- Я как водитель, хочу выбрать заправку и построить к ней маршрут, чтобы заправиться.
Use case
Use cases или варианты использования позволяют собрать и сформировать функциональные требования от лица участников. Диаграммы вариантов использования определяют границы решения и показывают связи с внешними системами и участниками.
Пример:
- Водитель (с включенной лампочкой низкого уровня топлива) может:
- посмотреть все ближайшие заправки на карте
- посмотреть все ближайшие заправки списком
- выбрать заправки нужного бренда
- посмотреть на выбранной заправке наличие нужного топлива
- построить до выбранной заправки маршрут
Методы сбора FR
Часто только источников для сбора недостаточно и требования приходится собирать непосредственно с стейкхолдеров. Для этой цели у архитектора есть несколько, известных мне, методов сбора.
Мозговой штурм
Мозговой штурм — наиболее часто используемый метод получения требований, которые связанны с новыми или плохо изученными направлениями деятельности организации заказчика или функциями системы.
Он позволяет собрать множество идей от различных стейкхолдеров в кратчайшие сроки и практически бесплатно.
Во время мозгового штурма участники «накидывают» любые идеи, касающиеся решения данной проблемы.
С помощью этой методики можно проработать несколько различных вариантов решения заданной проблемы, а так же разрешить конфликты требований.
Преимущества:
- Позволяет генерировать множество (в том числе и нестандартных) вариантов решений, а так же позволяет участникам развивать идеи друг друга.
Недостатки:
- Участники мозгового штурма должны быть мотивированы на идеи.
Event storming
Event storming — это увлекательный способ собрать вместе разработчиков и экспертов в бизнесе для быстрого, совместного исследования сложной предметной области. Часы вместо дней и недель.
Сессии Event storming'a позволяют бизнес и техническим экспертам совместно разобрать проблемную область.
Преимущества:
- Позволяет генерировать множество (в том числе и нестандартных) вариантов решений, а также позволяет участникам развивать идеи друг друга.
- В отличии от хаотичного мозгового штурма имеет четкую последовательность шагов, что приведет к целевой картинки бизнес процесса.
- Побочным явлением сбора требований будет секция дизайна, на которой участники выделят агрегаты/сабдомены согласованных вариантов использования.
Недостатки:
- Нужен опытный фасилитатор (~event-storming канал с опытными фасилитаторами).
- Не подходит для технических проектов.
- Плохо показал себя на простых проектах, там где Event storming добавляет излишнюю сложность.
Нефункциональные требования
Как мы обсуждали выше, любая программная система состоит из набора функциональных требований.
Но достаточно ли этого для успеха?
Давайте попробуем разобраться.
- Как правило способ структурирования системы не влияет на функциональность. Вы можете закодировать все функциональные возможности данной системы в одном огромном модуле или аккуратно распределить их по множеству меньших, очень связанных модулей. Внешне система будет выглядеть и работать одинаково, если учитывать только её функциональность. Однако важно то, что произойдет, когда вы захотите внести изменения в такую систему. В первом случае изменения будут трудными и дорогостоящими; в последнем случае их должно быть гораздо проще и дешевле внести.
- Способность системы переносить катастрофические сбои не влияет на её функциональность, но влияет на лояльность пользователей к системе.
- Способность системы реагировать на рост нагрузки не влияет на функциональность системы, но даёт нам возможность быстро масштабироваться при необходимости.
- Способность системы реагировать на хакерские атаки ничего не говорит о функциональности системы, но критически важна для компании как с точки зрения репутационных рисков так и с точки зрения закона.
Системы часто перепроектируются не потому, что они функционально несовершенны, а потому, что их трудно поддерживать, переносить, масштабировать, они слишком медленные или они были скомпрометированы. Перечисленное выше это только часть возможных требований. На самом деле их намного больше и обычно их называют нефункциональными требованиями (в противовес функциональным). Нефункциональные требования (NFR) - отвечают на вопрос "как". Как это должно работать? Как правило их принято объединять в кластеры по категориям, называемые атрибутами качества.
Например:
- требования касающиеся эволюционности/поддерживаемости/изменчивости можно отнести к кластеру Maintainability
- требования к безопасности можно объединить в кластер Security
- требования к надежности можно объединить в Reliability
- и т.д.
Ниже перечислю наиболее интересные для нас кластеры атрибутов качества:
- Эволюционность (Maintainability) - представляет собой степень эффективности и результативности, с которой продукт или система могут быть модифицированы для улучшения, исправления или адаптации к изменениям в окружающей среде и требованиях. Эта характеристика состоит из следующих подхарактеристик:
- Modularity — степень, в которой система или программа состоит из отдельных компонентов, при которой изменение одного компонента оказывает минимальное влияние на другие компоненты.
- Analysability — степень эффективности и результативности, с которой можно оценить влияние на продукт или систему предполагаемого изменения одной или нескольких его частей, диагностировать продукт на предмет недостатков или причин сбоев или идентифицировать части, которые необходимо модифицированный.
- Modifiability — степень, до которой продукт или система могут быть эффективно и результативно модифицированы без внесения дефектов или ухудшения качества существующего продукта.
- Надежность (Reliability) - это степень, в которой система, продукт или компонент выполняет определенные функции в определенных условиях в течение определенного периода времени. Эта характеристика состоит из следующих подхарактеристик:
- Faultlessness — степень, в которой система, продукт или компонент выполняет указанные функции без сбоев при нормальной работе.
- Availability — степень, в которой система, продукт или компонент работоспособны и доступны, когда это необходимо для использования.
- Fault tolerance — степень, в которой система, продукт или компонент работает должным образом, несмотря на наличие ошибок аппаратного или программного обеспечения.
- Recoverability — степень, до которой в случае сбоя продукт или система могут восстановить непосредственно затронутые данные и восстановить желаемое состояние системы.
- Масштабируемость (Scalability) - это способность системы справляться с увеличением нагрузки без снижения производительности или возможность быстрого увеличения нагрузки.
- Производительность (Performance) показывает реакцию системы на выполнение определенных действий в течение определенного периода времени. Есть два способа измерения производительности:
- Latency. Время, потраченное на реакцию на событие
- Throughput. Количество событий, происходящих в определенный момент времени
- Эластичность (Elasticity) — это способность системы автоматически регулировать уровень своих ресурсов в соответствии с рабочими нагрузками, с которыми она сталкивается в любой момент.
- Возможность развертывания (Deployability) - это cпособность системы к быстрому развертыванию
- Тестируемость (Testability) - это показатель, обратный трудозатратам на проведение тестирования и других видов проверки того, что внесенные изменения привели к нужным результатам.
- Защищенность (Security) - это степень, в которой продукт или система защищает от атак со стороны злоумышленника и защищает информацию и данные, чтобы люди или другие продукты или системы имели степень доступа к данным, соответствующую их типам и уровням авторизации. Эта характеристика состоит из следующих подхарактеристик:
- Confidentiality — степень, в которой продукт или система гарантирует доступность данных только для тех, у кого есть разрешение на доступ.
- Integrity — степень, в которой система, продукт или компонент гарантирует, что состояние ее системы и данных защищено от несанкционированного изменения или удаления в результате злонамеренного действия или компьютерной ошибки.
- Non-repudiation — степень, в которой можно доказать, что действия или события имели место, так что от этих событий или действий невозможно отказаться позже.
- Accountability — степень, в которой действия объекта могут быть однозначно прослежены до объекта.
- Authenticity — степень, в которой можно доказать, что идентичность объекта или ресурса соответствует заявленному.
- Resistance — степень, в которой продукт или система выдерживают работу при атаке злоумышленника.
- Простота разработки (Simplicity) - это то на сколько сложна или проста проектируемая система. Простота разработки это не сама цель а данность.
- Общая стоимость (Overall cost ) - это стоимость разработки и эксплуатации.
Это далеко не полный список атрибутов качества, но именно он нам позволит погрузится в увлекательный мир нефункциональных требований.
NFR должны быть максимально конкретными.
Примеры плохих требований:
- система должна быть простой в использовании
- система должна иметь высокую производительность
Примеры хороших требований:
- в течение пары минут пользователь должен найти и заказать интересующий его продукт
- система должна обрабатывать 10 000 сообщений в секунду
Отсюда и дальше по тексту, когда речь будет касаться NFR, я буду иметь ввиду сценарии атрибутов качества.
Для начала разберемся в терминологии, что такое атрибуты качества и их производные сценарии атрибутов качества.
Если кратко то:
- атрибуты качества - это измеримое или тестируемое свойство системы, которое используется, чтобы указать, насколько хорошо система удовлетворяет потребности заинтересованных сторон, помимо основной функции системы. Сами по себе атрибуты качества не являются нефункциональными требованиями, но их производные сценарии атрибутов качества уже будут полноценными NFR.
- сценарии атрибутов качества - это вариант формализации требования, связанного с соответствующим атрибутом качества.
Сценарии атрибутов качества состоят из шести честей:
- Источник
Стимул
- Артефакт
- Среда
- Ответ
- Мера отклика
Я прекрасно понимаю, что формулировать сценарии атрибутов качества может быть сложной задачей для новичка, поэтому в дополнительных материалах подготовлен таксономия по базовым сценариям атрибутов качества. Эти материалы будут хорошей отправной точкой для поиска нужных требований.
Не нужно переживать если какие-то из частей сценариев атрибутов качества будут пропущены. Главное чтобы всем стейкхолдерам было понятно о чем идет речь.
В архитектуре ПО сценарии атрибутов качества принято разделять на три типа:
- Use case scenario - отражают нормальное состояние или работу системы. Если система еще не построена, речь пойдет о первоначальном выпуске.
- Пользователь запрашивает финансовый отчет в момент пиковой нагрузки получает отчет в течение 5 секунд в 95% случаях.
Growth scenario - это ожидаемые изменения в системе. Это может быть о среде выполнения (например, удвоение трафика сообщений) или о среде разработки (например, изменение формата сообщения).
- Администратор добавляет новый сервер базы данных, чтобы уменьшить задержку с 5 секунд до 2,5 секунд в течение 1 человека в неделю.
Exploratory scenario - это экстремальные изменения в системе. Эти изменения не обязательно являются ожидаемыми или даже желательными ситуациями. Исследовательские сценарии используются для изучения границ архитектуры (например, трафик сообщений вырастает в 100 раз и приводит к замене программного обеспечения).
- Половина серверов выходит из строя во время нормальной работы, система продолжает работать, доступность не снижается.
Важно при формировании NFR корректировать требования заказчика в сторону реальных/достижимых показателей. Объясните, что время ответа в 20 мс сложно достижимо в вашей системе. Расскажите про стандарты индустрии и о вашем личном опыте. Попробуйте договориться с заказчиком на те значения, которых вы уверены. Сможете сделать лучше - отлично. За это вас точно не отругают 🙂
Некоторые архитектора используют метод MoSCoW для формирования ожиданий заказчика:
- Must Have
- Should Have
- Nice to Have
- Could Have
- Won't Have
Но на этапе дизайна вы все равно будете ориентироваться на показатель Must Have.
Источника NFR
Бизнес драйверы/Бизнес цели
Хорошей отправной точкой для поиска NFR могут быть бизнес драйверы и бизнес цели.
Driver: внешнее или внутреннее условие, побуждающее организацию определять свои цели.
Пример:
- изменение нормативных требований
- требований обеспечение безопастности
- внешнеполитические факторы
Goal: Требование высокого уровня о намерениях или направлении для организации. Обычно используется для измерения успеха организации. Цель всегда связана с драйвером.
Пример:
- увеличить прибыль
- сократить время ожидания в службе поддержки
- внедрить онлайн управление портфелем
- захватить 30% доли рынка
- запуститься раньше конкурентов
Objective: ограниченный по времени этап для организации, используемый для демонстрации прогресса в достижении цели.
Пример:
- Увеличить загрузку производственных мощностей на 30 % к концу 2020 года, чтобы поддержать запланированное увеличение доли рынка.
Цель проектирования
Вам необходимо четко понимать цель проектирования, которую мы хотите достичь. Когда и почему мы занимаетесь этим архитектурным проектом? Какие бизнес-цели в данный момент больше всего беспокоят организацию?
Примеры:
- Вашей задачей может быть предварительная архитектура (Initial Agile Architecture). В рамках которой нам нужно определиться с основными архитектурными концепциями и распределением обязанностей.
- Архитектура может перерабатываться в рамках плановых работ с техническим долгом (основной сценарий для гибкой архитектуры).
- Неконтролируемый рост технического долга приводит к глубокому рефакторингу, при котором нужно сохранить функциональность системы, но изменить её качественные характеристики.
- Возможно, вы занимаетесь проектированием в рамках процесса создания прототипа. В этом случае целью процесса проектирования архитектуры является не столько создание готовой к выпуску или многократному использованию системы, сколько исследование предметной области, изучение новой технологии, получения быстрой обратной связи от клиента или для изучения некоторых качественных характеристик (например, масштабируемости, отказоустойчивости, эволюционности).
Любая их перечисленных целей будет влиять на процесс принятия архитектурных решений. Архитектуры существуют для того, чтобы помочь в достижении бизнес-целей. Архитектор должен четко представлять себе эти цели, сообщать о них (и обсуждать их!) и устанавливать четкую цель проектирования до начала процесса проектирования.
SLA
Третьим, но не по значимости, хорошим местом для поиска NFR может служить соглашение об уровне обслуживания.
Пример:
- Максимальное время простоя системы в случае критического сбоя 60 минут.
- В случае выхода из строя хранилища данных, система может потерять данных не больше, чем за 24 часа
- Система должна быть доступна 99.5% времени
Функциональные требования
FR очень хорошо конвертируются в сценарии атрибутов качества.
Пример:
- FR: Водитель может посмотреть все ближайшие заправки на карте.
- NFR: Водитель посматривает все ближайшие заправки на карте, при нормальной работе системы, не позднее чем за 1 секунду в 99% случаях.
Методы сбора NFR
Как и для FR одних только источников недостаточно и часто архитектору приходится применять различные методы сбора NFR.
Анкетирование
Данный способ подразумевает под собой составление опросника (анкеты, брифа), который может содержать открытые (требуют от опрашиваемого сформулировать его ответ) и закрытые (требуют от опрашиваемого выбрать ответ из предложенных вариантов) вопросы.
Анкетирование используется для того, чтобы подтвердить или детализировать ранее известные требования, выбрать параметры для решений.
Преимущества:
- Высокая скорость получения результатов.
- Сравнительно небольшие материальные затраты.
Недостатки:
- Данный метод не подходит для выявления неявных требований.
- При составлении опросника физически невозможно учесть все необходимые вопросы.
- Не подходит для не технических стейкхолдеров
Интервью
Этот метод известен многим, своего рода беседа “по душам” с стейкхолдером, тет-а-тет.
Необходимо задавать открытые вопросы для получения информации и закрытые для того, чтобы подтвердить или опровергнуть конкретные варианты требований.
Данный способ применяется, в основном, для получения информации по какой-либо конкретной теме и/или для уточнения требований.
Преимущества:
- Возможность задавать вопросы в произвольной последовательности.
- Возможность использовать вспомогательный материал.
- Анализ невербальной реакции опрашиваемого человека, позволит сделать дополнительный вывод о достоверности его ответов.
Недостатки:
- Интервью отнимает достаточно много времени и сил.
- Дополнительной сложностью является получение одинаковых ответов от интервьюируемых.
Различные воркшопы
Например: ATAM, QAW, mini QAW. Для примера разберем Quality Attribute Workshop.
Семинары по атрибутам качества (QAW) предоставляют метод для определения критически важных для архитектуры атрибутов качества системы, таких как доступность, производительность, безопасность, функциональная совместимость и модифицируемость, которые вытекают из миссии или бизнес-целей.
Он позволяет собрать множество идей от различных стейкхолдеров в "кратчайшие сроки" и "практически бесплатно".
QAW состоит из 7 шагов:
Приветствие и знакомство (15 мин.)
Обзор семинара по атрибутам качества (15 мин.)
Бизнес драйверы (30 мин.)
- Системная архитектура (30 мин.)
Генерация сценария и расстановка приоритетов (2 часа)
Уточнение сценариев (2 часа)
- Подведение итогов и просмотр сценариев (1 час)
Преимущества:
- Позволяет генерировать множество (в том числе и нестандартных) вариантов решений, а также позволяет участникам развивать идеи друг друга.
- Позволяет приоритизировать сценарии атрибутов качества.
Недостатки:
- Участники мозгового штурма должны быть мотивированы на идеи.
- Трудно собрать всех вместе.
- Необходим опытный фасилитатор QAW.
Справедливости ради есть упрощенный семинар mini-QAW, но даже с ним не так то просто справиться.
Вот ссылка на мой неудачный опыт.
Ограничения
Помимо функциональных и нефункциональных требований, существуют требования, которые жёстко ограничивают возможные решения. Они называются ограничениями и могут быть связаны с технологическими, организационными или внешними факторами.
📌 Важно:
- Ограничения задают рамки, в которых архитектор должен работать. Это жёсткие условия, которые нельзя изменить без серьёзных последствий. Примеры ограничений:
- Разработать систему за 3 месяца (временное ограничение).
- Использовать только PostgreSQL для хранения данных (технологическое ограничение).
- Соблюдать требования законодательства, такие как PCI DSS или ФЗ 152 (регуляторное ограничение).
- Использовать существующую инфраструктуру компании (организационное ограничение).
Опасения/риски
Чаше всего риски выявляются на этапе дизайна. Риск удовлетворения какого-то требования может быть связан с ограничением стека технологий, уровня зрелости команды, неизвестностью будущего и тд.
Примеры:
- Объем и модель данных говорит нам о целесообразности использования NoSQL решения, но интересующая нас база не предоставляется, как сервис в компании.
- Реализация self contained services будет идеальным решением для удовлетворения требований к доступности и скорости разработки, но команда не работала ранее с этим паттерном.
Читать дальше Приоритизация требований/выделение архитектурных кандидатов







