Update the API flow

Signed-off-by: Olle E. Johansson <oej@edvina.net>

Author: oej

api-flow/consumer.md

@@ -8,9 +8,11 @@ described in the [discovery document](/discovery/readme.md).
 
 The standard TEI points to a product.
 
-- __List of TEA Components__: Components are components of something sold. Each Component has it's own versioning and it's own set of artefacts. Note that a single artefact can belong to multiple versions of a Component and multiple Components.
-- __List of TEA collections__: For each Component, there is a list of TEA collections as indicated by release date and a version string. The TEA API has no requirements of type of version string (semantic or any other scheme) - it's just an identifier set by the manufacturer. It's sorted by release date as a default.
-- __List of TEA artefacts__: The collection is unique for a version and contains a list of artefacts. This can be SBOM files, VEX, SCITT, IN-TOTO or other documents.
+- __TEA Product__: This is the delivered goods, an open source software, library or a product sold. It consists of one or multiple TEA Components.
+- __TEA Components__: Components are components of something sold. Each Component has it's own versioning and it's own set of artefacts. Note that a single artefact can belong to multiple versions of a Component and multiple Components.
+- __TEA Component index__: A list of all the versions available for a TEA Component
+- __TEA Collection__: For each Component version, there is TEA collection as indicated by release date and a version string. The TEA API has no requirements of type of version string (semantic or any other scheme) - it's just an identifier set by the manufacturer. It's sorted by release date as a default.
+- __List of TEA artefacts__: The TEA Collection is unique for a version and contains a list of artefacts. This can be SBOM files, VEX, SCITT, IN-TOTO or other documents.
 - __List of artefact formats__: An artefact can be published in multiple formats.
 
 The user has to know product TEI and version of each component (TEA Component) to find the list of artefacts for the used version.
@@ -37,10 +39,10 @@ sequenceDiagram
     user ->> discovery: Discovery using DNS
     discovery ->> user: List of API servers
 
-    user ->> tea_product: Finding all product parts
+    user ->> tea_product: Finding all product parts (TEA Components) and facts about the product
     tea_product ->> user: List of product parts
 
-    user ->> tea_component: Finding all versions of a part
+    user ->> tea_component: Finding all versions of a TEA Component
     tea_component ->> user: List of all available versions (paginated)
 
     user ->> tea_collection: Finding all artefacts for version in scope