Agreement 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 act about a site’s agreement, from the agreement-act scheme: the site, the act, when it was observed, the observer in a role, and its evidence: the document and signatory for a formal act, a note for an informal one. Never changed; a later act is a new record.

Properties

Property Required Repeatable Value Message
act document no no Evidence item An agreement record carries at most one document, as an evidence item.
act document / authority evidence no no Evidence item The signatory’s authority, when shown, is one evidence item, such as a delegation letter (ADR-0030).
act document / signatory no yes Agent role The signatory of an agreement document is an agent role: an IRI and a role, nothing more (ADR-0007).
act document / signed on behalf of no no Agent role A signatory signs on behalf of at most one landowner, as an agent role (ADR-0007, ADR-0030).
act note no no string
agreed by no no Agent role A verbal agreement names who agreed once, as an agent role, never a name (ADR-0007).
agreement act yes no NCGS Agreement Acts: Request made, Agreed verbally, Agreement signed, Declined, Access denied, Access restored, Formal withdrawal, Formal reinstatement An agreement record carries exactly one act from the agreement-act scheme.
capture channel yes no NCGS Capture Channels: Dedicated app, WhatsApp flow, Paper, transcribed
observed at yes no dateTime An agreement record has exactly one observed time, from which the status it leads to holds.
observer yes no Agent An agreement record names exactly one observer by IRI, never a literal (ADR-0004, ADR-0007).
observer role yes no NCGS Observer Roles: Fieldworker, Supervisor An agreement act is recorded by a fieldworker or supervisor.
records site yes no Site An agreement record is about exactly one site.
verbal agreement recording no no Evidence item A verbal agreement carries at most one recording, as an evidence item (ADR-0030).
verbal agreement recording / date signed never no date A verbal agreement recording has no signing date: the act stays verbal (ADR-0030).
verbal agreement recording / signatory never no Agent role A verbal agreement recording has no signatory: the act stays verbal (ADR-0030).
witness no no Agent role A verbal agreement names at most one witness, as an agent role, never a name (ADR-0007).

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 formal agreement act carries its document as an evidence item of the type the act requires, with its content address, the date signed and the signatory: one of the landowner, the site manager or the owner, as an agent in a role. A signed agreement is a photographed document, an on-screen signature or a recorded consent (ADR-0030).
  • A signatory signs on behalf of the landowner, in the landowner role (ADR-0030).
  • A verbal agreement names who agreed: the landowner, the site manager or the owner, as an agent in a role (ADR-0030).
  • Every agreement act leads to a status by an allowed agreement transition from the status in force before it, unless a later correction restates it (ADR-0025). This one has no status assignment: the move is not allowed, or the agreement operation has not run (ADR-0019).
  • Only a verbal agreement carries a verbal agreement recording, by ncgs:verbalAgreementRecording and of that type; it is never an act’s document (ADR-0030).
  • Only a verbal agreement names who agreed and a witness; a signed act names its signatory on the document.
  • This agreement act needs a note of what was seen or said.
  • 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).

Agreement status assignment

One result of the agreement operation: the status a site’s agreement took from an act, the time from which it holds (the act’s observed time), the act it derives from (prov:wasDerivedFrom) and the assignment before it. The status in force at a time is that of the latest assignment holding from then or earlier; none when there is none.

Properties

Property Required Repeatable Value Message
assigned status yes no NCGS Agreement Status: No agreement yet, Agreement requested, Agreed verbally, Agreement signed, Agreement refused, Uncooperative, Withdrawn, Withdrawn with trees on site
assigns status to yes no Site
in force from yes no dateTime
previous assignment no no Agreement status assignment
wasDerivedFrom yes no Agreement record An agreement status assignment derives from exactly one agreement record.

Rules

  • An agreement status assignment follows the latest earlier assignment of its site, or none when it is the site’s first; no two assignments of a site hold from the same time, and no act has two.
  • An agreement status assignment is about the site of its act and holds from the act’s observed time, or a correction’s from the original’s (ADR-0025).
  • An agreement status assignment takes the status an agreement transition allows for its act from the status in force before it; a withdrawal reads whether a consignment or planting record at the site was observed before it (ADR-0019).

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