docs: Introduce initial docs for service module (Preview) (TimefoldAI#2350)

We have introduced the "Service" module, but this did not contain any
documentation yet.

This PR does: 
- Label some existing pages to be reworked (frontmatter data, no further
impact)
- Introduce a new navigation item: _Building a service (Preview)_
- Introduce a couple of pages which describe basic service capabilities
- Introduce a new quickstart explicitly built using the service module,
and reworked some of the shared files to avoid too much duplication
across quickstarts.
- Rework the quickstart page to mention the distinction between using
the solver as a _library_ vs a _service_

---------

Co-authored-by: Jurriaan Persyn <oemebamo@gmail.com>

Author: TomCools

docs/src/modules/ROOT/images/quickstart/service/openapi.png

@@ -2,16 +2,39 @@
 * xref:planning-ai-concepts.adoc[leveloffset=+1]
 * Getting started
 ** xref:quickstart/overview.adoc[leveloffset=+1]
-** xref:quickstart/hello-world/hello-world-quickstart.adoc[leveloffset=+1]
-** xref:quickstart/quarkus/quarkus-quickstart.adoc[leveloffset=+1]
-** xref:quickstart/spring-boot/spring-boot-quickstart.adoc[leveloffset=+1]
-** xref:quickstart/quarkus-vehicle-routing/quarkus-vehicle-routing-quickstart.adoc[leveloffset=+1]
+** Embed as a library
+*** xref:quickstart/hello-world/hello-world-quickstart.adoc[Hello World Guide]
+*** xref:quickstart/quarkus/quarkus-quickstart.adoc[Quarkus Guide]
+*** xref:quickstart/spring-boot/spring-boot-quickstart.adoc[Spring Boot Guide]
+** xref:quickstart/service/getting-started.adoc[Run as a service (Preview)]
+* Example use cases
+** xref:quickstart/quarkus-vehicle-routing/quarkus-vehicle-routing-quickstart.adoc[Vehicle Routing (Guide)]
+** https://github.com/TimefoldAI/timefold-quickstarts#-employee-scheduling[Employee Scheduling^]
+** https://github.com/TimefoldAI/timefold-quickstarts#-maintenance-scheduling[Maintenance Scheduling^]
+** https://github.com/TimefoldAI/timefold-quickstarts#-food-packaging[Food Packaging^]
+** https://github.com/TimefoldAI/timefold-quickstarts#-order-picking[Order Picking^]
+** https://github.com/TimefoldAI/timefold-quickstarts#-school-timetabling[School Timetabling^]
+** https://github.com/TimefoldAI/timefold-quickstarts#-facility-location-problem[Facility Location^]
+** https://github.com/TimefoldAI/timefold-quickstarts#-conference-scheduling[Conference Scheduling^]
+** https://github.com/TimefoldAI/timefold-quickstarts#-bed-allocation-scheduling[Bed Allocation^]
+** https://github.com/TimefoldAI/timefold-quickstarts#-flight-crew-scheduling[Flight Crew Scheduling^]
+** https://github.com/TimefoldAI/timefold-quickstarts#-meeting-scheduling[Meeting Scheduling^]
+** https://github.com/TimefoldAI/timefold-quickstarts#-task-assigning[Task Assigning^]
+** https://github.com/TimefoldAI/timefold-quickstarts#-project-job-scheduling[Project Job Scheduling^]
+** https://github.com/TimefoldAI/timefold-quickstarts#-sports-league-scheduling[Sports League Scheduling^]
+** https://github.com/TimefoldAI/timefold-quickstarts#-tournament-scheduling[Tournament Scheduling^]
 * Using Timefold Solver
 ** xref:using-timefold-solver/overview.adoc[leveloffset=+1]
 ** xref:using-timefold-solver/configuration.adoc[leveloffset=+1]
 ** xref:using-timefold-solver/modeling-planning-problems.adoc[leveloffset=+1]
 ** xref:using-timefold-solver/running-the-solver.adoc[leveloffset=+1]
 ** xref:using-timefold-solver/benchmarking-and-tweaking.adoc[leveloffset=+1]
+** xref:service/overview.adoc[Building a service (Preview)]
+*** xref:service/rest-api.adoc[leveloffset=+1]
+*** xref:service/modeling-changes.adoc[leveloffset=+1]
+*** xref:service/constraint-weights.adoc[leveloffset=+1]
+*** xref:service/demo-data.adoc[leveloffset=+1]
+*** xref:service/exposing-metrics.adoc[leveloffset=+1]
 * Constraints and score
 ** xref:constraints-and-score/overview.adoc[leveloffset=+1]
 ** xref:constraints-and-score/score-calculation.adoc[leveloffset=+1]

docs/src/modules/ROOT/nav.adoc

@@ -4,6 +4,11 @@
 :sectnums:
 :icons: font
 
+:relevance: library-and-service
+:notes: service module has some different patterns to deal with this.
+
+
+
 Deciding the correct xref:constraints-and-score/overview.adoc#scoreConstraintWeight[weight] and
 xref:constraints-and-score/overview.adoc#scoreLevel[level] for each constraint is not easy.
 It often involves negotiating with different stakeholders and their priorities.

docs/src/modules/ROOT/pages/constraints-and-score/constraint-configuration.adoc

@@ -5,7 +5,7 @@
 :doctype: book
 :sectnums:
 :icons: font
-
+:relevance: library-and-service
 
 [#scoreTerminology]
 == Score terminology

docs/src/modules/ROOT/pages/constraints-and-score/overview.adoc

@@ -4,6 +4,10 @@
 :sectnums:
 :icons: font
 
+:relevance: library-and-service
+:notes: Most of this should be in the "how to model" reference. Design patterns is too weak a term.
+
+
 
 [#designPatternsIntroduction]
 == Design patterns introduction

docs/src/modules/ROOT/pages/design-patterns/design-patterns.adoc

@@ -1,6 +1,7 @@
 = FAQ
 :doctype: book
 :icons: font
+:relevance: library-and-service
 
 == How is Timefold Solver Licensed?
 

docs/src/modules/ROOT/pages/frequently-asked-questions.adoc

@@ -3,6 +3,10 @@
 :doctype: book
 :sectnums:
 :icons: font
+:relevance: library-and-service
+:notes: Relevant, needs some rewrites. Also should include the "Getting Started" for Quarkus (raw) and Spring
+
+
 
 
 [#integrationOverview]

docs/src/modules/ROOT/pages/integration/integration.adoc

@@ -29,6 +29,9 @@ It xref:integration/integration.adoc#integration[integrates very easily] with ot
 Timefold Solver works on any Java Virtual Machine and is compatible with the major JVM languages and all major platforms.
 It also supports Kotlin.
 
+You can use Timefold Solver to build an xref:quickstart/overview.adoc#runAsAService[optimization service],
+or embed it into your software as a xref:quickstart/overview.adoc#embedAsALibrary[library].
+
 :!sectnums:
 == Next
 

docs/src/modules/ROOT/pages/introduction.adoc

@@ -7,6 +7,9 @@
 :doctype: book
 :sectnums:
 :icons: font
+:relevance: library-and-service
+:notes: Relevant, but some of this can move to a "shared" section instead.
+
 
 == The basics
 

docs/src/modules/ROOT/pages/optimization-algorithms/overview.adoc

@@ -353,7 +353,7 @@ public class TimetableApp {
                 .filter(lesson -> lesson.getTimeslot() != null && lesson.getRoom() != null)
                 .collect(Collectors.groupingBy(Lesson::getTimeslot, Collectors.groupingBy(Lesson::getRoom)));
         LOGGER.info("|            | " + rooms.stream()
-                .map(room -> String.format("%-10s", room.getName())).collect(Collectors.joining(" | ")) + " |");
+                .map(room -> String.format("%-10s", room.name())).collect(Collectors.joining(" | ")) + " |");
         LOGGER.info("|" + "------------|".repeat(rooms.size() + 1));
         for (Timeslot timeslot : timetable.getTimeslots()) {
             List<List<Lesson>> cells = rooms.stream()