От «добавьте проверку баланса» к требованиям: разбираем одну задачу

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

Условный пример: сотрудник оформляет клиенту дополнительную платную опцию. Перед подтверждением работнику необходимо знать, хватает ли средств на подключение и какой вариант стоит выбрать.

На встрече задача звучит совсем коротко: «добавьте проверку баланса». Для какой цели? Что увидит сотрудник, если денег хватает только на один вариант? А если данные о балансе вообще не пришли?

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

Сначала рассматриваются границы примера.

В данном сценарии сотрудник выбирает один вариант опции за одно оформление. У каждого варианта есть разовая стоимость подключения. Считается, что остальные условия уже выполнены: опция совместима с тарифом, клиенту разрешено ее подключать, а у сотрудника есть право на оформление.

Дальше под доступностью нужно понимать именно достаточность средств. Полную проверку всех условий подключения в одну формулу сейчас прятать не нужно.

Такое допущение нужно записать сразу. Иначе один человек поймет «доступен» как «достаточно средств», а другой — как «проверка произведена, можно оформлять». А потом встретятся на приемке.

Разбор классификации:

В BABOK Guide выделяются бизнес‑требования; требования заинтересованных сторон; требования к решению и переходные требования.

Прим.: требования к решению включают функциональные и нефункциональные.

В книге Карла Вигерса и Джой Битти «Software Requirements» как раз разбираются уровни требований и связанные с ними сведения: бизнес‑правила, данные, внешние интерфейсы и ограничения.

Важный момент: ниже рассматриваются и виды требований, и информация, которая помогает их определить. Бизнес‑правило, описание данных и бизнес‑цель не становятся равноправными пунктами одной классификации только потому, что оказались в одной постановке.

Стоит держать рядом два вопроса: какую потребность описывать? Что нужно знать, чтобы правильно ее реализовать? А вот сводить все термины в один список не нужно.

Рисунок 1. Виды требований по BABOK и Вигерсу Рисунок 1. Виды требований по BABOK и Вигерсу

Бизнес‑требование: зачем менять процесс.

Сейчас сотрудник может выбрать вариант, на который клиенту не хватает средств. Узнает он об этом только после подтверждения: запрос уходит на оформление — возвращается отказ; приходится возвращаться к выбору и объяснять клиенту, что произошло.

Первое желание — записать цель так: «снизить долю попыток оформления, которые заканчиваются отказом из‑за недостатка средств».

Звучит, конечно, разумно. Но и тут существуют «подводные камни».

Если просто заблокировать кнопку, запросов на оформление станет меньше. Отказов в серверной статистике тоже. А денег у клиента от этого не прибавится. Поэтому сначала нужно понять, какую пользу нужно получить.

Для общего примера цель формулируется так:

«Сократить время сотрудника на обработку заведомо неуспешных оформлений за счет предварительного определения достаточности средств».

Это отвечает на вопрос «зачем», но пока не говорит разработчику, какой экран и метод создавать.

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

Здесь пригодится SMART. Только подставлять красивые проценты без данных категорически не рекомендуется. Если текущие значения никто не измерял, это отдельная задача, а не повод придумать число в документе.

Пользовательское требование: что нужно сделать человеку.

У сотрудника другая точка зрения. Ему нужно до подтверждения понять, какой вариант можно предложить клиенту, а по какому не хватает средств.

Отсюда появляется пользовательское требование:

«Сотрудник должен иметь возможность до подтверждения оформления узнать, на какие варианты клиенту хватает средств, и понять причину, если доступность определить не удалось или средств недостаточно.»

В терминологии BABOK это требование заинтересованной стороны. В терминологии Вигерса и Битти для сотрудника, работающего с системой, рассматривается пользовательское требование: что ему нужно выполнить с помощью решения.

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

