Fail build when timefold.application.version is missing

service/quarkus/deployment/src/main/java/ai/timefold/solver/service/quarkus/deployment/TimefoldModelDescriptorProcessor.java

@@ -509,6 +509,14 @@ protected static void validateModelId(String modelId) {
         }
     }
 
+    protected static void validateApplicationVersion(String version) {
+        if (version == null || version.trim().isEmpty()) {
+            throw new IllegalArgumentException(
+                    "The application version is missing. Set the '" + APPLICATION_VERSION_PROPERTY
+                            + "' property (e.g. in application.properties) so the build can proceed.");
+        }
+    }
+
     private void generateModelDescriptor(String modelId, String model, OpenAPI openAPI,
             Path outputDirectory,
             Optional<ClassInfo> restResource,
@@ -527,8 +535,10 @@ private void generateModelDescriptor(String modelId, String model, OpenAPI openA
         descriptor.setModel(model);
         descriptor.setName(
                 config.getOptionalValue(APPLICATION_NAME_PROPERTY, String.class).orElse(openAPI.getInfo().getTitle()));
-        descriptor.setVersion(
-                config.getOptionalValue(APPLICATION_VERSION_PROPERTY, String.class).orElse(openAPI.getInfo().getVersion()));
+        String applicationVersion =
+                config.getOptionalValue(APPLICATION_VERSION_PROPERTY, String.class).orElse(openAPI.getInfo().getVersion());
+        validateApplicationVersion(applicationVersion);
+        descriptor.setVersion(applicationVersion);
         descriptor.setResourceType(getResourceTypeFromRestResource(restResource));
         descriptor.setDescription(config.getOptionalValue(APPLICATION_DESCRIPTION_PROPERTY, String.class)
                 .orElse(openAPI.getInfo().getDescription()));

service/quarkus/deployment/src/test/java/ai/timefold/solver/service/quarkus/deployment/ApplicationVersionValidationTest.java

@@ -0,0 +1,36 @@
+package ai.timefold.solver.service.quarkus.deployment;
+
+import static ai.timefold.solver.service.quarkus.deployment.TimefoldModelDescriptorProcessor.validateApplicationVersion;
+import static org.assertj.core.api.Assertions.assertThatCode;
+import static org.assertj.core.api.Assertions.assertThatThrownBy;
+
+import org.junit.jupiter.api.Test;
+
+class ApplicationVersionValidationTest {
+
+    @Test
+    void validVersionDoesNotThrow() {
+        assertThatCode(() -> validateApplicationVersion("v1")).doesNotThrowAnyException();
+    }
+
+    @Test
+    void nullVersionThrows() {
+        assertThatThrownBy(() -> validateApplicationVersion(null))
+                .isInstanceOf(IllegalArgumentException.class)
+                .hasMessageContaining("timefold.application.version");
+    }
+
+    @Test
+    void emptyVersionThrows() {
+        assertThatThrownBy(() -> validateApplicationVersion(""))
+                .isInstanceOf(IllegalArgumentException.class)
+                .hasMessageContaining("timefold.application.version");
+    }
+
+    @Test
+    void blankVersionThrows() {
+        assertThatThrownBy(() -> validateApplicationVersion("   "))
+                .isInstanceOf(IllegalArgumentException.class)
+                .hasMessageContaining("timefold.application.version");
+    }
+}