feat: add title+desc to schemas derived for specs via annotation scan

modules/commons/src/main/java/it/smartcommunitylabdhub/commons/models/enums/EntityName.java

@@ -4,7 +4,6 @@
 import lombok.ToString;
 import org.springframework.util.Assert;
 
-//
 @Getter
 @ToString
 public enum EntityName {
@@ -18,7 +17,8 @@ public enum EntityName {
     MODEL("model"),
     TASK("task"),
     RUN("run"),
-    LOG("log");
+    LOG("log"),
+    METADATA("metadata");
 
     private final String value;
 

modules/commons/src/main/java/it/smartcommunitylabdhub/commons/models/metadata/AuditMetadata.java

@@ -2,7 +2,9 @@
 
 import com.fasterxml.jackson.annotation.JsonFormat;
 import com.fasterxml.jackson.annotation.JsonInclude;
+import it.smartcommunitylabdhub.commons.annotations.common.SpecType;
 import it.smartcommunitylabdhub.commons.models.base.BaseSpec;
+import it.smartcommunitylabdhub.commons.models.enums.EntityName;
 import java.io.Serializable;
 import java.time.OffsetDateTime;
 import java.util.Map;
@@ -18,6 +20,7 @@
 @Getter
 @Setter
 @JsonInclude(JsonInclude.Include.NON_NULL)
+@SpecType(kind = "metadata.audit", entity = EntityName.METADATA)
 public final class AuditMetadata extends BaseSpec implements Metadata {
 
     protected String createdBy;

modules/commons/src/main/java/it/smartcommunitylabdhub/commons/models/metadata/BaseMetadata.java

@@ -2,7 +2,9 @@
 
 import com.fasterxml.jackson.annotation.JsonFormat;
 import com.fasterxml.jackson.annotation.JsonInclude;
+import it.smartcommunitylabdhub.commons.annotations.common.SpecType;
 import it.smartcommunitylabdhub.commons.models.base.BaseSpec;
+import it.smartcommunitylabdhub.commons.models.enums.EntityName;
 import java.io.Serializable;
 import java.time.OffsetDateTime;
 import java.util.Map;
@@ -19,6 +21,7 @@
 @Getter
 @Setter
 @JsonInclude(JsonInclude.Include.NON_NULL)
+@SpecType(kind = "metadata.base", entity = EntityName.METADATA)
 public final class BaseMetadata extends BaseSpec implements Metadata {
 
     protected String project;

modules/commons/src/main/java/it/smartcommunitylabdhub/commons/models/metadata/EmbeddableMetadata.java

@@ -1,7 +1,9 @@
 package it.smartcommunitylabdhub.commons.models.metadata;
 
 import com.fasterxml.jackson.annotation.JsonInclude;
+import it.smartcommunitylabdhub.commons.annotations.common.SpecType;
 import it.smartcommunitylabdhub.commons.models.base.BaseSpec;
+import it.smartcommunitylabdhub.commons.models.enums.EntityName;
 import java.io.Serializable;
 import java.util.Map;
 import lombok.AllArgsConstructor;
@@ -16,6 +18,7 @@
 @Getter
 @Setter
 @JsonInclude(JsonInclude.Include.NON_NULL)
+@SpecType(kind = "metadata.embedded", entity = EntityName.METADATA)
 public final class EmbeddableMetadata extends BaseSpec implements Metadata {
 
     private Boolean embedded;

modules/commons/src/main/java/it/smartcommunitylabdhub/commons/models/metadata/VersioningMetadata.java

@@ -1,7 +1,9 @@
 package it.smartcommunitylabdhub.commons.models.metadata;
 
 import com.fasterxml.jackson.annotation.JsonInclude;
+import it.smartcommunitylabdhub.commons.annotations.common.SpecType;
 import it.smartcommunitylabdhub.commons.models.base.BaseSpec;
+import it.smartcommunitylabdhub.commons.models.enums.EntityName;
 import java.io.Serializable;
 import java.util.Map;
 import lombok.AllArgsConstructor;
@@ -16,6 +18,7 @@
 @Getter
 @Setter
 @JsonInclude(JsonInclude.Include.NON_NULL)
+@SpecType(kind = "metadata.versioning", entity = EntityName.METADATA)
 public final class VersioningMetadata extends BaseSpec implements Metadata {
 
     protected String project;

modules/commons/src/main/java/it/smartcommunitylabdhub/commons/utils/SchemaUtils.java

@@ -9,18 +9,22 @@
 import com.github.victools.jsonschema.generator.SchemaGenerator;
 import com.github.victools.jsonschema.generator.SchemaGeneratorConfigBuilder;
 import com.github.victools.jsonschema.generator.SchemaVersion;
+import com.github.victools.jsonschema.generator.TypeScope;
 import com.github.victools.jsonschema.module.jackson.JacksonModule;
 import com.github.victools.jsonschema.module.jackson.JacksonOption;
 import com.github.victools.jsonschema.module.jakarta.validation.JakartaValidationModule;
 import com.github.victools.jsonschema.module.jakarta.validation.JakartaValidationOption;
 import com.github.victools.jsonschema.module.swagger2.Swagger2Module;
+import it.smartcommunitylabdhub.commons.annotations.common.SpecType;
 import it.smartcommunitylabdhub.commons.jackson.introspect.JsonSchemaAnnotationIntrospector;
 import it.smartcommunitylabdhub.commons.models.specs.Spec;
+import java.util.Optional;
 
 //TODO refactor into a factory
 public final class SchemaUtils {
 
     public static final String FIELDS_PREFIX = "fields.";
+    public static final String SPECS_PREFIX = "specs.";
 
     public static final SchemaGenerator GENERATOR;
 
@@ -77,12 +81,28 @@ public final class SchemaUtils {
             .withTitleResolver(titleFromNameResolver)
             .withDescriptionResolver(descriptionFromNameResolver);
 
+        configBuilder
+            .forTypesInGeneral()
+            .withTitleResolver(specTypeResolver("title"))
+            .withDescriptionResolver(specTypeResolver("description"));
+
         GENERATOR = new SchemaGenerator(configBuilder.build());
     }
 
     public static JsonNode schema(Class<? extends Spec> clazz) {
         return GENERATOR.generateSchema(clazz);
     }
 
+    private static ConfigFunction<TypeScope, String> specTypeResolver(String value) {
+        return typeScope -> {
+            return Optional
+                .ofNullable(typeScope.getType().getErasedType().getAnnotation(SpecType.class))
+                .map(spec -> spec.kind())
+                .filter(s -> s != null)
+                .map(s -> SPECS_PREFIX + s + "." + value)
+                .orElse(null);
+        };
+    }
+
     private SchemaUtils() {}
 }