flowchart TB
ho_s1["Prepare the consignment"]
ho_s2["Deliver and acknowledge"]
ho_s3["Delivered and acknowledged"]
ho_s1 --> ho_s2
ho_s2 --> ho_s3
NCGS Tree Delivery Workflow
Custody of a consignment of trees passes to a recipient at a site. No tree individual is created; tags issued with the consignment are the bearers of identities trees will take when they become distinguishable (ADR-0002, ADR-0003). Delivery is not gated by the site’s assessment determination; planting is.
1. Prepare the consignment
Lines of species or cultivar, quantity and container size against the nursery delivery note; tags counted out.
Prerequisite checks
The site exists on the platform with a urn:uuid identity
Smart function check.
Completion checks
ConsignmentLineShape
SHACL shape.
- A consignment line carries a positive number of trees.
- A consignment line carries the number of living trees the recipient confirms having received; dead stock is never counted as delivered.
- A consignment line names exactly one species or cultivar from the register. There is no free-text other.
- A consignment line records the container size of its trees.
- A consignment line carries no tree state and no tree: alive, condition, care, cause of death, canopy or stem measurements belong to an observation of a tree individual, and tag, position and stratum to the tree itself, never to a delivery (ADR-0003). Any property whose domain is a tree state, tree individual or tree observation is refused.
- A species listed under NEMBA category 1a or 1b may never be handed over, whatever its approval status (ADR-0009).
- A withdrawn species or cultivar may not be handed over.
- Instance data must not use the standard’s namespace https://nova.org.za/ncgs/ (ADR-0002: instances are urn:uuid: IRIs).
- The living trees confirmed on a consignment line never outnumber the line’s trees.
- The species or cultivar on a consignment line must be a concept in the NCGS species scheme (no free-text other).
Step detail
No form is filled in at this step.
2. Deliver and acknowledge
The recipient, by identifier and role, signs; the stock is photographed; the tags issued are recorded.
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).
ConsignmentShape
SHACL shape.
- A consignment carries lines of species or cultivar, quantity and container size.
- A consignment has exactly one delivery date, the anchor of a delivered-only tree’s horizons.
- A consignment is delivered to exactly one site.
- A consignment names at most one recipient, as an agent IRI and a role (ADR-0007).
- A consignment names exactly one observer by IRI, never a literal (ADR-0004, ADR-0007).
- A consignment records exactly one tree delivery activity.
- A consignment’s evidence items are evidence items.
- A delivery is recorded by a fieldworker or supervisor.
- An issued tag identifier is a single token, the same form as a tree’s tag number.
- A consignment cannot yield more tree individuals than it carried: the trees referencing it never outnumber the trees in its lines (ADR-0003).
- A consignment carries a geotagged photograph of the stock at delivery.
- A consignment carries no tree state and no tree: alive, condition, care, cause of death, canopy or stem measurements belong to an observation of a tree individual, and species, tag, position and stratum to the tree itself, never to a delivery (ADR-0003). Any property whose domain is a tree state, tree individual or tree observation is refused.
- A consignment counts as delivered only with the recipient’s signed acknowledgement as an evidence item; a delivery nobody signed for is not a delivery.
- A consignment creates no tree individuals; a tree comes into being later, when it is tagged, planted or observed (ADR-0003).
- A consignment handed over names exactly one recipient, carries at least one line and at least two evidence items: the recipient’s acknowledgement and a photograph of the stock.
- A failed delivery attempt delivers no trees: it carries no line and issues no tag.
- Instance data must not use the standard’s namespace https://nova.org.za/ncgs/ (ADR-0002: instances are urn:uuid: IRIs).
- The recipient of a consignment is a landowner, site manager, steward, owner, government department, municipality or the implementing partner.
- The tags issued with a consignment never outnumber the trees in its lines (ADR-0003: a tag is the bearer of one tree’s identity).
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).
M011QuantitativeApplicabilityShape
SHACL shape.
- NCGS-M011: a consignment carries at least one line with a positive number of trees.
- NCGS-M011: the tags issued with a consignment never outnumber its trees (ADR-0003).
M011SemanticApplicabilityShape
SHACL shape.
- NCGS-M011: a consignment carries no tree-state field; delivery verification observes stock at the gate, never trees in the ground (ADR-0003).
- NCGS-M011: a consignment enters the delivery count only with the recipient’s acknowledgement and a recipient named by identifier and role.
- NCGS-M011: every line names a species or cultivar in the NCGS species scheme, so that trees delivered can be sliced by species.
Step detail
Questions asked: NCGS handover questions
3. Delivered and acknowledged
Terminal for the delivered-only stratum: the consignment supports the outputs trees delivered and acknowledged, and nothing downstream. A consignment to the implementing partner continues in the planting workflow.
Prerequisite checks
Completion checks
The consignment is delivered and acknowledged: its acknowledgement and stock photograph carry content addresses (anchoring and closure are the platform’s to confirm)
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.