UniBPM Integration Platform

Назначение

UniBPM Integration Platform — это отдельный сервисный слой, предназначенный для реализации внешних интеграций и точек входа в UniBPM.

Платформа используется для:

• приёма данных из внешних источников (лендинги, формы, сторонние сервисы);
• интеграции с внешними системами (CRM, ЭДО, логистика, ERP);
• преобразования и маршрутизации данных в UniBPM и процессном движке;
• вызов REST API UniBPM из сервисных задач.

Integration Platform изолирована от основного приложения UniBPM и развивается независимо.

Основные компоненты

• unibpm-integration-runtime
  Базовый runtime-сервис (Spring Boot), в котором выполняются integration-модули.

• unibpm-api-client Библиотека-клиент (Spring Cloud / Feign) для работы с REST API UniBPM, а также DTO.

• unibpm-integration-feedback
  Интеграция форм обратной связи.

• unibpm-external-task-starter
  Обработчик сервисных задач (Service Tasks) UniBPM Engine.

• unibpm-external-task-demo.md
  Демонстрационный коннектор

• unibpm-integration-onec-odata
  Коннектор 1С Предприятия oData

• unibpm-integration-keycloak Коннектор Keycloak

• unibpm-integration-unibpm.md Коннектор UniBPM

Архитектурная схема (логическая)

• TBD

Принципы архитектуры

• Модульность
  Каждая интеграция реализуется отдельным модулем.

• Изоляция
  Integration Platform не содержит бизнес-логики UniBPM.

• Stateless
  Все публичные API являются stateless.

• Explicit security
  Только /public/** разрешён без аутентификации. Остальные endpoints закрыты.

Жизненный цикл запроса (пример feedback)

1. Пользователь отправляет форму на лендинге.
2. Запрос поступает в /public/feedback.
3. Выполняется:
   • валидация payload,
   • проверка SmartCaptcha,
   • проверка конфигурации формы.
4. Создаётся заявка в UniBPM через UniBPM API.
5. Клиенту возвращается результат.