## 1 Мы провели долгий эксперимент с созданием BPMN-редактора, а теперь задача — найти способы превратить BPMN-диаграмму в исполняемый JavaScript-код. Нужно исследовать существующие инструменты. Поиск даёт несколько ключевых результатов. Один из них — PR в репозитории Apache KIE Tools , где созданы новые маршаллеры для BPMN на TypeScript, работающие в браузере и Node.js. Это позволяет парсить XML в JSON и обратно, что является основой для исполнения. Другой важный инструмент — bpmn-engine , который представляет собой JavaScript-движок выполнения BPMN 2.0. Он поддерживает основные элементы BPMN, использует bpmn-moddle для чтения XML и может быть расширен. Его популярность — ~2500 загрузок в неделю, лицензия MIT, активная поддержка. Также есть ProcessEngine Core , который делится на Model (парсинг XML в JSON) и Runtime (выполнение процессов). Он более модульный и структурированный. Важно: bpmn-js — это библиотека для визуализации и редактирования диаграмм, но она не выполняет процессы. Однако для исполнения нужны модули для чтения (bpmn-moddle) и выполнения (bpmn-engine). Также есть упоминание о проекте eagle-flow — «чисто фронтенд реализация xml генерации», но это скорее редактор. JointJS+ — это коммерческий продукт для создания BPMN-редакторов, но он не предназначен для выполнения процессов. LinkedIn-обсуждение даёт контекст о современном использовании BPMN, но не техническую информацию о трансляции в код. ## 1.1 ## 🔍 Трансляция BPMN XML в исполняемый JavaScript-код ### Что это такое Трансляция BPMN XML в исполняемый JavaScript-код — это процесс, при котором BPMN-диаграмма (стандартный XML-файл) преобразуется в программную логику, которую может выполнять JavaScript-движок. Это позволяет автоматизировать бизнес-процессы, описанные в BPMN, непосредственно в браузере или на сервере Node.js. --- ## 📦 Основные инструменты для трансляции ### 1. **bpmn-moddle** (низкоуровневое чтение/запись BPMN) Это не исполнитель, а библиотека для чтения и записи BPMN 2.0 XML в браузере и Node.js . **Особенности:** - Преобразует BPMN XML в JavaScript-объекты и обратно - Работает на основе метаданных, сгенерированных из XSD-схем - Является основой для всех инструментов экосистемы bpmn.io **Использование:** ```javascript import { BpmnModdle } from 'bpmn-moddle'; const moddle = new BpmnModdle(); const { rootElement } = await moddle.fromXML(bpmnXML); // rootElement — это JavaScript-объект, представляющий BPMN-диаграмму ``` --- ### 2. **bpmn-engine** — полноценный JavaScript-движок выполнения **npm:** [bpmn-engine](https://www.npmjs.com/package/bpmn-engine) **GitHub:** [paed01/bpmn-engine](https://github.com/paed01/bpmn-engine) **Лицензия:** MIT **Статистика:** ~2450 загрузок в неделю, 892 звезды на GitHub Это **единственный зрелый open-source BPMN-движок на JavaScript**, который может выполнять BPMN-процессы . **Архитектура:** - Использует `bpmn-moddle` для парсинга XML - Поддерживает основные элементы BPMN 2.0: задачи, шлюзы, события, потоки - Расширяется через кастомные обработчики **Пример использования:** ```javascript const Engine = require('bpmn-engine'); const engine = new Engine({ source: 'process.bpmn' // или XML-строка }); engine.execute((err, instance) => { instance.on('activity.wait', (activity) => { console.log('Ожидание выполнения:', activity.id); }); }); ``` **Поддерживаемые элементы:** - Start/End Events - User Tasks, Service Tasks, Script Tasks - Exclusive/Parallel/Inclusive Gateways - Subprocesses - Sequence Flows --- ### 3. **@process-engine/process_engine_core** — модульная архитектура **npm:** [@process-engine/process_engine_core](https://www.npmjs.com/package/@process-engine/process_engine_core) **Лицензия:** MIT Более структурированный движок, разделяющий **парсинг** и **выполнение** процессов . **Два основных модуля:** - **Model** — `BpmnModelParser` — парсинг XML в JSON - **Runtime** — `ExecuteProcessService` — управление выполнением **Архитектура:** - `FlowNodeHandler` — базовый класс для обработчиков разных типов узлов - `ProcessTokenFacade` — управление состоянием процесса (токены) - Поддержка Boundary Events, параллельных ветвей **Пример:** ```javascript const { BpmnModelParser } = require('@process-engine/process_engine_core').Model; const { ExecuteProcessService } = require('@process-engine/process_engine_core').Runtime; const parser = new BpmnModelParser(); const model = parser.parse(bpmnXML); const executionService = new ExecuteProcessService(); executionService.start(model); ``` --- ### 4. **bpmn-marshaller** (от Apache KIE Tools) **GitHub:** [apache/incubator-kie-tools](https://github.com/apache/incubator-kie-tools/pull/1854) **Лицензия:** Apache 2.0 Современный TypeScript-инструмент для парсинга BPMN, DMN и SceSim, созданный в рамках экосистемы KIE . **Особенности:** - Написан на TypeScript - Работает в браузере и Node.js - Генерирует строго типизированные JSON-объекты - Основан на `xml-parser-ts` — собственном парсере с генерацией метаданных из XSD **Преимущества:** - Полная типобезопасность - Поддержка BPMN 2.0.2 - Является частью экосистемы Red Hat / IBM --- ## 🆚 Сравнение инструментов | Критерий | **bpmn-engine** | **ProcessEngine Core** | **bpmn-moddle** | **bpmn-marshaller** | |----------|-----------------|------------------------|-----------------|---------------------| | **Назначение** | Полноценный движок выполнения | Модульный движок | Парсинг XML ↔ JSON | Парсинг с типами | | **Выполнение процессов** | ✅ Да | ✅ Да | ❌ Только парсинг | ❌ Только парсинг | | **Поддержка BPMN 2.0** | Базовая (расширяется) | Полная | Полная (через XSD) | BPMN 2.0.2 | | **Язык** | JavaScript | JavaScript | JavaScript | TypeScript | | **Лицензия** | MIT | MIT | MIT | Apache 2.0 | | **Активность** | Активная (последний релиз 1 месяц назад) | Стабильная | Активная | Активная | | **Node.js** | ✅ Да | ✅ Да | ✅ Да | ✅ Да | | **Браузер** | ❌ Нет (требуется Node.js) | ❌ Нет | ✅ Да | ✅ Да | | **Сложность интеграции** | Средняя | Средняя | Низкая | Средняя | | **Расширяемость** | Кастомные обработчики | Через FlowNodeHandler | — | — | --- ## 🏗️ Как это работает на практике ### Типичная архитектура BPMN-движка: ``` 1. BPMN XML → парсер → внутреннее представление (JSON) ↓ 2. Внутреннее представление → построение графа выполнения ↓ 3. Граф выполнения → интерпретатор (движок) ↓ 4. Результат выполнения (токены, состояние) ``` ### Пример полного цикла с bpmn-engine: ```javascript const Engine = require('bpmn-engine'); // 1. XML диаграммы const bpmnXml = ` `; // 2. Создание и запуск движка const engine = new Engine({ source: bpmnXml, services: { // Кастомный обработчик для ServiceTask CalculateTask: async (context) => { const { num1, num2, operation } = context.environment.variables; // Выполнение логики калькулятора return result; } } }); // 3. Запуск процесса engine.execute((err, instance) => { instance.on('end', () => { console.log('Процесс завершён'); }); }); ``` --- ## 🎯 Выбор инструмента ### Выберите **bpmn-engine**, если: - Нужен **готовый движок выполнения** процессов - Работаете в Node.js-среде - Нужна базовая поддержка BPMN 2.0 с возможностью расширения ### Выберите **ProcessEngine Core**, если: - Нужна более модульная архитектура - Планируете сложную обработку Boundary Events - Нужно разделить парсинг и выполнение ### Выберите **bpmn-moddle**, если: - Нужен **только парсинг и генерация XML** - Работаете в браузере - Строите свой собственный движок ### Выберите **bpmn-marshaller**, если: - Используете TypeScript - Нужна строгая типизация - Работаете в экосистеме KIE / Red Hat --- ## 💡 Рекомендация для вашего BPMN-калькулятора Для вашего калькулятора на основе BPMN (который мы создали ранее), оптимальный подход: 1. **Оставьте bpmn-js для визуального редактирования** (пользователь создаёт диаграмму) 2. **Добавьте bpmn-engine на серверную часть** (или в Web Worker, если нужно в браузере) 3. **Свяжите интерфейс с движком**: при изменении диаграммы экспортируйте XML, отправляйте на сервер (или в Worker), где bpmn-engine выполнит процесс с переданными числами Пример гибридного подхода: ```javascript // В браузере: получаем XML из редактора const xml = await modeler.saveXML(); // Отправляем на сервер или в Worker const result = await fetch('/api/execute', { method: 'POST', body: JSON.stringify({ xml, variables: { num1, num2, operation } }) }); ``` --- ## 🔗 Полезные ссылки - [bpmn-engine на npm](https://www.npmjs.com/package/bpmn-engine) - [bpmn-moddle документация](https://github.com/bpmn-io/bpmn-moddle) - [Apache KIE Tools](https://github.com/apache/incubator-kie-tools) - [bpmn.io — экосистема инструментов](https://bpmn.io) Share: https://chat.deepseek.com/a/chat/s/e841c3c8-0070-4a6b-ac9b-6ec56ee56fc9 ## 2 ## 📐 Подробные примеры реализации калькулятора для каждого инструмента трансляции BPMN в JavaScript Ниже приведены детальные примеры использования каждого из четырёх инструментов для реализации калькулятора: два поля ввода чисел, выбор операции (+, -, *, /) и поле результата. --- ## 1. **bpmn-engine** (полноценный движок выполнения, Node.js) ### Описание `bpmn-engine` — JavaScript-движок для выполнения BPMN-процессов в Node.js. Позволяет загружать BPMN XML, задавать переменные и обрабатывать задачи через кастомные сервисы. ### BPMN XML (calculator.bpmn) ```xml ``` ### Код Node.js (calculator-engine.js) ```javascript const Engine = require('bpmn-engine'); const fs = require('fs'); // Читаем BPMN XML (или используем строку) const bpmnXml = fs.readFileSync('./calculator.bpmn', 'utf8'); // Создаём движок с кастомным сервисом для задачи CalculateTask const engine = new Engine({ source: bpmnXml, services: { // Имя задачи должно совпадать с id в BPMN CalculateTask: async (context) => { // Получаем переменные из контекста процесса const { num1, num2, operation } = context.environment.variables; // Выполняем вычисление let result; switch (operation) { case '+': result = num1 + num2; break; case '-': result = num1 - num2; break; case '*': result = num1 * num2; break; case '/': result = num2 === 0 ? 'Ошибка: деление на ноль' : num1 / num2; break; default: result = 'Ошибка: неизвестная операция'; } // Сохраняем результат в переменные процесса context.environment.variables.result = result; return result; } } }); // Запускаем процесс с входными переменными engine.execute((err, instance) => { if (err) { console.error('Ошибка выполнения:', err); return; } // Устанавливаем переменные перед началом instance.environment.setVariable('num1', 10); instance.environment.setVariable('num2', 5); instance.environment.setVariable('operation', '+'); // Слушаем окончание процесса instance.on('end', () => { const result = instance.environment.getVariable('result'); console.log(`Результат: ${result}`); }); }); ``` ### Пояснение - **Движок** загружает BPMN XML и регистрирует обработчик для `CalculateTask`. - Входные данные передаются как переменные окружения. - После выполнения задачи результат сохраняется в переменную `result`. - В конце процесса мы получаем результат. --- ## 2. **@process-engine/process_engine_core** (модульный движок, Node.js) ### Описание Более модульный движок, разделяющий парсинг и выполнение. Позволяет гибко настраивать обработчики для разных типов узлов. ### Установка ```bash npm install @process-engine/process_engine_core ``` ### Код Node.js (calculator-process-engine.js) ```javascript const { BpmnModelParser } = require('@process-engine/process_engine_core').Model; const { ExecuteProcessService } = require('@process-engine/process_engine_core').Runtime; const fs = require('fs'); // 1. Парсим BPMN XML в модель const bpmnXml = fs.readFileSync('./calculator.bpmn', 'utf8'); const parser = new BpmnModelParser(); const model = parser.parse(bpmnXml); // модель процесса // 2. Создаём экземпляр сервиса выполнения const executionService = new ExecuteProcessService(); // 3. Регистрируем кастомный обработчик для ServiceTask const flowNodeHandlers = { serviceTask: { async onEnter(flowNode, context) { if (flowNode.id === 'CalculateTask') { // Получаем переменные процесса const variables = context.executionContext.getVariables(); const num1 = variables.num1; const num2 = variables.num2; const operation = variables.operation; // Вычисляем let result; switch (operation) { case '+': result = num1 + num2; break; case '-': result = num1 - num2; break; case '*': result = num1 * num2; break; case '/': result = num2 === 0 ? 'Ошибка: деление на ноль' : num1 / num2; break; default: result = 'Ошибка: неизвестная операция'; } // Сохраняем результат context.executionContext.setVariable('result', result); return; // завершаем задачу } } } }; // 4. Запускаем процесс с входными переменными const variables = { num1: 10, num2: 5, operation: '+' }; executionService.start(model, variables, flowNodeHandlers) .then((executionContext) => { // Процесс завершён const result = executionContext.getVariable('result'); console.log(`Результат: ${result}`); }) .catch((err) => console.error('Ошибка выполнения:', err)); ``` ### Пояснение - **Парсер** превращает XML в объектную модель. - **Сервис выполнения** запускает процесс, передавая ему переменные и хендлеры. - Для узла `CalculateTask` мы определяем `onEnter`, который выполняет вычисление и сохраняет результат. - Процесс завершается автоматически после выполнения всех узлов. --- ## 3. **bpmn-moddle** (парсинг XML ↔ JSON, браузер / Node.js) ### Описание `bpmn-moddle` не выполняет процессы, а только парсит BPMN XML в JavaScript-объекты и обратно. Мы можем использовать его для чтения BPMN и последующей ручной интерпретации. ### Код (браузерный пример) ```html BPMN Moddle Calculator
Результат:
``` ### Пояснение - `BpmnModdle` парсит XML в объектную модель. - В примере мы парсим диаграмму, а затем используем отдельную JavaScript-функцию для вычислений. - **bpmn-moddle** не выполняет процесс; мы сами должны интерпретировать модель и вызывать нужные обработчики. --- ## 4. **bpmn-marshaller** (от Apache KIE Tools, TypeScript, браузер) ### Описание `bpmn-marshaller` — современный TypeScript-инструмент для парсинга BPMN XML в строго типизированные JavaScript-объекты. Он также не выполняет процессы, но даёт удобный доступ к данным модели. ### Установка ```bash npm install @kie-tools/bpmn-marshaller ``` ### Код (TypeScript / браузер) ```typescript import { Bpmn2Marshaller } from '@kie-tools/bpmn-marshaller'; import { XmlParser } from '@kie-tools/xml-parser-ts'; // BPMN XML const bpmnXml = ` `; // Создаём парсер XML const xmlParser = new XmlParser(); // Используем маршаллер const marshaller = new Bpmn2Marshaller(); const model = marshaller.unmarshal(xmlParser.parse(bpmnXml)); // model — строго типизированный объект, описывающий BPMN-диаграмму // Находим задачу const definitions = model.definitions; const process = definitions.rootElements?.find(el => el.$type === 'bpmn:Process'); const serviceTasks = process?.flowElements?.filter(el => el.$type === 'bpmn:ServiceTask'); console.log('Задачи:', serviceTasks?.map(t => t.id)); // Логика калькулятора (отдельно) // ... ``` ### Пояснение - `bpmn-marshaller` даёт **строго типизированное** представление BPMN. - Можно легко навигировать по модели, получать информацию о задачах, шлюзах и т.д. - Выполнение процесса нужно реализовывать самостоятельно, используя полученную модель. --- ## 📊 Сравнение подходов в контексте калькулятора | Инструмент | Где выполняется | Сложность реализации | Особенности | |------------|----------------|----------------------|-------------| | **bpmn-engine** | Node.js | Низкая | Готовый движок, кастомные сервисы. Не работает в браузере. | | **ProcessEngine Core** | Node.js | Средняя | Модульный, гибкие обработчики. Требует больше кода. | | **bpmn-moddle** | Браузер/Node.js | Низкая (парсинг) | Только парсинг. Выполнение нужно писать самому. | | **bpmn-marshaller** | Браузер/Node.js | Низкая (парсинг) | TypeScript, строгая типизация. Выполнение ручное. | ### Рекомендация для вашего приложения Если вы создаёте веб-приложение (как в вашем предыдущем коде с bpmn-js) и хотите выполнять BPMN-процессы прямо в браузере: - **bpmn-moddle** или **bpmn-marshaller** позволят разобрать XML, а логику вычислений реализовать вручную (как вы уже сделали). - Если вам нужен полноценный исполняемый движок в браузере, можно рассмотреть портирование `bpmn-engine` в Web Worker, но это сложнее. Для серверной части (Node.js) лучше использовать **bpmn-engine** или **ProcessEngine Core**, так как они предоставляют готовое выполнение процессов. Если нужен пример интеграции **bpmn-engine** с вашим веб-интерфейсом (через API), дайте знать – подготовлю дополнительный пример.