Нарисовать контекстную диаграмму системы — что внутри, кто и что снаружи, какие данные и каким способом идут по каждой стрелке — и составить по ней реестр интеграций.
Где кончается наша система
Где кончается наша система
Контекстная диаграмма показывает систему одним блоком в центре, а вокруг — внешних участников: людей и системы. Стрелки — потоки данных с подписью «что передаём». Внутренних модулей и таблиц на ней нет. Корни у неё — диаграмма контекста структурного анализа и уровень System Context модели C4.
Правило границы: внешний — тот, чьим кодом и графиком релизов мы не управляем и с кем договариваемся о контракте. Поэтому сервис курьеров, который ведёт другая команда «Ромашки», для сервиса заказов внешний.
Направление стрелки — направление данных. Если провайдер сам присылает результат оплаты на наш адрес (webhook), стрелка идёт от провайдера к сервису заказов. Webhook — такой же синхронный HTTP-вызов, как REST-запрос, только начинает его внешняя система, поэтому на схеме он сплошной; пунктир — события через брокер.
Каждая стрелка становится строкой реестра интеграций: откуда → куда, что передаём, каким способом, кто инициатор, частота или объём. Реестр — часть спецификации системы вместе с границами, системными требованиями, НФТ и моделью данных.
Способы интеграции (подробно — в юните 4):
• синхронный запрос — ждём ответ;
• событие через брокер — сообщили и пошли дальше;
• webhook — внешняя система сама вызывает наш адрес HTTP-запросом;
• пакетная выгрузка — файл по расписанию.
Международная рамка спецификаций — ISO/IEC/IEEE 29148, она заменила IEEE 830 из BA-курса. В российских госпроектах ТЗ на автоматизированную систему оформляют по ГОСТ 34.602-2020.
Как составить контекстную диаграмму
- 1Граница
Назвать систему и её границу
- 2Участники
Перечислить людей и внешние системы, которые обмениваются с ней данными
- 3Стрелки
Провести стрелки по направлению данных
- 4Подписи
Подписать, что передаётся и каким способом
- 5Реестр
Перенести каждую стрелку в реестр интеграций
Реестр интеграций (фрагмент)
| Откуда → куда | Что | Способ | Инициатор |
|---|---|---|---|
| Приложение → сервис заказов | заказ, отмена | синхронный REST | клиент |
| Сервис заказов → провайдер | платёж, возврат | синхронный REST | сервис заказов |
| Провайдер → сервис заказов | результат оплаты | webhook | провайдер |
| Сервис заказов → уведомления | смена статуса | событие через брокер | сервис заказов |
Конспект урока
Где кончается наша система
Контекстная диаграмма показывает систему одним блоком в центре, а вокруг — внешних участников: людей и системы. Стрелки — потоки данных с подписью «что передаём». Внутренних модулей и таблиц на ней нет. Корни у неё — диаграмма контекста структурного анализа и уровень System Context модели C4.
Правило границы: внешний — тот, чьим кодом и графиком релизов мы не управляем и с кем договариваемся о контракте. Поэтому сервис курьеров, который ведёт другая команда «Ромашки», для сервиса заказов внешний.
Направление стрелки — направление данных. Если провайдер сам присылает результат оплаты на наш адрес (webhook), стрелка идёт от провайдера к сервису заказов. Webhook — такой же синхронный HTTP-вызов, как REST-запрос, только начинает его внешняя система, поэтому на схеме он сплошной; пунктир — события через брокер.
Каждая стрелка становится строкой реестра интеграций: откуда → куда, что передаём, каким способом, кто инициатор, частота или объём. Реестр — часть спецификации системы вместе с границами, системными требованиями, НФТ и моделью данных.
Способы интеграции (подробно — в юните 4):
• синхронный запрос — ждём ответ;
• событие через брокер — сообщили и пошли дальше;
• webhook — внешняя система сама вызывает наш адрес HTTP-запросом;
• пакетная выгрузка — файл по расписанию.
Международная рамка спецификаций — ISO/IEC/IEEE 29148, она заменила IEEE 830 из BA-курса. В российских госпроектах ТЗ на автоматизированную систему оформляют по ГОСТ 34.602-2020.