Архитектурный репозиторий

В этой статье расскажем, как обеспечить единое пространство работы между архитекторами и бизнес-аналитиками, обеспечить трасировку использования архитектурных элементов на процессы.

Описание задачи

Во многих организациях есть 2 роли, которые касаются процессов - архитекторы и аналитики. Но касаются они процессов по разному и решают разные задачи в контексте процессов. Архитекторы тут ярлык для тех, кто решает указанные задачи. Иногда они могут называться Системные, Энтерпрайз, Солюшен и т.д.

Задачи архитекторов:

• Обеспечить четкое и актуальное описание архитектуры систем, приложений, серверов и так далее.
• Отслеживать изменения в архитекуре и их влияние на бизнес-процессы.
• Управлять каталогом архитектурных компонентов и их взаимосвязями.
• Контролировать соответствие реализации процессов архитектурным принципам и стандартам.
• Обеспечивать интеграционную совместимость между различными системами в рамках процессов.
• Проводить анализ архитектурных рисков и их влияние на критичные бизнес-процессы.
• Планировать архитектурную эволюцию с учетом развития процессной модели организации.
• Определять технические требования к системам поддержки процессов.
• Разрабатывать ключевые показатели эффективности (KPI) для процессов.
• Координировать внедрение изменений в процессы с ИТ-подразделениями.

Задачи аналитиков:

• Обеспечить четко и актуальное описание бизнес-процессов, ВКЛЮЧАЯ окружающий контекст вокруг - системы, документы и так далее.
• Анализировать эффективность текущих процессов и выявлять узкие места.
• Моделировать оптимизированные процессы с учетом архитектурных ограничений.
• Документировать требования к информационным системам со стороны бизнес-процессов.
• Обеспечивать соответствие процессов нормативным требованиям и стандартам.
• Проводить анализ влияния изменений в процессах на архитектуру ИТ-ландшафта.
• Обеспечивать трасируемость бизнес-требований к архитектурным решениям.

Взаимодействие ролей

В области пересечения находится Каталог архитектурных компонентов и трасировка на процессы, где обе роли совместно работают над:

• Единым описанием архитектурных элементов
• Связыванием бизнес-процессов с техническими компонентами
• Обеспечением актуальности и согласованности данных
• Трасировкой изменений от бизнес-требований к архитектуре

Решение задачи в Stormbpmn

Для решения описанных задач в организации должны быть внедрены две системы с налаженной интеграцией между ними:

• Система описания архитектурных компонентов и их связей (например, DocHub)
• Система управления процессами Stormbpmn

Принципы разделения ответственности

TL;DR: Архитектурные описания не хранятся в Stormbpmn.

На июнь 2025 года Stormbpmn является инструментом процессных аналитиков и потребителей результатов их труда — сотрудников, руководителей и других заинтересованных лиц. Мы намеренно ограничили модель описания архитектурных элементов и не поддерживаем их независимую (вне контекста бизнес-процессов) связь и трасировку.

Модель архитектурного элемента в Stormbpmn

Модель элемента архитектуры в Stormbpmn содержит следующие атрибуты:

• Название — человекочитаемое имя элемента
• Тип — готовые типы (Система, Документ и т.д.) или пользовательские
• Цвет элемента — для визуального разделения на диаграммах
• ID из внешней системы — идентификатор в системе архитекторов
• Ссылка на внешнюю систему — прямая ссылка на детальное описание
• Текстовое описание — краткое описание назначения элемента
• Статус — жизненный цикл элемента:
  • Новый
  • Внедряется
  • В эксплуатации
  • Вывод из эксплуатации
  • Архив
• Связь с задачами — через задачи устанавливается связь с процессами

Достаточность модели для разных ролей

Для бизнес-аналитиков такая модель полностью решает задачи:

• Трасировки архитектурных элементов на процессы
• Визуализации связей между процессами и системами
• Анализа влияния изменений в архитектуре на процессы

Для архитекторов данная модель является недостаточной, поскольку не покрывает:

• Детальное описание технических характеристик
• Сложные взаимосвязи между архитектурными компонентами
• Архитектурные паттерны и принципы проектирования
• Управление версиями архитектурных решений

Как подружить 2 мира

Мы предлагаем решать этот вопрос интеграцией и определенными соглашениями:

1. Единый источник архитектурных компонентов — все архитектурные компоненты хранятся и описываются в системе описания архитектурных компонентов и их связей (например, DocHub)

2. Автоматическая синхронизация — система описания архитектурных компонентов отгружает их представление в формате Stormbpmn через REST API при создании, удалении или изменении элементов

3. Разделение прав доступа — аналитикам запрещается на уровне прав доступа создавать или редактировать архитектурные элементы в Stormbpmn

4. Аналитические запросы — запросы использования и трасировки выполняются на уровне SQL и DWH, поскольку в Stormbpmn реализована качественная модель таблиц в БД, позволяющая через JOIN получить любую необходимую информацию

Преимущества предлагаемого подхода

Для архитекторов:

• Консистентная модель мира между архитекторами и аналитиками
• Возможность выполнения аналитических запросов в несколько SQL-запросов с гарантией достоверности данных
• Единый источник правды для всех архитектурных компонентов
• Автоматическая синхронизация изменений

Для бизнес-аналитиков:

• Прямой доступ к детальному описанию архитектурных элементов через внешние ссылки
• Актуальная информация об архитектурных компонентах без необходимости ручного обновления
• Возможность визуализации трасировки элементов на процессы
• Упрощенная модель для работы с процессами

Для организации в целом:

• Устранение дублирования данных
• Снижение рисков рассинхронизации информации
• Четкое разделение ответственности между ролями
• Повышение качества архитектурных решений

Техническая реализация

Для реализации интеграции используются следующие API-методы:

• POST /public-api/v1/assets — загрузка и обновление элементов архитектуры
• GET /public-api/v1/get-diagram-list — получение списка диаграмм для анализа
• SQL-запросы к БД — для сложных аналитических задач и построения отчетов