Clarify TEA product fields

Modifies the documentation of the TEA product and completes its JSON schema.

Signed-off-by: Piotr P. Karwasz <[email protected]>

Author: ppkarwasz

spec/product.md

@@ -29,13 +29,15 @@ same vendor.
 
 ## TEA Product object
 
+Schema: https://raw.githubusercontent.com/CycloneDX/transparency-exchange-api/refs/heads/main/spec/tea.schema.yaml#/$defs/product
+
 - __uuid__: A unique identifier for this product
-- __name__: Product name in clear text (str)
-- __identifiers__: A list of TEIs that apply to this product
-   - __type__: Type of identifier - one of "tei", "purl", or "cpe"
-   - __id__: The complete identifier (str)
-- __leaves__: A list of product leaves
-   - __uuid__: TEA LEAF UUID
+- __name__: Product name in clear text
+- __identifiers__: A list of identifiers that apply to this product
+   - __type__: Type of identifier, e.g., `cpe`, `purl`, or `tei`
+   - __id__: The complete identifier
+- __leaves__: A list of TEA Leaves
+   - __uuid__: The unique identifier of the TEA Leaf
 
 The TEA LEAF UUID is used in the LEAF API to find out which versions
 of the LEAF that exists.

spec/tea.schema.yaml

@@ -4,18 +4,60 @@
 title: Transparency Exchange API Schema
 description: Schema for the domain objects of the Transparency Exchange API
 "$defs":
+  #
+  # General types
+  #
   uuid:
     type: string
     description: A UUID
     pattern: "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
+  identifier_type:
+    type: string
+    description: Enumeration of identifiers types
+    enum:
+      - cpe
+      - tei
+      - purl
+  identifier:
+    type: object
+    description: An identifier with a specified type
+    properties:
+      type:
+        "$ref": "#/$defs/identifier_type"
+        description: Type of identifier, e.g., `cpe`, `purl`, or `tei`
+      id:
+        type: string
+        id: The complete identifier
+  #
+  # Domain objects
+  #
   product:
     type: object
+    title: TEA Product
     description: A TEA product
     properties:
       uuid:
         "$ref": "#/$defs/uuid"
+        description: A unique identifier for this product
+      name:
+        type: string
+        description: Product name in clear text
+      identifiers:
+        type: array
+        description: A list of identifiers that apply to this product
+        items:
+          "$ref": "#/$defs/identifier"
+      leaves:
+        type: array
+        description: A list of TEA Leaves
+        items:
+          "$ref": "#/$defs/uuid"
+          description: The unique identifier of the TEA Leaf
     required:
       - uuid
+      - name
+      - identifiers
+      - leaves
   leaf:
     type: object
     description: A TEA leaf