# Use-case sample artefacts

**Illustrative, non-normative.** These artefacts exist to make the [use cases](https://untp.unece.org/docs/articles) concrete. They are not part of UNTP conformance testing and are not the canonical reference samples.

- For canonical, schema-validated, version-pinned credential samples, see `artefacts/samples/` (validated by `.claude/scripts/validate-artefacts.mjs`).
- These use-case artefacts track the current specification version and may be updated in place as the narratives change.
- Where a use case needs a standard credential (a DPP, DFR, DIA, DCC), it links to the canonical sample in `artefacts/samples/` rather than duplicating it here. This folder holds only the scenario "glue" that the canonical set does not cover, such as identity resolver link-set responses.

This whole tree is copied to the site under `/artefacts/use-case-samples/…` by `yarn copy-artefacts`, so files can be linked from use-case pages with `pathname:///artefacts/use-case-samples/…`.

## Scenarios

### `facility-data-once-discover-anywhere/`

Supports [Publish facility data once, discover it anywhere](https://untp.unece.org/docs/articles/facility-data-once-discover-anywhere).

| File | What it shows |
| --- | --- |
| `facility-resolver-linkset.json` | The facility resolver response for one factory (the resolver is hosted by the manufacturer's UNTP software provider, not by any register): a `dfr` link to the facility's Digital Facility Record, plus an `idr` link that redirects product-level queries to a secondary (product) resolver. Demonstrates one resolver pointing at another. |
| `product-resolver-linkset.json` | The product registry resolver response for one product: `dpp` links to the product's Digital Product Passport. |

Both link-sets follow the [UNTP linkset format](https://untp.unece.org/docs/specification/IdentityResolver#linkset-format) and are shaped to validate against `artefacts/schema/v0.7.0/idr/LinksetSchema.json`. The `dfr` and `dpp` targets point at the canonical samples in `artefacts/samples/`.