incubator kie optaplanner

Быстрый и простой в использовании инструмент для решения ограничений искусственного интеллекта с открытым исходным кодом для разработчиков программного обеспечения.

Ищете краткие руководства?

Краткое руководство по OptaPlanner находится в репозитории optaplanner-quickstarts.

Быстрый старт разработки

Для сборки и запуска из исходного кода:

 $ mvn чистая установка - Dquickly
$ cd optaplanner-примеры
$ mvn exec: Java

Для разработки с помощью IntelliJ IDEA, Eclipse или VSCode откройте корневой файл pom.xml как новый проект и настройте конфигурацию запуска/отладки следующим образом:

• Тип: Приложение

• Основной класс: org.optaplanner.examples.app.OptaPlannerExamplesApp .

• Параметры виртуальной машины: -Xmx2G -server (память необходима только при использовании больших наборов данных в примерах)

• Аргументы программы: (нет)

• Рабочий каталог: $MODULE_DIR$ (должен разрешаться в каталог optaplanner-examples)

• Используйте путь к классам модуля: optaplanner-examples

Вклад в OptaPlanner

Это проект с открытым исходным кодом, и вы можете внести свой вклад ❤️!

• Если вы только начинаете работать с OptaPlanner и хотите внести свой вклад, ознакомьтесь с нашими стартовыми вопросами. Они специально выбраны для удобства тех, кто впервые участвует в работе.

• Если вы хотите внести свой вклад или начать дискуссию, присоединяйтесь к нашей дискуссии или отправьте электронное письмо по адресу [email protected].

• Если вы хотите сообщить о проблеме, ознакомьтесь с проектом OptaPlanner Jira.

Пора что-то изменить?

Каждое изменение должно быть отправлено через запрос на включение GitHub (PR). OptaPlanner использует непрерывную интеграцию (CI). OptaPlanner CI проверяет ваш филиал после отправки PR, чтобы убедиться, что ваш PR не содержит ошибок. Если CI обнаружит потенциальную проблему, наши дружелюбные специалисты по связям с общественностью помогут вам ее решить.

Содействие

1. Форкните его (https://github.com/kiegroup/optaplanner).

2. Создайте свою ветку функций: ( git checkout -b feature ).

3. Зафиксируйте изменения с комментарием: ( git commit -am 'Add some feature' ).

4. Отправьте сообщение в ветку на GitHub: ( git push origin feature ).

5. Создайте новый запрос на включение.

Стандарты кода

Ваш код автоматически форматируется в соответствии с соглашениями об импорте и стиле кода во время каждой сборки Maven. Проверки CI также обеспечивают соблюдение этих соглашений, поэтому обязательно создайте свой проект с помощью maven, прежде чем создавать PR:

 чистая установка mvn

Сведения о настройке проверок стиля кода см. в разделе «Инструкции по настройке IDE».

Создание вашего проекта OptaPlanner

Используйте один из следующих способов создания проекта OptaPlanner:

• build-fast : mvn clean install -Dquickly пропускает любые проверки и анализ кода (~ 1 минута)

• ? build-normally : mvn clean install запускает тесты, проверяет стиль кода, пропускает документацию (~ 17 минут)

• ? build-doc : mvn clean install в optaplanner/optaplanner-docs создает документацию asciidoctor target/optaplanner-docs-*/html_single/index.html (~2 мин)

• ? build-all : mvn clean install -Dfull запускает все проверки + создает файлы документации и дистрибутива (~20 мин)

Статус OptaPlanner CI

Вы можете проверить статус CI репозиториев OptaPlanner на веб-странице статуса цепочки.

Jenkins CI Jobs (нужен доступ к VPN)

Все задания Jenkins можно найти в папке OptaPlanner: https://eng-jenkins-csb-business-automation.apps.ocp-c1.prod.psi.redhat.com/job/KIE/job/optaplanner.

Интересные вакансии Jenkins CI (нужен доступ к VPN):

• Обновить версию Quarkus

• Обновить версию Drools

• Конвейер выпуска (доступен только в ветках выпуска)

• Пост-релизный конвейер (доступен только в ветках выпуска)