Глоссарий · Конспекты по бизнес-анализу

Что это#

Руководство BABOK® описывает глоссарий как список ключевых бизнес-терминов с определениями. Его цель — добиться, чтобы заинтересованные стороны договорились о словаре конкретной предметной области. В Руководстве BABOK глоссарий поддерживает задачу «Спецификация и моделирование требований».

Не каждое слово туда попадает. Руководство BABOK предлагает включать термин, если:

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

Другие источники дополняют картину:

Вигерс и Битти выделяют термины в отдельную категорию бизнес-правил наряду с фактами, ограничениями и вычислениями и советуют хранить их там же, где определения данных, — обычно в словаре данных.
DAMA-DMBOK относит корпоративный бизнес-глоссарий к ключевым метаданным, которые создают и поддерживают распорядители данных (data stewards). Поэтому в масштабе предприятия глоссарию нужно системное управление (governance), а не просто документ.
Головач делает глоссарий шагом проектирования интерфейса: перечислите все термины, которые появляются на экране (кнопки, меню, окна, режимы), определите понятия системы, затем сократите термины, проверьте их на реальных пользователях и добейтесь, чтобы у одного понятия всегда было одно название.

Глоссарий отличается от модели понятий, которая показывает ещё и связи между терминами, и от словаря данных, который определяет элементы данных, их форматы и допустимые значения.

Когда применять#

Заводите глоссарий почти в каждой инициативе, с первого дня. Особенно он важен, когда:

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

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

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

Как это делать#

Начните рано: соберите термины из документов, записей интервью, экранов и отчётов. Отмечайте, кто и где употребил каждый термин.
Отберите кандидатов по четырём критериям включения, перечисленным выше.
Напишите определения: что это такое, чем отличается от похожего, плюс пример. Избегайте определений по кругу.
Запишите синонимы как отсылки к одному предпочтительному термину и отметьте похожие термины, которые легко спутать.
Разрешите разногласия с теми, кто отвечает за понятие. Если оба значения законны, дайте им два разных названия.
Опубликуйте глоссарий в одном месте, доступном всем, и ссылайтесь на него из документов с требованиями и из бэклога.
Пользуйтесь им. Сверяйте с ним требования, правила, тестовые сценарии и подписи на экранах.
Поддерживайте его: назначьте ответственного, ставьте дату у каждой записи и пересматривайте глоссарий, когда меняются процессы или продукты.

Пример#

«Мастерская» (вымышленная сеть веломастерских) создаёт онлайн-запись и уведомления о статусе. Интервью показывают, что слова «обслуживание», «заказ» и «бронь» разные люди понимают по-разному. Фрагмент глоссария:

Термин	Определение	Синонимы	Не путать с	Пример	Ответственный
Бронь	Резервирование времени в мастерской для конкретного велосипеда, сделанное до того, как велосипед привезли	запись	Заказ на ремонт	Онлайн-бронь на вторник, 10:00	Старший администратор
Заказ на ремонт	Карточка работ по велосипеду; создаётся, когда велосипед сдают в мастерскую	заказ, заявка	Бронь	Заказ на замену тормозов	Управляющий мастерской
Обслуживание	Пакет технического обслуживания по фиксированной цене (базовый, полный)	профилактика	Ремонт (работа, цена которой складывается из запчастей и времени)	Полное обслуживание	Владелец
Неявка	Бронь, по которой клиент не пришёл и не отменил её до начала забронированного времени	—	Отмена	—	Владелец
Готов к выдаче	Статус ремонта: все работы выполнены, проверены и оплачены или по ним выставлен счёт	готово	Ремонт завершён (работы выполнены, но ещё не проверены)	—	Управляющий мастерской

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

Частые ошибки#

Определяют каждое слово → включайте только термины, которые отвечают критериям включения.
Определения по кругу или расплывчатые («Бронь: действие по бронированию») → скажите, что это, чем отличается от похожего, и приведите пример.
Одно слово с двумя значениями так и осталось → разделите его на два термина.
Глоссарий, который никто не читает → ссылайтесь на него из требований и используйте на ревью.
На экранах другие слова → сверяйте подписи интерфейса с глоссарием, как советует Головач.
Нет ответственного → назначьте его и ставьте дату у каждой записи.

Шаблон#

Шаблон

| Термин | Определение | Синонимы | Не путать с | Пример | Источник | Ответственный | Последний пересмотр |
|---|---|---|---|---|---|---|---|
| | | | | | | | |

Источники и что почитать#

IIBA. A Guide to the Business Analysis Body of Knowledge (BABOK® Guide), version 3. International Institute of Business Analysis, 2015. Рус. изд.: Руководство к своду знаний по бизнес-анализу (Руководство BABOK®), версия 3.0. Техника 10.23 «Глоссарий».
Watermark Learning. BABOK v3 Study Tables. 2016 (учебное пособие к Руководству BABOK). Техника 10.23.
K. Wiegers, J. Beatty. Software Requirements, 3rd ed. Microsoft Press, 2013. Рус. изд.: К. Вигерс, Дж. Битти. Разработка требований к программному обеспечению, 3-е изд. М.: Русская редакция; СПб.: БХВ-Петербург, 2014. Гл. 9 (термины как категория бизнес-правил).
DAMA International. DAMA-DMBOK: Data Management Body of Knowledge, 2nd ed. Technics Publications, 2017. Рус. изд.: DAMA-DMBOK: Свод знаний по управлению данными, 2-е изд. М.: Олимп-Бизнес, 2020. Гл. 3 (распорядители данных и бизнес-глоссарий).
В. Головач. Дизайн пользовательского интерфейса, версия 1.2 (распространяется свободно). Ч. III «Процесс» (глоссарий интерфейса).