Skip to content

Fix some issues like Event modelling and create initial mappings to GS1, schema.org, IATA, FIBO

Steve CAPELL requested to merge vocab-improvements into main

External-vocabulary mappings + event refactor

This branch extends UNSCRO with normative mappings to five authoritative peer vocabularies, refactors the event model to defer to GS1 EPCIS, and improves the units tables. Every mapping is carried in-band as skos:Match (or rdfs:seeAlso where a UNSCRO property corresponds to a peer's class), and every decision, including terms deliberately left unmapped, is recorded in a methodology/source-analysis/-mapping.csv worksheet.

Mappings added

  • QUDT (units): 17 skos:exactMatch links for Rec 20 units the automatic QUDT join missed, with embedded conversion metadata. Units tables now also show the UCUM code and the quantity-kind group (replacing the previously empty broader column).
  • schema.org (core): 15 matches across foundational entities and value objects (Coordinate, Image, TradeDocument, Communication and their properties). Event and Facility left unmapped by design.
  • FIBO (finance): 7 skos:*Match on like-to-like terms (Payment, Account, FinanceAgreement, the amount properties) plus 4 rdfs:seeAlso for the party-role properties (payer, payee, financier, bank), since FIBO models those roles as classes.
  • IATA ONE Record (transport): 10 skos:closeMatch to air-cargo classes (movement, means, equipment, booking, consignment, package, item, leg, service, charge). Air-only conveyance and ONE Record gaps left unmapped.
  • GS1 (production): 6 skos:closeMatch split across GS1's two ontologies. Product and ProductPackage map to the GS1 Web Vocabulary; the lifecycle events map to GS1 EPCIS (MakeEvent → TransformationEvent, Move/Modify → ObjectEvent, LifecycleEvent → EPCISEvent).

Event refactor

Removed the reinvented Event / AggregationEvent / TransformationEvent from core. LifecycleEvent is now the root supertype of make/move/modify, and events defer to GS1 EPCIS rather than duplicating it. LetterOfCredit-style duplication was already retired; this continues that leaning-down.

Docs and tooling

  • Mappings page rewritten with a tiered register (Tier A semantic / Tier B structural) and a row per target; schema.org, QUDT, FIBO, ONE Record and GS1 all now hyperlinked.
  • CLAUDE.md external-match convention updated to name all five targets and point to the worksheets.
  • Domain-map SVG and its generator drop the stale "events" wording from the Core summary.
  • build-vocab-site.py renders the UCUM column, quantity-kind group, and rdfs:seeAlso.
  • Migration ledger reconciled.

All 8 validation gates pass; docs and resolvable-vocab sites rebuilt.

Merge request reports