Tea Supply Chain Example

Here are examples of how different event types in the tea supply chain can be represented using the Winter Protocol metadata format:

Object Event (Green Leaf Phase)

{
  "name": "Green Tea",
  "version": 1.0,
  "creationDate": "2023-05-26T14:30:00Z",
  "eventType": "object",
  "eventId": "",
  "inputItems": [],
  "outputItems": [
    {
      "itemIdentifier": "<identifier>",
      "itemQuantity": 500,
      "unit": null
    }
  ],
  "metadata": [
    {
      "key": "Location",
      "value": "7.2905° N, 80.6337° E",
      "unit": null
    },
    {
      "key": "Elevation",
      "value": "1200",
      "unit": "meters"
    },
    {
      "key": "District",
      "value": "Nuwara Eliya",
      "unit": null
    },
    {
      "key": "Business Name",
      "value": "Green Hills Tea Estate",
      "unit": null
    },
    {
      "key": "Quality",
      "value": "Grade A",
      "unit": null
    },
    {
      "key": "Weight",
      "value": "500",
      "unit": "kilograms"
    },
    {
      "key": "Harvest Number",
      "value": "H001",
      "unit": null
    },
    {
      "key": "Harvest Date",
      "value": "2023-05-26T00:00:00Z",
      "unit": "ISO 8601"
    },
    {
      "key": "Pick-up Date",
      "value": "2023-05-27T00:00:00Z",
      "unit": "ISO 8601"
    },
    {
      "key": "Weight at Pick-up",
      "value": "495",
      "unit": "kilograms"
    },
    {
      "key": "Quality at Pick-up",
      "value": "Grade A",
      "unit": null
    },
    {
      "key": "Supplier Verification",
      "value": "true",
      "unit": null
    },
    {
      "key": "Factory Worker Final Check",
      "value": "true",
      "unit": null
    }
  ]
}

Aggregation Event (Batch Creation)

{
  "name": "Tea Batch",
  "version": 1.0,
  "creationDate": "2023-05-28T10:00:00Z",
  "eventType": "aggregation",
  "eventId": "",
  "inputItems": [
    {
      "itemIdentifier": "<identifier>",
      "itemEventId": "<tokenId>",
      "itemQuantity": 500,
      "unit": "kilograms"
    },
    {
      "itemIdentifier": "<identifier>",
      "itemEventId": "<tokenId>",
      "itemQuantity": 450,
      "unit": "kilograms"
    }
  ],
  "outputItems": [],
  "metadata": [
    {
      "key": "Batch Number",
      "value": "TB001",
      "unit": null
    },
    {
      "key": "Total Weight",
      "value": "950",
      "unit": "kilograms"
    }
  ]
}

Disaggregation Event (Batch Splitting)

{
  "name": "Tea Batch",
  "version": 1.0,
  "creationDate": "2023-05-28T10:00:00Z",
  "eventType": "aggregation",
  "eventId": "",
  "inputItems": [
    {
      "itemIdentifier": "<identifier>",
      "itemEventId": "<tokenId>",
      "itemQuantity": 500,
      "unit": "kilograms"
    }
  ],
  "outputItems": [
    {
      "itemIdentifier": "<identifier>",
      "itemQuantity": 300,
      "unit": null
    },
    {
      "itemIdentifier": "<identifier>",
      "itemQuantity": 200,
      "unit": null
    }
  ],
  "metadata": [
    {
      "key": "Batch Number",
      "value": "TB001",
      "unit": null
    },
    {
      "key": "Total Weight",
      "value": "950",
      "unit": "kilograms"
    }
  ]
}

Transformation Event (Tea Processing)

{
  "name": "Processed Tea",
  "version": 1.0,
  "creationDate": "2023-05-29T14:30:00Z",
  "eventType": "transformation",
  "eventId": "",
  "inputItems": [
    {
      "itemIdentifier": "<identifier>",
      "itemEventId": "<tokenId>",
      "itemQuantity": 950,
      "unit": "kilograms"
    }
  ],
  "outputItems": [
    {
      "itemIdentifier": "<identifier>",
      "itemQuantity": 900,
      "unit": "kilograms"
    }
  ],
  "metadata": [
    {
      "key": "Processing Method",
      "value": "CTC",
      "unit": null
    },
    {
      "key": "Processing Date",
      "value": "2023-05-29T00:00:00Z",
      "unit": "ISO 8601"
    }
  ]
}

Association Event (Warehouse Storage)

{
  "name": "Warehouse Storage",
  "version": 1.0,
  "creationDate": "2023-05-30T09:00:00Z",
  "eventType": "association",
  "eventId": "",
  "inputItems": [
    {
      "itemIdentifier": "<identifier>",
      "itemEventId": "<tokenId>",
      "itemQuantity": 900,
      "unit": "kilograms"
    },
    {
      "itemIdentifier": "<identifier>",
      "itemEventId": "<tokenId>",
      "itemQuantity": 100,
      "unit": null
    }
  ],
  "outputItems": [],
  "metadata": [
    {
      "key": "Warehouse ID",
      "value": "WH001",
      "unit": null
    },
    {
      "key": "Storage Location",
      "value": "Shelf A1",
      "unit": null
    },
    {
      "key": "Storage Date",
      "value": "2023-05-30T00:00:00Z",
      "unit": "ISO 8601"
    }
  ]
}

Transaction Event (Tea Sale)

{
  "name": "Tea Sale",
  "version": 1.0,
  "creationDate": "2023-06-05T14:00:00Z",
  "eventType": "transaction",
  "eventId": "",
  "inputItems": [
    {
      "itemIdentifier": "<identifier>",
      "itemEventId": "<tokenId>",
      "itemQuantity": 500,
      "unit": "kilograms"
    }
  ],
  "outputItems": [
    {
      "itemIdentifier": "<identifier>",
      "itemEventId": "<tokenId>",
      "unit": "kilograms"
    }
  ],
  "metadata": [
    {
      "key": "Buyer",
      "value": "ABC Company",
      "unit": null
    },
    {
      "key": "Sale Price",
      "value": "10000",
      "unit": "USD"
    },
    {
      "key": "Sale Date",
      "value": "2023-06-05T14:00:00Z",
      "unit": "ISO 8601"
    }
  ]
}

These examples demonstrate how the Winter Protocol metadata format can be used to capture and represent different events in the tea supply chain. The object event represents the harvesting of green tea leaves by suppliers, capturing relevant details such as location, quality, weight, and harvest information. The aggregation and disaggregation events represent the creation and splitting of tea batches, respectively. The transformation event represents the processing of the harvested tea leaves into finished tea products. It includes information about the processing method and date. The association event represents the storage of processed tea in a warehouse, capturing details about the storage location and date. Finally, the transaction event represents the sale of the processed tea to buyers, including details about the buyer, sale price, and sale date.

See IPFS endpoint for submitting metadata