Инфостильные Use Case

Анка Аналитик

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

Обычно, если штат сотрудников невелик, то ТЗ нет вообще - люди и есть документация. А если компания крупная, то ТЗ есть и его много, но актуально от 10 до 40%.

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

Выявлять заинтересованные стороны, искать носителей знаний, разрабатывать те самые инфостильные шаблоны для записи. Эскалация конфликтов по теме "Напишите документацию - это ваша обязанность!" приведет только к напряжению в коммуникациях с коллегами, но цель не будет достигнута.

Существуют различные варианты записи требований, но здесь представлен вариант использования (в англ. Use Case). Не так важно, как в командах будут называть такого рода документацию "вариант использования", "Пользовательские сценарии", "Сценарии" или "Юзкейс", главное понимать суть зачем она нужна, какие функции выполняет и как ее писать качественно и понятно.

Use Case почти так же хорош, как диаграмма состояний, только не требуется рисовать, а ко всему в результате получаются готовые тест-кейсы:

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

Чтобы написать Use Case необходимо выполнить 4 шага

Я не придумала, как более удобно расположить описание шага рядом с примером, а не над/под ним. При приближении на мониторе компьютера или поворотом телефона будет всё отлично видно

Найти пользователя и цель, описать сценарий

Название, Легенда, Предусловие, Сценарий

Продумать альтернативы

Выделить параметры

Собрать всё вместе

Примеры

UC-02. Найти товар и сделать покупку

Легенда

П — пользователь
С — система

Сценарий использования

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

Альтернативные варианты

1а. П фильтрует список по несуществующей категории. Система выдает ошибку. Завершение сценария.

2а. Товаров не найдено. Вывод сообщения об ошибке. Завершение сценария.

2б. Товаров слишком много. Система выводит первые 100 и предлагает сузить поиск.

5а. П возвращается к покупкам. Переход к шагу 1.

Параметры

Категории товаров: платья, джинсы, кофты.

Время хранения товара в резерве: 2 часа с момента добавления в корзину.

UC-03. Авторизация пользователя

Легенда