flowchart TB
st_s1["Care event"]
st_s2["Record the care"]
st_s3["Verified at next visit"]
st_s1 --> st_s2
st_s2 --> st_s3
NCGS Stewardship Workflow
Care of tree individuals between monitoring visits, by whoever performs it: the observer role sets the evidence bar (ADR-0004), self-reports arrive through WhatsApp, and care is verified against the next observation of the tree rather than reviewed one record at a time. Delivered-only trees may be cared for; their care enters history, never a survival rate (ADR-0003).
1. Care event
Trees or a whole site watered, mulched, pruned, painted, protected or weeded.
Prerequisite checks
Every tree named exists (planting record or consignment) and stands at the record’s site
Smart function check.
Completion checks
CaredForTreeShape
SHACL shape.
- A cared-for tree entry names exactly one tree individual.
- 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).
- 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).
Step detail
No form is filled in at this step.
2. Record the care
Actions, watering volume and source, performer in role, and a photograph where the observer is the implementing partner.
Prerequisite checks
The evidence bar of the observer role is met: a fieldworker or supervisor has a geotagged photograph with a content address; a steward or owner needs none
Smart function check.
Completion checks
AgentRoleShape
SHACL shape.
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).
An agent role must carry exactly one role from the NCGS stakeholder-roles scheme.
An agent role must reference exactly one agent by IRI (ADR-0007: never a literal).
Instance data must not use the standard’s namespace https://nova.org.za/ncgs/ (ADR-0002: instances are urn:uuid: IRIs).
EvidenceItemShape
SHACL shape.
- A document tag is the UUID printed on the document’s QR sticker, at most one.
- An evidence item must carry exactly one content address. The anchor syntax is fixed by the platform binding profile in force.
- An evidence item must carry exactly one type from the NCGS evidence-types scheme.
- A photograph used as evidence must carry a geotag (photo latitude and longitude).
StewardshipRecordShape
SHACL shape.
- A care event has exactly one date.
- A care event names exactly one performer, as an agent IRI and a role (ADR-0007).
- A care event performs at least one care action from the scheme.
- A stewardship record is at exactly one site.
- A stewardship record names exactly one observer by IRI, never a literal (ADR-0004, ADR-0007).
- A stewardship record names the observer’s role; the role sets the evidence bar (ADR-0004).
- A stewardship record records exactly one stewardship activity.
- Each tree cared for is an entry naming the tree and its offset.
- 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.
M008QuantitativeApplicabilityShape
SHACL shape.
- NCGS-M008: a care record performs at least one action.
- NCGS-M008: every cared-for tree entry carries its offset in days from the tree’s anchor, so that persistence can be counted per horizon.
M008SemanticApplicabilityShape
SHACL shape.
- NCGS-M008: a care record enters the counts only when every tree it names exists (planting record or consignment) and stands at the record’s site.
- NCGS-M008: every care action is a concept in the care-actions scheme.
Step detail
Questions asked: NCGS stewardship questions
3. Verified at next visit
Terminal: the next monitoring visit’s observation of each cared-for tree is consistent with the care recorded (mulch cover after mulching, soil moisture after watering, stem paint after painting), or the record stands as unverified self-report.
Prerequisite checks
Completion checks
The next observation of each cared-for tree is consistent with the care recorded, or no later observation exists yet
Smart function check.
Step detail
No form is filled in at this step.
Review requirements
No review requirement in the corpus names a record this workflow produces.