Introduce ontology term concept for service API (#1124)

Adds records for OntologyTerm and CURIE.

Changes the record API for experiment description
to use the introduced concepts.

Author: sven1103

project-management/src/main/java/life/qbic/projectmanagement/application/api/AsyncProjectService.java

@@ -1,11 +1,14 @@
 package life.qbic.projectmanagement.application.api;
 
 import static java.util.Objects.nonNull;
+import static java.util.Objects.requireNonNull;
 
+import java.net.URI;
 import java.nio.ByteBuffer;
 import java.util.Collection;
 import java.util.List;
 import java.util.Map;
+import java.util.Objects;
 import java.util.Optional;
 import java.util.Set;
 import java.util.UUID;
@@ -179,6 +182,7 @@ Flux<ByteBuffer> roCrateSummary(String projectId)
    * <p>
    * Exceptions are wrapped as {@link Mono#error(Throwable)} and are one of the types described in
    * the throw section below.
+   *
    * @param projectId the identifier of the project to get the experiments for
    * @return a {@link Flux} of {@link ExperimentDescription}. Exceptions are provided as
    * {@link Mono#error(Throwable)}.
@@ -624,8 +628,8 @@ record ExperimentalGroups(List<ExperimentalGroup> experimentalGroups) implements
    *                       containing CURIEs.
    * @since 1.9.0
    */
-  record ExperimentDescription(String experimentName, Set<String> species, Set<String> specimen,
-                               Set<String> analytes) implements ExperimentUpdateRequestBody,
+  record ExperimentDescription(String experimentName, Set<OntologyTerm> species, Set<OntologyTerm> specimen,
+                               Set<OntologyTerm> analytes) implements ExperimentUpdateRequestBody,
       ExperimentUpdateResponseBody {
 
     public ExperimentDescription {
@@ -765,6 +769,35 @@ record ExperimentUpdateResponse(String experimentId, ExperimentUpdateResponseBod
    */
   record ProjectCreationRequest(ProjectDesign design, ProjectContacts contacts,
                                 FundingInformation funding) {
+  }
+
+  /**
+   * Represents an ontology term definition with a simple label that can be used to display the term
+   * for humans, its assigned OBO identifier and its globally unique identifier.
+   *
+   * @param label an {@link OntologyTerm} label for visualisation
+   * @param oboId the assigned OBO identifier
+   * @param id    the globally unique identifier of the term
+   * @since 1.10.0
+   */
+  record OntologyTerm(String label, Curie oboId, URI id) {
+    public OntologyTerm {
+      requireNonNull(oboId);
+      requireNonNull(id);
+    }
+  }
+
+  /**
+   * Represents a CURIE in the format <code>IDSPACE:LOCALID</code>.
+   * <p>
+   * Example: <code>GO:0008150</code>
+   *
+   * @param idSpace the id space defined that holds a set of local identifiers unique within a
+   *                space
+   * @param localId the local id which is unique within the space
+   * @since 1.10.0
+   */
+  record Curie(String idSpace, String localId) {
 
   }