Lexicon Garden

org.hypercerts.vocab.tag

A reusable vocabulary term for classifying any Hypercerts record — for example a land-cover class, a zone role, or a methodology. The vocabulary is domain-general; geospatial categories are simply its first entries. The schema carries portable term data; named vocabulary profiles decide which published terms and attachment points they recognize. Recommended record key: the deterministic form <category>.<key> (for example zone-role.site), as defined by the governing vocabulary profile; Lexicon validation cannot bind a record key to body fields, so writers and indexers enforce that agreement. A tag reference pins the specific version (CID) of the term that the referencing record classified against; consumers resolve the term's current status and supersession by its URI.

Repository @hypercerts.org did:plc:s4puetfspot742ai7y4otuel namespace authority
Details · record, key any
Kindrecord
Record keyany
Authorityvocab.hypercerts.org
Indexed
Compare Edit in builder → Fork →

Record

record · key any

Properties

aliases

array

Alternative human-readable labels and abbreviations for search and display. Aliases carry no identity: references always point at the record, not at a label.

  • maxLength: 50
itemsstring
  • maxLength: 200

broader

array

Optional references to directly broader terms, forming a polyhierarchy (a term may have several broader terms). Each referenced record must conform with org.hypercerts.vocab.tag.

  • maxLength: 20
itemsref
Reference

category

requiredstring · record-key

The classification axis this term belongs to, for example land-cover or zone-role. One term belongs to one category; a subject may carry tags from many categories at once. Values beyond the known set are permitted. Must not contain dots, so that the recommended <category>.<key> record key remains unambiguous.

  • maxLength: 50
  • knownValues: zone-role | land-cover | ecosystem-type | stratum-class | tenure | methodology | outcome-class | evidence-type

createdAt

requiredstring · datetime

Client-declared timestamp when this record was originally created.

description

string

Definition and scope notes for the term, written so a reader outside the publishing organization can apply it consistently.

  • maxLength: 10000
  • maxGraphemes: 1000

key

requiredstring · record-key

Stable lowercase machine identifier for this term within its publisher and category, for example boundary or mangrove. Must not contain dots, so that the recommended <category>.<key> record key remains unambiguous.

  • maxLength: 120

name

requiredstring

Human-readable display name of the term.

  • maxLength: 200

referenceDocument

union

A document defining or motivating this term, as a URI or an attached small blob.

One of

sameAs

array

URIs of exactly equivalent concepts in external vocabularies, for example ENVO, IUCN GET, OSM tag conventions, or registry methodology identifiers. Exact matches only; typed broader/narrower/close mappings are a named future field.

  • maxLength: 20
itemsstring · uri

signatures

ref

Optional cryptographic signatures attesting to this record's content.

Reference

status

requiredstring

Lifecycle status of the term: proposed (submitted, not yet governed), accepted (in active governed use), or deprecated (retired; see supersededBy). Values beyond the known set are permitted.

  • maxLength: 20
  • knownValues: proposed | accepted | deprecated

supersededBy

ref

The replacement term for a deprecated term, letting consumers roll classifications forward without rewriting published records. The referenced record must conform with org.hypercerts.vocab.tag.

Reference

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • org.hypercerts.workscope.tag

    record

    A reusable scope atom for work scope logic expressions. Scopes can represent topics, languages, domains, deliverables, methods, regions, tags, or other categorical labels. Tags are composed into structured expressions via CEL (Common Expression Language) on activity records.

  • org.hypercerts.helper.workScopeTag

    record

    A reusable scope atom for work scope logic expressions. Scopes can represent topics, languages, domains, deliverables, methods, regions, tags, or other categorical labels.

  • org.hypercerts.entity.feature

    record

    A record for a non-agent subject that other records (measurements, evaluations, etc.) can be about, for example a land zone or an ecological stratum. It carries the subject's identity, classification, and optional published spatial representations. Geometry lives in app.certified.location records; grouping lives in org.hypercerts.collection records.