[Fix apache#4125] Avoid duplicate titles on schema (apache#4134)

Also fixes
apache#4124 and
apache#4123

Signed-off-by: fjtirado <[email protected]>

Author: fjtirado

kogito-codegen-modules/kogito-codegen-processes/src/main/resources/class-templates/RestResourceQuarkusTemplate.java

@@ -46,6 +46,10 @@
 
 import org.eclipse.microprofile.openapi.annotations.Operation;
 import org.eclipse.microprofile.openapi.annotations.tags.Tag;
+import org.eclipse.microprofile.openapi.annotations.responses.APIResponse;
+import org.eclipse.microprofile.openapi.annotations.media.Content;
+import org.eclipse.microprofile.openapi.annotations.media.Schema;
+
 import org.jbpm.util.JsonSchemaUtil;
 import org.kie.kogito.process.Process;
 import org.kie.kogito.process.ProcessInstance;
@@ -55,6 +59,7 @@
 import org.kie.kogito.auth.SecurityPolicy;
 
 @Path("/$name$")
+@Tag(name = "Process - $name$", description = "$documentation$")
 public class $Type$Resource {
 
     Process<$Type$> process;
@@ -68,7 +73,9 @@ public class $Type$Resource {
     @POST
     @Produces(MediaType.APPLICATION_JSON)
     @Consumes(MediaType.APPLICATION_JSON)
-    @Operation(summary = "$documentation$", description = "$processInstanceDescription$")
+    @Operation(operationId = "createProcessInstance_$name$", summary = "$documentation$", description = "$processInstanceDescription$")
+    @APIResponse(responseCode = "400", description = "Bad param")
+    @APIResponse(responseCode = "201", description = "Process instance created", content={@Content(schema=@Schema(implementation=$Type$Output.class))})
     public Response createResource_$name$(@Context HttpHeaders httpHeaders,
                                           @Context UriInfo uriInfo,
                                           @QueryParam("businessKey") @DefaultValue("") String businessKey,

quarkus/extensions/kogito-quarkus-serverless-workflow-extension/kogito-quarkus-serverless-workflow-deployment/src/main/java/org/kie/kogito/serverless/workflow/parser/schema/OpenApiModelSchemaGenerator.java

@@ -96,7 +96,9 @@ private static boolean useTitle() {
     }
 
     private static Schema createOutputSchema(Schema schema) {
-        return OASFactory.createSchema().addProperty("workflowdata", schema).addProperty("id", ID_SCHEMA).title(schema.getTitle());
+        String schemaTitle = schema.getTitle();
+        schema.setTitle(schemaTitle + "_workflowdata");
+        return OASFactory.createSchema().addProperty("workflowdata", schema).addProperty("id", ID_SCHEMA).title(schemaTitle);
     }
 
     public static void mergeSchemas(OpenAPI targetSchema, Map<String, Schema> schemas, Map<String, Schema> defsSchemas) {