Проект

Создание проекта

Установите (или у вас уже установлены):

PostreSQL (15-17 версии, с 18 какая-то ошибка при синхронизации)
Java (версии 21-25)
Node, npm

Создание кода проекта из шаблона

Для создание нового проекта для be5 используется maven archetype:

https://mvnrepository.com/artifact/com.developmentontheedge.be5/be5-app-template

Для его запуска наберите:
mvn archetype:generate -DarchetypeGroupId=com.developmentontheedge.be5 -DarchetypeArtifactId=be5-app-template

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

groupId
artifactId
version (значение по умолчанию - 1.0-SNAPSHOT)
package (значение по умолчанию - groupId)

Эти параметры также можно указать в строке запуска.

После запуска генерируется заготовка для проекта на основе этого шаблона:
https://github.com/DevelopmentOnTheEdge/testBe5app

Проект из репозитория

Если вы только что выкачали be5 проект из git репозитория, то могут потребоваться описанные ниже действия по его настройке.

Настройка проекта

Создание базы данных

Создайте в используемой вами СУБД:

пользователя, от имени которого be5 приложение будет соединяться с базой данных;
настройте ему права доступа (для PostgeSQL в привилегиях включите «Can login»);
создайте базу данных от этого пользователя.

Настройка соединения с базой данных

В директории проекта ./src создайте файл connectionProfiles.local.yaml

Ниже приведен пример такого файла

connectionProfiles:  
  profiles:  
    test_local:   
      connectionUrl: jdbc:postgresql://localhost:5434/registry   
      username: registry   
      password: registry

Более подробно: [[Connection profile|Connection profile]]

В директории проекта ./src создайте файл profile.local и в нем укажите имя соединения из файла connectionProfiles.local.yaml Ниже приведен пример такого файла

test_local

Быстрое обновление метаданных при запущенном проекте

Для быстрого обновления meta данных при разработке (yaml файлов проекта, groovy операций) создайте файл dev.yaml в корне проекта с содержимым:

paths:
  your_app: ./

Be5 будет следить за изменениями и перезагружать проект.

Создание таблиц базы данных

Для этого в директории проекта выполните команду:
mvn be5:create-db

Установка npm пакетов для фронтенда (be5-react)

Из корня проекта выполните команду:
npm install

Запуск проекта

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

npm start - запускает npm сервер, что позволяет без перезапуска сервера обновлять код react компонентов
mvn jetty:run -Djetty.http.port=8200 - запускает jetty сервер, без перезагрузки можно обновлять метаданные и groovy код операций.

Страничка в браузере: http://localhost:8888

Из шаблона приложение создан пользователь Administrator с паролем 12345.