Stewardship record

Pre-release. This site describes standard version 0.7.0-dev, which is in development and may change before version 1.0.0.

The record of one care event: the site, the trees cared for or the whole site, the date, the care actions performed, watering volume and source where water was given, the performer as an agent in a role (ADR-0007), capture provenance and evidence to the bar of the observer role (ADR-0004). An activity record, never an observation: it carries no tree state (ADR-0005).

Properties

Property Required Repeatable Value Message
capture channel yes no NCGS Capture Channels: Dedicated app, WhatsApp flow, Paper, transcribed
care action yes yes NCGS Care Actions: Watering, Mulching, Pruning, Fertilising or composting, Stem painting, Stake replacement, Guard or fence repair, Weeding, Pest control, Watering-basin repair A care event performs at least one care action from the scheme.
care date yes no date A care event has exactly one date.
cared for no yes Cared-for tree Each tree cared for is an entry naming the tree and its offset.
device latitude yes no decimal
device longitude yes no decimal
has evidence no yes Evidence item
observed at yes no dateTime
observer yes no Agent A stewardship record names exactly one observer by IRI, never a literal (ADR-0004, ADR-0007).
observer role yes no NCGS Observer Roles: Fieldworker, Supervisor, Steward, Owner A stewardship record names the observer’s role; the role sets the evidence bar (ADR-0004).
performer yes no Agent role A care event names exactly one performer, as an agent IRI and a role (ADR-0007).
records activity yes no Stewardship activity A stewardship record records exactly one stewardship activity.
records site yes no Site A stewardship record is at exactly one site.
water source no no NCGS Water Sources: Municipal tap, Borehole, Rainwater tank, Tank filled by truck, Household greywater, River, dam or stream, Not watered
water source, other no no string
watering volume no no NCGS Watering Volumes: Less than 20 litres (under one bucket), 20 to 40 litres (one to two buckets), More than 40 litres (over two buckets)
whole site no no boolean

Also required of other records: Restatement

Property Required Repeatable Value Message
restatement reason no no string
restates no no any value A record restates at most one earlier record (ADR-0018).

Rules

  • A record moves to another site only by a supervisor’s or an office analyst’s correction in one role, observed at one zoned time, to a registered site current when it moves, and with each thing its restatement group introduced before it withdrawn or replaced by the move or a correction before it (ADR-0027).
  • A restatement is a record of the same type as the record it restates (ADR-0018).
  • A restatement is about the same site as the record it restates, or follows in its restatement group, unless a supervisor’s or an office analyst’s correction moves it (ADR-0018, ADR-0027).
  • A restatement is observed after the record it restates: it is the later observation that governs (ADR-0018).
  • A restatement says why the fact is restated, in a sentence or more (ADR-0018).
  • A site registration never moves: its correction registers the site its original registered, and a site registered in error is replaced (ADR-0027).
  • A care event is an activity, never an observation: alive, condition, cause of death, mulch cover, soil moisture, canopy and stem measurements belong to a tree observation on a monitoring visit (ADR-0005).
  • A care event names the trees cared for or declares that it covered the whole site; it cannot do neither, and a whole-site event names no trees.
  • A care event recorded by a fieldworker or supervisor carries a geotagged photograph; a steward’s or owner’s self-report need not (ADR-0004).
  • A water source is a concept or, for an Other answer, the respondent’s words (ncgs:waterSourceOther), never both.
  • A watering event records the volume and the source: a water-source concept, or for an Other answer the source in the respondent’s words (ncgs:waterSourceOther).
  • Every tree cared for stands at the record’s site, at a position of the site or through a consignment handed over there.
  • Instance data must not use the standard’s namespace https://nova.org.za/ncgs/ (ADR-0002: instances are urn:uuid: IRIs).
  • No personal data rides on a care event: properties from the schema.org or FOAF vocabularies are refused (ADR-0007).
  • The performer of a care event is a steward, an owner or a fieldworker.
  • Watering volume and source are recorded only when watering is among the actions performed.

Checked by

Cared-for tree

One tree individual in a stewardship record, with the offset in days from its anchor (planting date, else its consignment’s delivery date) at the care date (ADR-0010).

Properties

Property Required Repeatable Value Message
offset from anchor (days) yes no integer A cared-for tree entry records the offset in days from the tree’s anchor (planting date, else its consignment’s delivery date), written by the offset operation, never asked (ADR-0023).
tree cared for yes no Tree individual A cared-for tree entry names exactly one tree individual.

Rules

  • A cared-for tree must exist: it has a planting record or comes from a consignment (ADR-0003).
  • Instance data must not use the standard’s namespace https://nova.org.za/ncgs/ (ADR-0002: instances are urn:uuid: IRIs).

Checked by

This page explains the standard and does not decide conformance: only the released corpus does. It describes ontology/ncgs-ontology.ttl, dataRequirements/common-shapes.ttl, dataRequirements/stewardship-shapes.ttl, methodologies/applicability-shapes.ttl at standard version 0.7.0-dev.