У поддержки, кстати, будет своя потребность: отличить недостаток средств от ошибки проверки, когда сотрудник сообщает, что оформление не работает. Если об этой группе забыть, очень легко получить одно сообщение «недоступно» на совершенно разные ситуации. Это, конечно, удобно, но пока не нужно разбираться в этом.

Функциональные требования: что делает система?

С потребностью разобрались. Теперь можно переводить ее в наблюдаемое поведение системы.

Для взятого примера оно будет таким:

1. При открытии формы система получает перечень вариантов, их стоимость и доступный для списания остаток клиента;

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

3. Если средств недостаточно, система показывает причину и не позволяет отправить запрос на оформление этого варианта из формы;

4. Если необходимые данные не получены, система показывает, что проверку выполнить не удалось, и не разрешает оформление этого варианта из формы до успешной проверки;

5. При подтверждении система обеспечивает соблюдение правила достаточности средств с учетом возможных параллельных операций. Если оформить опцию не удалось, сотрудник получает понятный результат;

В четвертом пункте есть важная развилка: «не хватает средств» и вопрос «хватает ли средств» — разные состояния. В первом система получила данные и применила правило. Во втором она не смогла принять решение.

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

Рисунок 2. Недостаток средств и отсутствие данных требуют разных объяснений Рисунок 2. Недостаток средств и отсутствие данных требуют разных объяснений

С пятым пунктом тоже не все так просто.

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

Поэтому предварительная проверка помогает сотруднику выбрать вариант, а при оформлении система должна обеспечить соблюдение правила. Как именно — через резервирование, атомарную операцию в системе списания или другой механизм — зависит от архитектуры. Это нужно разобрать с командой. Одной заблокированной кнопки тут будет недостаточно.

Рисунок 3. Остаток может измениться между выбором варианта и подтверждением Рисунок 3. Остаток может измениться между выбором варианта и подтверждением

Бизнес‑правило: по какому условию принимается решение.

В упрощенном примере оно выглядит так:

«Подключение допускается, если доступный для списания остаток больше либо равен стоимости подключения выбранного варианта.»

Если остаток равен стоимости, средств достаточно. Если меньше — нет.

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

Бизнес‑правило существует независимо от конкретного экрана. Его нужно соблюдать и при оформлении из CRM, и при другом способе подключения. А функциональные требования описывают, как система обеспечивает его выполнение и сообщает результат пользователю.

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

Нефункциональные требования: при каких условиях решение пригодно.

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

Здесь появляются требования к качеству решения: производительности, доступности, безопасности и удобству работы.

«Система работает быстро» проверить трудно. Нужны операция, показатель, условия измерения и порог. Например:

«Не менее 95% проверок достаточности средств завершаются показом результата в форме не позднее двух секунд после начала проверки при 30 одновременно работающих сеансах.»

Числа используются вымышленные. В проекте их нужно согласовать по ожидаемой нагрузке, а для проверки определить окружение, профиль запросов и период измерения. Отдельно стоит задать допустимую долю ошибок: быстрый ответ «проверка не выполнена» сам по себе еще не делает решение пригодным.

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

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

Данные, интерфейсы и ограничения.

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

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

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

Ограничения — еще один отдельный разговор. Например, организация может потребовать использовать существующий источник остатков. Это сужает выбор реализации. Но само по себе не объясняет ни бизнес‑цель, ни задачу сотрудника.

Лучше записать источник ограничения и его владельца. Иначе фраза «у нас всегда так делали» очень быстро превращается в обязательное архитектурное решение. А почему обязательное — уже никто не помнит.

Переходные требования: что потребуется для запуска?

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

Переходное требование можно записать так:

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

Во взятом примере для этого подготавливается короткая инструкция и проводится ознакомление. Если есть незавершенные оформления старого формата, отдельно определяется, нужно ли их переносить или как‑то обрабатывать при переходе.

Временной необходимостью здесь является подготовка сотрудников к конкретному изменению. Сама инструкция вполне может остаться и после запуска: ее пригодится открыть новому сотруднику или человеку, который что‑то забыл. Это не делает подготовку к переходу постоянной функцией системы.

