04. ЧМВ. CRS-01. Требования и Use Cases

1.

CRS
Customer Requirements Specification
Спецификация требований заказчика
Функциональные требования и Use Cases
Курс «Человеко-машинное взаимодействие»
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC

2. 2. Вопросы

1.
2.
3.
4.
5.
Вопросы по лекции?
Вопросы по предыдущему семинару?
Что такое КПП?
Для чего нужен КПП?
Методика составления КПП?
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC

3. 3. Состояние нашего проекта

Мы провели предпроектные исследования Продукта - разработали артефакты Vision, Анализ
рынка и Календарный план. Теперь верхнеуровнево представляем – что хотим и как
стратегически двигаться для реализации Продукта
Пришла пора детального проектирования!
До кодирования необходимо подготовить 4 артефакта:
1.
CRS - Customer Requirements Specification - ЧТО делать?
2.
ADS - Architectural Design Specification - КАК всё устроено?
3.
DDS - Detailed Design Specification - КАК ИМЕННО реализовать модуль?
4.
Test Plan – КАК проверять CRS, ADS, DDS?
Создаем итерационно, дополняя артефакты по мере создания
Agile-манифест https://agilemanifesto.org/iso/ru/manifesto.html
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC

4. 4. CRS / Customer Requirements Specification

Спецификация требований заказчика
Вопрос: ЧТО должна делать система с точки зрения пользователя или бизнеса?
Цель: Описание функциональности системы на языке заказчика и пользователей. Сбор и
фиксация всех потребностей.
Роль: Это документ, написанный на языке заказчика или бизнес-аналитика. Он описывает
функциональность, которую ожидают от системы, без углубления в технические детали
реализации.
Целевая аудитория: Заказчик, менеджер проекта, бизнес-аналитики, тестировщики (для
создания приемочных тестов)
Методы реализации: Интервью, Use Cases, User Stories, сценарии, выявление требований
Ключевая черта: CRS фокусируется на проблемной области и ценности для пользователя.
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC

5. 5. ADS / Architectural Design Specification

Спецификация архитектурного проектирования / System Design
Вопрос: КАК система будет удовлетворять требованиям CRS?
Цель: Фокусируется на решении архитектурно-значимых требований (производительность,
безопасность, масштабируемость и т.п.)
Роль: Это "чертеж" или "план" всей системы. Он описывает основные компоненты, их
взаимодействие и ключевые технологические решения, планы развертывания. Учитывает
стратегии по безопасности, надежности, масштабируемости. Это мост между требованиями
CRS и детальным проектированием DDS
Целевая аудитория: Архитекторы, ведущие разработчики
Методы реализации: C4, Archimate, UML
Ключевая черта: ADS фокусируется на высокоуровневой структуре системы и
принципиальных технических решениях
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC

6. 6. DDS / Detailed Design Specification

Спецификация детального проектирования (или SRS)
Вопрос: КАК ИМЕННО каждый компонент системы будет реализован?
Цель: Предоставить разработчикам исчерпывающие инструкции для написания кода
Роль: Это инструкция для разработчика. Документ описывает внутреннюю структуру
отдельных модулей или компонентов, определенных в ADS, вплоть до уровня классов,
функций, алгоритмов и структур данных.
Целевая аудитория: Разработчики
Методы реализации: UML (классов, последовательности, состояний), ERD, псевдокод
Ключевая черта: DDS фокусируется на внутренней реализации отдельных частей системы
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC

7. 7. Test Plan / Тест план

Вопрос: КАК, КОГДА и ЧТО ИМЕННО мы будем проверять, чтобы убедиться, что
система соответствует всем требованиям и корректно реализована?
Тест План не является строго последовательным звеном, а скорее
параллельным и сквозным процессом, который начинает формироваться на
основе CRS и уточняется по мере появления ADS и DDS.
Тест План — это документ-интегратор. Он берет информацию из всех
документов проектирования и трансформирует ее в конкретный план действий
по верификации и валидации системы. Без CRS нет цели для тестирования, без
ADS нет понимания, как тестировать взаимодействие, а без DDS невозможно
создать эффективные модульные тесты.
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC

8. 8. Итеративность

Ни один артефакт не создается
один раз и навсегда. Они
разрабатываются и уточняются
итеративно. Например, в
ранней итерации у вас будет
эскиз ADS (набросок
архитектуры), а детальный DDS
будет создаваться только для
тех компонентов, которые
реализуются в текущей
итерации.
Тест-планы будут создаваться
по мере создания CRS, ADS, DDS
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC

9. 9. Сравнение артефактов

CRS
ADS
DDS
Основной вопрос
ЧТО делать?
КАК в целом устроена
система?
КАК ИМЕННО
реализовать модуль?
Основа содержания
Требования
пользователя и бизнеса
Схемы компонентов,
связи, технологии
Классы, алгоритмы,
API, БД
Целевая аудитория
Заказчик, бизнесаналитик
Техзадание на
дом (количество комнат,
этажей)
Архитектор, техлид
Разработчик
Аналогия
Архитектурный
Чертежи и схемы для
проект (план фундамента, электрика и
стен, коммуникаций)
сантехника
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC

10. 10. Создаем CRS

Ближайшие два семинара – разбираем и готовим CRS
1. Сегодня:
ФТ и Use Cases + НФТ
2. Следующий семинар:
Дизайн ПИ в Фигме и описание ПИ + оставшиеся требования
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC

11. 11. Структура CRS

