Андрей Шапиро, Byndyusoft К фиксации договоренностей Подходы по обслуживанию проектной документации

Части проектной документации

Что входит в проектную документацию — карты целевых гипотез: Impact Map, дерево продуктовых гипотез, … — карты процессов: CJM, BPMN, Event Storming, … — карта пользовательских историй: USM — карты структур потоков данных — архитектура программных модулей — структурные схемы объектов и их связей (ER-диаграммы) — схемы переходов состояний (state diagrams) — контракты: API, DTO, … — макеты интерфейса — сценарии — детальное описание потока внимания через интерфейс

Impact Mapping, 
 дерево гипотез

CJM, Event Storming, BPMN

User Story Mapping — уровень пользовательских историй

Карты структур потоков данных

ER-диаграммы (Entities relationship)

Структурная cхема сущностей Заказ — запрос клиента Доставка — одно или несколько отправлений объединённые для передачи клиентов. Может содержать несколько отправлений от разных мерчантов одному клиенту Отправление Отправление — экземпляры одного заказа объединённые по мерчанту Экземпляр — единица продажи Место Экземпляр Место — экземпляры одного отправления, упакованные в одну тару (коробку) Экземпляр Экземпляр Экземпляр Место Место

Что входит в проектную документацию — карты целевых гипотез: Impact Map, дерево продуктовых гипотез, … — карты процессов: CJM, BPMN, Event Storming, … — карта пользовательских историй: USM — карты структур потоков данных — архитектура программных модулей — структурные схемы объектов и их связей (ER-диаграммы) — схемы переходов состояний (state diagrams) — контракты: API, DTO, … — макеты интерфейса — сценарии — детальное описание потока внимания через интерфейс

Проблемная ситуация

1) знания распределены по головам 㱺 недоступны, в пределе теряются; 2) отсутствие ‘boundary objects’ — упрощенные информационных объектов, собирающих разные рабочие группы, на общем видении

3) знания разрознены, что мешает прилаживать новые части к имеющейся системе

Основные потери — Время на синхронную передачу знаний — Знания о структуре принятия решений — Знание о том кто знает (будущее)

Общее в предлагаемых методах

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

1. Журнал проектирования

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

Примеры журналов проектирования

Движение знания через журнал проектирования

2. Детальные сценарии

Формат сценариев Шаблон структуры — Агент истории — Контекст (вход) — Истории и ценность (выход) — Бизнес-метрика — Суть / Сценарии — Уточнения — Макеты

Формат сценариев Критерии готовности — Без проектирующего определимы — агент истории: действующее лицо, роль или персона; — контекст: где и в каком случае происходят изменения; — суть: что изменяется или создаётся; — ценность: для чего всё это; — концепции: все допущения, мысленные артефакты и названия, использованные в решении. — Содержит ссылки на макеты — Описан поток движения внимания агента через интерфейс в виде сценариев в формате «Мама моет раму» (субъект действие объект). — Описаны важные концепции, необходимые для понимания решения; — (Опционально) Дан прототип или последовательность изменяющихся состояний.

Пример детального сценария изолированной истории

Детальные сценарии потоком движения внимания пользователя

Детальные сценарии. Опускание нового в структуру. 
 Вставки Notion для вставки со связыванием

3. Дерево гипотез

Статья о дереве продуктовых гипотез

Принципы построения дерева — Дерево гипотез составляется как иерархированная программа, исполняя которую бизнес максимизирует выгоду — В корень дерева кладутся главные подсистемы бизнеса и потоки ценности в них, увязав их в словесную формулировку задачи оптимизации — На уровень лепестков в дерево погружаются проблемы (в виде их отрицания) или идеи по расширению каналов — Каждые два соседних элемента в иерархии являются частями гипотезы. Гипотеза собирается так: если <потомок>, то <родитель>

[Посетители] [Продавцы] [работает]

В сухом остатке

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

Инструменты — Связывание знаний в структуры — Присоединение всех групп (операций, аналитиков, проектировщиков, разработчиков) к одному стягивающему объекту знаний (USM / CJM/…)

[email protected] Спасибо за внимание!