23 March 2022 GRSF traceability unit¶
Discussing the concept and its implementation with FishSource, FORTH and FAO.
Participants:
FAO (Aureliano Gentile)
FishSource (Merul Patel, Patricia Amorim, Susana Segurado)
FORTH (Yannis Marketakis)
Meeting Notes¶
Key points¶
The meeting discussed the possible implementation of the concept Traceability Unit for the GRSF.
A concept note was developed: GoogleDoc https://docs.google.com/document/d/1TSZ8Wvnns_LSN8QLcdxW9vQKVTgnxD7uC30c1JgEQ-A/edit#heading=h.de3c2tgh0qtu
The proposed traceability unit semantic ID is structured as follows:
Species + Assessment Area(s) + Management Authority(ies) + Management or Reporting Area(s) + Flag State + Gear type
e.g. asfis:HAD + FAO: 27.4, 27.6.a, 27.3.a.20 + authority:INT:EC, NEAFC + eu: HAD/5BC6A + iso3:ESP+isscfg:OTB
The Species + Assessment Area(s) combination must be present and identically defined in the existing Stock catalogue (the Assessment Unit type). The field ‘Management or Reporting Area(s)’ is defined as a unique unit where the management authorities are setting distinct measures impacting the stock, such as a catch limit. Management or Reporting Area(s) is the fishing area code entered in the FishSource fishery records.
Therefore, a Traceability Unit will be identified by a:
i) single immutable identifier (i.e. UUID)
ii) semantic identifier
iii) unique resolver assigned per traceability unit (i.e. a URL)
In the GRSF knowledge Base, a Traceability unit is made of two connected records (Assessment Unit + Fishing Unit) and flagged for traceability.
The flag "Traceability" will be retained in the GRSF because there can be cases in which a fishery is eligible for traceability purposes (hence it is flagged) but might not have its counterpart (an assessment unit), hence a Traceability Unit cannot be defined.
Within the Stock category, where no assessment is conducted, a ‘type’ Marine resource is defined. Fisheries conducted upon Marine Resources enter supply chains, so it is important that the model accommodates these types of Stocks within the traceability units. It is proposed that the semantic identifier of the Traceability Unit applies a unassessed in place of whatever area is indicated in the Marine Resource.
Example:
e.g. asfis:SNA + unassessed + authority:NAT: PHL + PHL: 5 + iso3:PHL+isscfg:LHH
GRSF Competency queries and APIs (Swagger documentation) will provide the Traceability Units for records which are connected and flagged in the GRSF. The connected records in FishSource will be automatically connected and flagged in the GRSF KB during the data harvesting process.
Actions¶
Following a first positive feedback on the proposal by FORTH these actions were agreed:
- FORTH to implement the records traceability units with UUIDs and semantic identifiers. The first implementation will be reviewed in a dedicated call for testing purposes (e.g. checking the competency queries) and for any refinements of the requirements.
- SFP to add UUID and semantic identifier in the API for approved records (e.g. https://www.fishsource.org/api/bluebridge/v5/stock/1764)
- FAO to liaise with CNR for implementing the resolver and the related UI in the GRSF CKan catalogue
- A new data harvest will take place on the 5th of April which will include new area codes for FishSource records.
Resources¶
- GRSF Github https://github.com/GRSF (species, country, gear and area vocabularies)
- Example of FishSource connected records/traceability units https://www.fishsource.org/stock_page/1764 (API https://www.fishsource.org/api/bluebridge/v5/stock/1764)
The latest exchanges on this matter are the following:
- GRSF Wiki - Additional requirements for fisheries traceability https://support.d4science.org/projects/stocksandfisherieskb/wiki/21-05-06-GRSF_pilotrelease
- GRSF Wiki - Outcomes of the FAO Seminar https://support.d4science.org/projects/stocksandfisherieskb/wiki/21-06-22-GRSF_webinar
- GRSF Wiki - Discussion Mr Braddock Spear - Ms Nada Bogouss: https://support.d4science.org/projects/stocksandfisherieskb/wiki/21-12-21-GRSF_traceability