Наши публикации

Контекст‑карты — это истории в картинках

2025-10-04 18:21 Knowledge Graphs Практика

Зачем это нужно

  • Быстро объяснить ситуацию без длинных ТЗ.
  • Согласовать границы системы: что внутри, что снаружи.
  • Связать язык бизнеса (сюжеты) с языком архитектуры (компоненты, интерфейсы).

Из чего состоит контекст‑карта

  1. Сцена (setting): место/рамки ситуации
  2. Акторы: роли/системы, у которых есть мотив
  3. Цель: измеримый исход (Definition of Done)
  4. Взаимодействия: события, команды, данные
  5. Ограничения: правила, ресурсы, риски
Одно предложение‑ядро:
Когда [Актор] в [Сцене] хочет [Цель], он взаимодействует с [Актор/Система] через [Интерфейс/Событие], соблюдая [Ограничение].

Как превратить историю в диаграмму (быстрый рецепт)

  • Подчеркните в тексте существительные → узлы (акторы/системы/контексты).
  • Подчеркните глаголы и существительные‑артефакты → связи и потоки (команда/событие/документ/данные).
  • Вынесите цель на уровень бейджа/аннотации узла (так видна метрика успеха).

Мини‑шаблон для Онто (можно прямо в OntoNet)

Шаблоны
  • [CTX] Контекст: цель, метрика, границы
  • [ROLE] Актор: тип (пользователь/система/внешний), мотивация
  • [EVT] Взаимодействие: вид (команда|событие|запрос), артефакт/данные, SLA
  • [RULE] Ограничение: правило, политика, ресурс
Связи
  • Актор —исполняет→ Контекст
  • Контекст —обменивается→ Взаимодействие
  • Взаимодействие —подчиняется→ Ограничение
  • Контекст —достигает→ Цель(метрика)

Пример (одна строка → одна картинка)

«Когда Менеджер закупок в Контексте: пополнение склада хочет снизить дефицит до <2%, он создаёт заказ в ERP, ERP уведомляет Поставщика через EDI, соблюдая лимит бюджета и SLA поставки 48ч».
На диаграмме это даст: роли (Менеджер, ERP, Поставщик), контекст (Пополнение склада), потоки (Заказ, Уведомление), цель (дефицит <2%), ограничения (бюджет, SLA).

Связка с архитектурой (C4/компоненты)

  • Каждый Контекст → уровень System/Container с чёткими внешними интерфейсами.
  • Взаимодействия → интерфейсы/контракты (API/события).
  • Ограничения → нефункциональные требования (SLA, бюджет, политика данных).
  • Цели/метрики → бейджи качества на узлах (health‑индикаторы).

Практика за 15 минут

  1. Напишите 3–5 историй по шаблону (одна цель — один контекст).
  2. Выделите акторов/потоки → перенесите в контекст‑карту.
  3. Добавьте цель и ограничения как бейджи.
  4. Привяжите интерфейсы к реальным системам (для C4).