Person
The standard states no data requirement for a person: a person appears only as an agent identifier in a role.
Agent role
A person or organisation in a stated capacity at a site: an agent IRI plus a role concept. The shape is closed so that no name, contact detail or other literal can be attached; the mapping from IRI to person lives in the implementing partner’s access-controlled people register.
Properties
| Property | Required | Repeatable | Value | Message |
|---|---|---|---|---|
| agent | yes | no | Agent | An agent role must reference exactly one agent by IRI (ADR-0007: never a literal). |
| role | yes | no | NCGS Stakeholder Roles: Funder, Implementing partner, Monitoring, reporting and verification partner, Standards body, Landowner, Site manager, Steward, Owner, Learner, Nursery, Government department, Municipality, Fieldworker, Supervisor, Reviewer, Office analyst | An agent role must carry exactly one role from the NCGS stakeholder-roles scheme. |
Rules
- An agent role carries only an agent IRI and a role. Names, contact details and other literals are personal data and belong in the people register, never in the graph (ADR-0007).
- Instance data must not use the standard’s namespace https://nova.org.za/ncgs/ (ADR-0002: instances are urn:uuid: IRIs).
Checked by
- NCGS Environmental Education Workflow:
AgentRoleShape - NCGS Project Registration Workflow:
AgentRoleShape - NCGS Stewardship Workflow:
AgentRoleShape - NCGS Tree Delivery Workflow:
AgentRoleShape
Roles
NCGS Stakeholder Roles
The capacity in which an agent relates to a site or programme. An agent appears in the graph only as an IRI and a role (ADR-0007).
NCGS Observer Roles
The capacity in which an observer acted. The single mechanism by which self-reported evidence is graded; methodologies demand a minimum role, never a separate shape (ADR-0004).
Enrolment
The record by which a person takes a role in a project or at a site: an agent identifier minted and bound to a role. The person’s details stay in the project’s people register off the graph (ADR-0007).
People register
The implementing partner’s access-controlled list, kept beside the project ledger, of everyone enrolled in a project: their register key or login, agent identifier, roles and the contact details the work needs. It reaches fieldworkers through the instrument’s cases; it is never part of the ledger or the NCGS graph, and an entry can be deleted on request (ADR-0007).