README.md

Order Picking (Java, Quarkus, Maven)

Generate an optimal picking plan for completing a set of orders.

Name	Level	Description
Required number of buckets	Hard	A trolley must have enough buckets for all assigned orders.
Minimize distance from previous pick task	Soft	Minimize the travel distance between consecutive pick tasks.
Minimize distance from last pick task to path origin	Soft	Minimize the return distance from the last pick task to the start of the path.
Minimize order split by trolley	Soft	Minimize the number of trolleys used for each order.

Install Java and Maven, for example with Sdkman:
```
$ sdk install java
$ sdk install maven
```

Git clone the timefold-quickstarts repo and navigate to this directory:

$ git clone https://github.com/TimefoldAI/timefold-quickstarts.git
...
$ cd timefold-quickstarts/java/order-picking

(Optional) If you want to run a licensed edition (Plus / Enterprise), set up your license key first. See the Timefold license tool for instructions.
Start the application with Maven:
1. Community Edition
```
$ mvn quarkus:dev
```
2. Plus / Enterprise Edition: The profile sets up the correct Maven artifacts to run the licensed version. See the pom.xml for the implementation details.
```
$ mvn quarkus:dev -Denterprise
```
Visit http://localhost:8080 in your browser.
Click on the Solve button.

Then try live coding:

Notice that those changes are immediately in effect.

When you're done iterating in quarkus:dev mode, package the application to run as a conventional jar file.

Compile it with Maven:
```
$ mvn package
```
Run it:
```
$ java -jar ./target/quarkus-app/quarkus-run.jar
```
Note To run it on port 8081 instead, add -Dquarkus.http.port=8081.
Visit http://localhost:8080 in your browser.
Click on the Solve button.

Run a container:

$ docker run -p 8080:8080 --rm $USER/order-picking:1.0-SNAPSHOT

To increase startup performance for serverless deployments, build the application as a native executable:

Install GraalVM and gu install the native-image tool.
Compile it natively. This takes a few minutes:
```
$ mvn package -Dnative -DskipTests
```
Run the native executable:
```
$ ./target/*-runner
```
Visit http://localhost:8080 in your browser.
Click on the Solve button.