1. Назначение документа. Что за документ, что здесь описывается
2. Введение и бизнес-проблема. До 500 символов краткий рассказ о Системе
3. Роли пользователей (таблица)
4. Термины и определения, аббревиатуры, сокращения
5. Функциональные требования (минимум 3 страницы). Требования и Use Cases
6. Нефункциональные требования (максимум 1 страница). Производительность, совместимость,
масштабируемость
7. Требования к пользовательскому интерфейсу. Экранные формы, Фигма, описание элементов и
действий (поведения)
8. Требования к программному интерфейсу. Сиквенсы (UML Sequence), описание API (OpenAPI)
9. Требования к документации. Руководство пользователя. Инструкции к деплою. Презентация
10. Ссылки на артефакты проекта. Перечислить имеющиеся (Vision, Proposal, КПП)
Зеленым выделено что надо сделать сегодня и в ДЗ
Голубым к следующему уроку
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC

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

1. Все требования должны быть пронумерованы
2. Несколько общих требований. «Система должна …»
3. Структурировать требования иерархично по роли пользователя / сущность (UML класс) / функция (метод
UML класса) в виде "… должна...".
4. Для помощи можно начать оформление с User Stories ("Как <Роль>, я хочу <Функция>, чтобы
<Ценность>"). Когда их будет много – произвести структурирование.
5. На каждого пользователя и группу функциональности оформить UML диаграмму Use Cases (сценарии
использования). Не более 7 действий на 1 диаграмму. Не менее 1 диаграммы на 1 роль пользователя.
6. Зависимости между требованиями. Например, запустить функцию обновления расписания занятий
можно только после обновления студентов.
7. Создать таблицы с полями сущностей (свойств UML классов) с колонками: №, Наименование, Тип,
Обязательность, Пример значения.
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC

13. 13. CRS. Use Cases (UC)

1. Диаграмма в нотации UML Use Case (UC)
2. Расшифровка к каждому действию на UC по формату
1. Заголовок (с нумерацией), например «1.1. Регистрация пользователя»
2. Краткое описание UC (1-2 стоки)
3. Основная последовательность действий
1.
2.
3.
4.
Пользователь открывает страницу такую то. Видит …
Пользователь нажимает на кнопку такую то.
Система делает то-то
Пользователь получает результат …
4. Альтернативная последовательность действий
1. Система выводит сообщение об ошибке с текстом сообщения для пользователя
2. Пользователь повторно вводит свои данные
5. Предусловие (когда можно использовать эту функцию)
1. Пользователь зашел на страницу
2. Пользователь авторизован и зашел на страницу реестра
6. Постусловие (что происходит, когда вы использовали эту функцию)
1. Пользователь нашел печеньку в меню
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC

14. 14. Use Case. Теория 1

UC – диаграмма поведения из семейства UML,
которая описывает функционал доступный
пользователю, что может делать система.
Ивар Якобсон впервые ввел понятие «вариант
использования» (Use Case) как набора действий.
UC:
• Описывает типичное взаимодействие между
пользователем и системой
• Показывает какие действия может совершить
пользователь
• Не показывает «как» достигается некоторый
результат, а только «что» именно выполняется.
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC

15. 15. Use Case. Теория 2. Актёры

Актером (действующее лицо)
называется любой объект,
субъект или система,
взаимодействующая с
моделируемой системой
извне.
Актеры – внешние пользователи по отношению к Системе
Актеры – это заинтересованные лица (stakeholders)
Три основных типа актеров:
1. Пользователи системы
2. Другие системы, взаимодействующие с данной
3. Время. Становится действующим лицом, если от него
зависит запуск каких-либо событий в системе.
Это может быть человек,
техническое устройство,
программа или любая другая
система, которая служит
источником воздействия на
моделируемую систему.
Может выделяться основное действующее лицо, основной Актёр
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC

16. 16. Use Case. Теория 3. Вариант использования

Вариант использования, use case – это действие,
выполняемое Субъектом, которое даёт результат Актеру.
На диаграмме прецедент изображается в виде эллипса.
ВАЖНО!
1. Каждый UC должен быть независимым. Если он всегда выполняется совместно с другим UC, то, скорее
всего, это один UC, а не два.
2. UC описывает, что делает Система, но никак не уточняет, как она это делает.
3. UC не отображает последовательность, в которой будут выполняться UC. Это визуализируется на
диаграммах деятельности и последовательности
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC

17. 17. Use Case. Теория 4. Требования

1. Варианты использования связаны с
требованиями к функциональности системы.
Список всех UC фактически определяет
функциональные требования (ФТ) к ИС.
2. UC отражают требования к системе с точки
зрения пользователя. Таким образом, варианты
использования – это функции, выполняемые
системой, а действующие лица, актёры – это
заинтересованные лица (stakeholders) по
отношению к создаваемой системе.
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC

18. 18. Контрольные вопросы

1.
CRS
1.
2.
3.
2.
ADS
1.
2.
3.
3.
Что такое DDS?
Какие методологии, нотации используются для создания DDS?
Для кого нужен DDS?
Test Plan
1.
2.
5.
Что такое ADS?
Какие методологии, нотации используются для создания ADS?
Для кого нужен ADS?
DDS
1.
2.
3.
4.
Что такое CRS?
Какие методологии, нотации используются для создания CRS?
Для кого нужен CRS?
Что такое Test Plan ?
Какое бывает тестирование?
Use Case
1.
2.
3.
Зачем нужен Use Cases?
В чем смысл варианта использования (Use Case)?
В чем разница Use Cases и User Stories
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC

19. 19. Задача на семинаре и ДЗ

На семинаре:
Начать составлять CRS (ФТ, Use Cases, НФТ)
по пунктам 5 и 6 слайда 11
и требованиям слайдов 12 и 13
1 UC и 5 действий + 7 ФТ + 3 НФТ
Домашнее задание:
Доделать дома CRS
Минимум 3 UC и требования с слайдов 11,12,13
ЧМВ или Проектирование Пользовательского Интерфейса - Тимофеев Дмитрий Александрович - 04. CRS-01. FR + UC