NCGS Environmental Education Workflow

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

An environmental education session at a host site covering one or more sites: curriculum elements taught, attendance counted by audience type, accountable adults as agent roles, the attendance register anchored and never transcribed (ADR-0007). Not gated by determination or agreement status; a school on withheld ground may host a workshop about why its grassland was left alone.

flowchart TB
    ed_s1["Plan the session"]
    ed_s2["Deliver and register"]
    ed_s3["Records complete"]
    ed_s1 --> ed_s2
    ed_s2 --> ed_s3

  1. Plan the session
  2. Deliver and register
  3. Records complete

1. Plan the session

Host site, covered sites, date, facilitator and curriculum elements agreed; the audience invited.

Prerequisite checks

The site exists on the platform with a urn:uuid identity

Smart function check.

Completion checks

EducationSessionPlanShape

SHACL shape.

  • A planned session covers its host site.

Step detail

Questions asked: NCGS education-session questions

2. Deliver and register

The session is held; attendance is counted by audience type and signed on the register; adults who will steward trees are recorded as agent roles; the register and a photograph are anchored.

Prerequisite checks

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).

AudienceCountShape

SHACL shape.

  • An audience count is a whole number of people, never a name.
  • An audience count names exactly one audience type from the scheme.
  • 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 session or its counts: properties from the schema.org or FOAF vocabularies (names, contact details) are refused (ADR-0007).

EducationSessionRecordShape

SHACL shape.

  • A session carries at least the attendance register and a photograph.
  • A session counts its attendance by audience type.
  • A session covers at least one site: the host, and every site whose stewards or owners attended.
  • A session has exactly one date.
  • A session is hosted at exactly one site.
  • A session names exactly one facilitator, as an agent IRI and a role (ADR-0007).
  • A session record names exactly one observer by IRI, never a literal (ADR-0004, ADR-0007).
  • A session record records exactly one environmental education activity.
  • A session teaches at least one curriculum element from the scheme; a session that taught nothing is not a session.
  • A session’s quiz sheets are quiz sheets: the correct answers of unnamed takers (ADR-0028).
  • An accountable adult attendee is an agent IRI and a role, never a name (ADR-0007).
  • A knowledge check is recorded as anonymous quiz sheets with the items asked, from which the mean scores are derived at load (ADR-0028); a session made before quiz sheets states the items asked with both means. Never an identified individual’s score.
  • A session anchors its signed attendance register as an evidence item; names stay in the register, only its content address enters the record (ADR-0007).
  • A session carries a geotagged photograph of the session (a site photograph with latitude and longitude).
  • A session counts each audience type at most once.
  • A session’s attendance counts add up to more than zero; a session nobody attended is not a session.
  • An accountable adult attendee recorded as an agent is a steward, owner or site manager; learners are counted, never identified (ADR-0007).
  • 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 session or its counts: properties from the schema.org or FOAF vocabularies (names, contact details) are refused (ADR-0007).
  • The facilitator of a session is the implementing partner or a fieldworker.
  • The sites a session covers include its host site.

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).

M009QuantitativeApplicabilityShape

SHACL shape.

  • NCGS-M009: a knowledge check reports items asked and both means, or nothing.
  • NCGS-M009: attendance summed over audience types is above zero.

M009SemanticApplicabilityShape

SHACL shape.

  • NCGS-M009: a session enters the counts only with at least one curriculum element from the scheme, a signed attendance register and a photograph.

The attendance register and the photograph carry content addresses (anchoring is the platform’s to confirm)

Smart function check.

Step detail

Questions asked: NCGS education-session questions

3. Records complete

Terminal: the session is a counted activity; every planted site it covers is now covered by education.

Prerequisite checks

Completion checks

This session is recorded and every site with a planting record in the register is covered by at least one session (the coverage rule)

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.

This page explains the standard and does not decide conformance: only the released corpus does. It describes dataRequirements/process-graphs/education-process.ttl, dataRequirements/shape2form/workflows/education.yaml, questionRegister/question-register.jsonld at standard version 0.7.0-dev.