base on Get started with Timefold quickstarts here. Optimize the vehicle routing problem, employee rostering, task assignment, maintenance scheduling and other planning problems. <p align="center"> <a href="https://timefold.ai"> <img src="/timefold-logo.png" width="400px" alt="Timefold Solver" /> </a> </p> [](https://github.com/TimefoldAI/timefold-solver/discussions) This repository contains quickstarts for [Timefold Solver](https://github.com/TimefoldAI/timefold-solver), an AI constraint solver for Java and Kotlin. It shows different use cases and basic implementations to get you started on your PlanningAI journey. ## Overview | Use Case <img width="341" height="1"> | Notable Solver Concepts <img width="541" height="1"> | |-----------------------------------------------------------------------|----------------------------------------------------------| | 🚚 <a href="#-vehicle-routing">Vehicle Routing</a> | Chained Through Time, Shadow Variables | | 🧑‍💼 <a href="#-employee-scheduling">Employee Scheduling</a> | Load Balancing | | 🛠️ <a href="#-maintenance-scheduling">Maintenance Scheduling</a> | TimeGrain, Shadow Variable, Variable Listener | | 📦 <a href="#-food-packaging">Food Packaging</a> | Chained Through Time, Shadow Variables, Pinning | | 🛒 <a href="#-order-picking">Order Picking</a> | Chained Planning Variable, Shadow Variables | | 🏫 <a href="#-school-timetabling">School Timetabling</a> | Timeslot | | 🏭 <a href="#-facility-location-problem">Facility Location Problem</a> | Shadow Variable | | 🎤 <a href="#-conference-scheduling">Conference Scheduling</a> | Timeslot, Justifications | | 🛏️ <a href="#-bed-allocation-scheduling">Bed Allocation Scheduling</a> | Allows Unassigned | | 🛫 <a href="#-flight-crew-scheduling">Flight Crew Scheduling</a> | | | 👥 <a href="#-meeting-scheduling">Meeting Scheduling</a> | TimeGrain | | ✅ <a href="#-task-assigning">Task Assigning</a> | Bendable Score, Chained Through Time, Allows Unassigned | | 📆 <a href="#-project-job-scheduling">Project Job Scheduling</a> | Shadow Variables, Variable Listener, Strenght Comparator | | 🏆 <a href="#-sports-league-scheduling">Sports League Scheduling</a> | Consecutive Sequences | | 🏅 <a href="#-tournament-scheduling">Tournament Scheduling</a> | Pinning, Load Balancing | > [!NOTE] > The implementations in this repository serve as a starting point and/or inspiration when creating your own application. > Timefold Solver is a library and does not include a UI. To illustrate these use cases a rudimentary UI is included in these quickstarts. ## Use cases ### 🚚 Vehicle Routing Find the most efficient routes for vehicles to reach visits, considering vehicle capacity and time windows when visits are available. Sometimes also called "CVRPTW".  - [Run quarkus-vehicle-routing](java/vehicle-routing/README.MD) (Java, Maven, Quarkus) > [!TIP] > <img src="https://docs.timefold.ai/_/img/models/field-service-routing.svg" align="right" width="50px" /> [Check out our off-the-shelf model for Field Service Routing](https://app.timefold.ai/models/field-service-routing). This model goes beyond basic Vehicle Routing and supports additional constraints such as priorities, skills, fairness and more. --- ### 🧑‍💼 Employee Scheduling Schedule shifts to employees, accounting for employee availability and shift skill requirements.  - [Run quarkus-employee-scheduling](java/employee-scheduling/README.MD) (Java, Maven, Quarkus) > [!TIP] > <img src="https://docs.timefold.ai/_/img/models/employee-shift-scheduling.svg" align="right" width="50px" /> [Check out our off-the-shelf model for Employee Shift Scheduling](https://app.timefold.ai/models/employee-scheduling). This model supports many additional constraints such as skills, pairing employees, fairness and more. --- ### 🛠️ Maintenance Scheduling Schedule maintenance jobs to crews over time to reduce both premature and overdue maintenance.  - [Run quarkus-maintenance-scheduling](java/maintenance-scheduling/README.adoc) (Java, Maven, Quarkus) --- ### 📦 Food Packaging Schedule food packaging orders to manufacturing lines to minimize downtime and fulfill all orders on time.  - [Run quarkus-food-packaging](java/food-packaging/README.adoc) (Java, Maven, Quarkus) --- ### 🛒 Order Picking Generate an optimal picking plan for completing a set of orders.  - [Run quarkus-order-picking](java/order-picking/README.adoc) (Java, Maven, Quarkus) --- ### 🏫 School Timetabling Assign lessons to timeslots and rooms to produce a better schedule for teachers and students.  - [Run quarkus-school-timetabling](java/school-timetabling/README.adoc) (Java, Maven or Gradle, Quarkus) - [Run spring-boot-school-timetabling](java/spring-boot-integration/README.adoc) (Java, Maven or Gradle, Spring Boot) - [Run kotlin-quarkus-school-timetabling](kotlin/school-timetabling/README.adoc) (Kotlin, Maven, Quarkus) Without a UI: - [Run hello-world-school-timetabling](java/hello-world/README.adoc) (Java, Maven or Gradle) --- ### 🏭 Facility Location Problem Pick the best geographical locations for new stores, distribution centers, COVID test centers, or telecom masts.  - [Run quarkus-facility-location](java/facility-location/README.adoc) (Java, Maven, Quarkus) --- ### 🎤 Conference Scheduling Assign conference talks to timeslots and rooms to produce a better schedule for speakers.  - [Run quarkus-conference-scheduling](java/conference-scheduling/README.adoc) (Java, Maven, Quarkus) --- ### 🛏️ Bed Allocation Scheduling Assign beds to patient stays to produce a better schedule for hospitals.  - [Run quarkus-bed-allocation-scheduling](java/bed-allocation/README.adoc) (Java, Maven, Quarkus) --- ### 🛫 Flight Crew Scheduling Assign crew to flights to produce a better schedule for flight assignments.  - [Run quarkus-flight-crew-scheduling](java/flight-crew-scheduling/README.adoc) (Java, Maven, Quarkus) --- ### 👥 Meeting Scheduling Assign timeslots and rooms for meetings to produce a better schedule.  - [Run quarkus-meeting-scheduling](java/meeting-scheduling/README.adoc) (Java, Maven, Quarkus) --- ### ✅ Task Assigning Assign employees to tasks to produce a better plan for task assignments.  - [Run quarkus-task-assigning](java/task-assigning/README.adoc) (Java, Maven, Quarkus) --- ### 📆 Project Job Scheduling Assign jobs for execution to produce a better schedule for project job allocations.  - [Run quarkus-project-job-scheduling](java/project-job-scheduling/README.adoc) (Java, Maven, Quarkus) --- ### 🏆 Sports League Scheduling Assign rounds to matches to produce a better schedule for league matches.  - [Run quarkus-sports-league-scheduling](java/sports-league-scheduling/README.adoc) (Java, Maven, Quarkus) --- ### 🏅 Tournament Scheduling Tournament Scheduling service assigning teams to tournament matches.  - [Run quarkus-tournament-scheduling](java/tournament-scheduling/README.adoc) (Java, Maven, Quarkus) --- ## Legal notice Timefold Quickstarts was [forked](https://timefold.ai/blog/2023/optaplanner-fork/) on 20 April 2023 from OptaPlanner Quickstarts, which was entirely Apache-2.0 licensed (a permissive license). Timefold Quickstarts is a derivative work of OptaPlanner Quickstarts, which includes copyrights of the original creator, Red Hat Inc., affiliates, and contributors, that were all entirely licensed under the Apache-2.0 license. Every source file has been modified. ", Assign "at most 3 tags" to the expected json: {"id":"14806","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"