incubator kie optaplanner

Um solucionador de restrições de IA de código aberto, rápido e fácil de usar para desenvolvedores de software

Procurando guias de início rápido?

Os guias de início rápido do OptaPlanner estão localizados no repositório optaplanner-quickstarts.

Início rápido do desenvolvimento

Para compilar e executar a partir do código-fonte:

 $ mvn instalação limpa -Drapidamente
$ cd exemplos de optaplanner
$mvnexec:java

Para desenvolver com IntelliJ IDEA, Eclipse ou VSCode, abra o pom.xml raiz como um novo projeto e defina uma configuração de execução/depuração como esta:

• Tipo: Aplicativo

• Classe principal: org.optaplanner.examples.app.OptaPlannerExamplesApp

• Opções de VM: -Xmx2G -server (memória necessária apenas ao usar grandes conjuntos de dados nos exemplos)

• Argumentos do programa: (nenhum)

• Diretório de trabalho: $MODULE_DIR$ (deve ser resolvido para o diretório optaplanner-examples)

• Use o caminho de classe do módulo: optaplanner-examples

Contribuindo para o OptaPlanner

Este é um projeto de código aberto e você é mais que bem-vindo para contribuir ❤️!

• Se você está apenas começando com o OptaPlanner e deseja contribuir, dê uma olhada em nossos problemas iniciais. Eles são escolhidos especificamente para serem mais fáceis para colaboradores iniciantes.

• Se você quiser contribuir ou iniciar uma discussão opinativa, participe de nossa discussão ou envie um e-mail diretamente para [email protected].

• Se você quiser enviar um problema, confira o projeto OptaPlanner Jira.

Hora de fazer uma mudança?

Cada alteração deve ser enviada por meio de uma solicitação pull (PR) do GitHub. OptaPlanner usa integração contínua (CI). O CI OptaPlanner executa verificações em sua filial depois que você envia o PR para garantir que seu PR não introduza erros. Se o CI identificar um problema potencial, nossos amigáveis ​​mantenedores de RP ajudarão você a resolvê-lo.

Contribuindo

1. Faça um fork (https://github.com/kiegroup/optaplanner).

2. Crie sua ramificação de recursos: ( git checkout -b feature ).

3. Confirme suas alterações com um comentário: ( git commit -am 'Add some feature' ).

4. Envie para o branch no GitHub: ( git push origin feature ).

5. Crie uma nova solicitação pull.

Padrões de código

Seu código é formatado automaticamente de acordo com as convenções de importação e estilo de código durante cada compilação do Maven. As verificações de CI também aplicam essas convenções, portanto, certifique-se de construir seu projeto com maven antes de criar seu PR:

 instalação limpa mvn

Para obter informações sobre como configurar verificações de estilo de código, consulte Instruções de configuração do IDE.

Construindo seu projeto OptaPlanner

Use uma das seguintes maneiras para construir seu projeto OptaPlanner:

• build-fast : mvn clean install -Dquickly qualquer verificação e análise de código (~1 min)

• ? build-normally : mvn clean install executa testes, verifica o estilo do código, pula a documentação (~17 min)

• ? build-doc : mvn clean install em optaplanner/optaplanner-docs cria documentação asciidoctor target/optaplanner-docs-*/html_single/index.html (~2 min)

• ? build-all : mvn clean install -Dfull executa todas as verificações + cria documentação e arquivos de distribuição (~20 min)

Status do CI do OptaPlanner

Você pode verificar o status do CI dos repositórios do OptaPlanner na página Chain Status.

Jenkins CI Jobs (precisa de acesso VPN)

Todos os trabalhos Jenkins podem ser encontrados na pasta OptaPlanner: https://eng-jenkins-csb-business-automation.apps.ocp-c1.prod.psi.redhat.com/job/KIE/job/optaplanner

Trabalhos interessantes do Jenkins CI (precisam de acesso VPN):

• Atualizar versão do Quarkus

• Atualizar versão do Drools

• Pipeline de lançamento (disponível apenas em ramificações de lançamento)

• Pipeline pós-lançamento (disponível apenas em ramificações de lançamento)