Установка

Запуск из исходников

Запуск из исходников позволяет разработчикам быстро развернуть OpenBPM Tasklist в среде разработки и гибко адаптировать приложение под свои нужды.

Требования

Перед установкой убедитесь, что установлены следующие компоненты:

Node.js версии 20.19 или выше (рекомендуется LTS)
npm версии 8 или выше
Git для клонирования репозитория

Установка и запуск

Клонируйте репозиторий проекта:

git clone https://gitflic.ru/project/openbpm/openbpm-tasklist-react-community.git
cd openbpm-tasklist-react-community

Создайте файл конфигурации окружения:
```
cp env.example env.local
```
Отредактируйте env.local, указав параметры подключения к вашему BPM-движку:
```
VITE_APP_LOCALE=ru
VITE_BPM_ENGINE_API_URL=http://localhost:8080/engine-rest
VITE_BPM_ENGINE_TYPE=OPENBPM_ENGINE
```
- VITE_APP_LOCALE — язык интерфейса (ru или en);
- VITE_BPM_ENGINE_API_URL — URL REST API движка;
- VITE_BPM_ENGINE_TYPE — тип движка (OPENBPM_ENGINE, CAMUNDA, OPERATON).
Установите зависимости:
```
npm install
```
Запустите приложение в режиме разработки:
```
npm run dev
```
После успешного запуска интерфейс будет доступен по адресу: http://localhost:3000

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

npm run build
npm run preview

Docker

Для быстрого запуска OpenBPM Tasklist без необходимости установки Node.js можно использовать готовый Docker-образ.

Требования

Docker
Docker Compose (рекомендуется для комплексных развертываний)

Запуск через Docker

Склонируйте репозиторий проекта:

git clone https://gitflic.ru/project/openbpm/openbpm-tasklist-react-community.git
cd openbpm-tasklist-react-community/docker-compose

Отредактируйте файл .env, указав параметры подключения к BPM-движку:
```
VITE_APP_LOCALE=ru
VITE_BPM_ENGINE_API_URL=http://localhost:8080/engine-rest
VITE_BPM_ENGINE_TYPE=OPENBPM_ENGINE
```
Запустите контейнер:
```
docker-compose up -d
```
Проверьте, что контейнер запущен:
```
docker ps
```
После запуска интерфейс будет доступен по адресу: http://localhost:3000

Если вы запускаете Tasklist в контейнере, а движок BPM работает локально, необходимо разрешить CORS-запросы.

Для Tomcat добавьте в web.xml следующий фильтр:

<filter>
  <filter-name>CorsFilter</filter-name>
  <filter-class>org.apache.catalina.filters.CorsFilter</filter-class>
  <init-param>
    <param-name>cors.allowed.origins</param-name>
    <param-value>http://localhost:3000</param-value>
  </init-param>
  <init-param>
    <param-name>cors.allowed.methods</param-name>
    <param-value>GET,POST,HEAD,OPTIONS,PUT,DELETE</param-value>
  </init-param>
  <init-param>
    <param-name>cors.allowed.headers</param-name>
    <param-value>Content-Type,Accept,X-Requested-With,Authorization,Origin</param-value>
  </init-param>
  <init-param>
    <param-name>cors.exposed.headers</param-name>
    <param-value>Location</param-value>
  </init-param>
</filter>

<filter-mapping>
  <filter-name>CorsFilter</filter-name>
  <url-pattern>/*</url-pattern>
</filter-mapping>

Для Run добавьте в default.yml следующую конфигурацию:

openbpm.bpm:
  run:
# https://docs.openbpm.ru/openbpm/engine/user-guide/openbpm-engine-bpm-run.html#_cross_origin_resource_sharing
    cors:
      enabled: true
      allowed-origins: "http://localhost:3000"

Остановка контейнера

Для остановки используйте команду:

docker-compose down

Если вы хотите запустить контейнер напрямую без Docker Compose, используйте команду:

docker run -d --name openbpm-tasklist -p 3000:3000 \
  -e VITE_BPM_ENGINE_API_URL=http://localhost:8080/engine-rest \
  -e VITE_BPM_ENGINE_TYPE=OPENBPM_ENGINE \
  registry.gitflic.ru/project/openbpm/openbpm-tasklist-react-community/openbpm-tasklist-react-community:latest