А вот возможность увидеть причину недоступности остается частью решения и после запуска. Ее уже описали в функциональных требованиях.

Запись в одну таблицу:

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

Что описываем

Пример из нашей задачи

Как проверить

Бизнес‑требование

Сократить время сотрудника на обработку заведомо неуспешных оформлений

Сравнить показатель до и после изменения по согласованной методике, с учетом целевого назначения и срока

Пользовательское требование сотрудника

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

Пройти сценарий выбора: сотрудник различает достаточность средств, их недостаток и ошибку проверки

Требование заинтересованной стороны — поддержки

Различать отказ по недостатку средств и техническую ошибку

По данным диагностики поддержка определяет причину конкретного случая

Функциональные требования

Проверять каждый вариант, показывать результат, блокировать оформление из формы при недостатке средств или ошибке проверки; обеспечивать правило при оформлении

Проверить варианты с разной стоимостью, ошибки источника и изменение остатка до подтверждения

Бизнес‑правило

Доступный остаток должен быть не меньше стоимости подключения

Проверить остаток больше стоимости, равный ей и меньший нее; проверить соблюдение правила при параллельных операциях

Нефункциональное требование

Не менее 95% проверок завершаются показом результата за две секунды при 30 одновременных сеансах; числа условные

Измерить время в согласованных условиях и отдельно проверить допустимую долю ошибок

Требования к данным

Доступный остаток и стоимость имеют согласованную валюту; ноль отличается от отсутствующего значения

Проверить корректные суммы, нулевое и отсутствующее значения, несогласованную валюту

Требования к внешним интерфейсам

Проверить контракты, ответы с ошибками и отсутствие ответа

Ограничение

Использовать утвержденный источник остатков

Проверить соответствие решения зафиксированному ограничению

Переходное требование

Подготовить сотрудников к новым результатам проверки до запуска

До запуска проверить, что подготовка проведена и сотрудники знают порядок действий

Как понять, что ничего не потеряли?

  1. Постановку проверить цепочкой вопросов. Есть ли связь между целью бизнеса и задачей сотрудника? Для каждого решения в интерфейсе понятно, какое правило за ним стоит? Определены ли данные, без которых правило нельзя применить? Есть ли проверка качества решения и подготовка к запуску?

  2. Пройтись по сценариям: средств больше стоимости; ровно столько же; меньше стоимости. Один вариант проходит проверку, другой нет. Источник не ответил. Стоимость отсутствует. Остаток изменился перед подтверждением. Параллельная операция пытается потратить те же средства.

  3. Отдельно посмотреть, что сотрудник видит в каждом случае. Ведь «не хватает средств», «проверка не выполнена» и «оформление не удалось» требуют разных объяснений и дальнейших действий. Если оставить на все одну ошибку, подробная классификация требований уже не очень поможет.

Вывод:

На входе была просьба добавить проверку баланса.

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

Смысл классификации именно в этом. Она помогает вовремя заметить пропуск: цель есть — измерить ее нечем; кнопка есть — правило не определено; положительный сценарий описан — отсутствие данных никто не обсудил.

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

А у тебя какие вопросы чаще всего скрываются за фразой «тут просто нужно проверить»?

Источники

1. IIBA. BABOK Guide, версия 3, раздел 2.3 «Requirements Classification Schema». Открытое изложение классификации — The Business Analysis Standard, раздел 4.4.2 «Requirement Classification».

2. Karl Wiegers, Joy Beatty. Software Requirements, 3 rd edition. Microsoft Press, 2013. Для этого разбора особенно полезны главы 1, 5, 8, 9, 13 и 14: уровни требований, бизнес‑ и пользовательские требования, бизнес‑правила, данные и качественные характеристики.

Источник: habr.com

0 0 голоса
Рейтинг новости
1
0
Подписаться
Уведомить о
0 комментариев