Zum Inhalt springenSkip to content
AUGMANITAI
/

Vokabular für MaschinenMachine vocabulary

AufsichtsnachweiseOversight records

Einfach erklärtIn plain words

Viele schreiben „Ein Mensch hat das geprüft“. Oft weiß dann niemand, was wirklich passiert ist: Hat jemand nur draufgeschaut, eine bestimmte Sache geprüft, entschieden oder etwas freigegeben? Dieses Vokabular trennt die vier Fälle. Ein Programm kann damit selbst testen, ob ein Eintrag alle Angaben enthält, die eine Prüfung braucht.

Many records say “a human checked this”. Often nobody can tell what actually happened: did someone just look, check one named thing, decide, or release something? This vocabulary separates the four cases. A program can use it to test whether a record contains everything a check needs.

Was die Regeln prüfenWhat the rules test

Jede AufsichtshandlungEvery oversight actnatural_person, object_ref, timestamp
BeobachtungObservationno named_property, no chosen, no permitted_action, no outcome, no alternatives, no authority
PrüfungCheckexactly one named_property, stated before the outcome; outcome holds / does_not_hold / undetermined; not_performed is not a check
EntscheidungDecisionalternatives stated no later than the decision; chosen is one of them
FreigabeReleasea decision plus authority_ref, an authority valid before the release, and the permitted_action
Undifferenzierter Beteiligungsnachweis (Warnung)Undifferentiated approval (warning)human_involvement stated, but no act named or a label outside the four acts

Die Regeln prüfen die Form des Nachweises. Sie stellen nicht fest, dass die Handlung stattgefunden hat, und sie sind kein Nachweis der Konformität.The rules test the form of the record. They do not establish that the act took place, and they are not evidence of conformity.

Technisch: Die Regeln sind SHACL mit SPARQL-Teilen (ein Prüfprogramm muss SHACL-SPARQL können). Jede Zeitangabe braucht eine Zeitzone, zum Beispiel Z oder +02:00.Technical note: the rules are SHACL with SPARQL parts (a validator must support SHACL-SPARQL). Every date-time needs a timezone, such as Z or +02:00.

Beispiel: eine PrüfungExample: a check

{
  "@id": "https://example.org/record/2",
  "act_kind": "check",
  "overseer_kind": "natural_person",
  "overseer": "role:reviewer-1",
  "object_ref": "https://example.org/output/42",
  "timestamp": "2026-10-16T10:00:00Z",
  "named_property": {
    "text": "All cited sources exist",
    "stated_at": "2026-10-16T09:50:00Z"
  },
  "outcome": {
    "value": "holds",
    "determined_at": "2026-10-16T09:58:00Z"
  }
}

DateienFiles

oversight.ttl (Turtle (OWL)) · oversight.jsonld (JSON-LD (OWL)) · oversight-shapes.ttl (SHACL) · oversight-record.context.jsonld (JSON-LD context) · oversight-examples.jsonld (examples)

Namespace: https://w3id.org/augmanitai/ns/oversight# · prefix augo

Die Begriffe dahinterThe terms behind it AufsichtshandlungOversight actBeobachtung (Aufsichtshandlung)Oversight observationPrüfhandlungOversight checkEntscheidung (Aufsichtshandlung)Oversight decisionFreigabe (Aufsichtshandlung)Oversight releaseUndifferenzierter BeteiligungsnachweisUndifferentiated approval

Zitieren und nutzenCite and reuse

Ehstand, Andreas (2026). AUGMANITAI oversight record vocabulary, version 0.1. https://w3id.org/augmanitai/ns/oversight/0.1

Dauerhaft archiviertArchived: Zenodo ↗

Frei nutzbar mit NamensnennungFree to use with attribution (CC BY 4.0): Andreas Ehstand (ORCID: 0009-0006-3773-7796 | https://w3id.org/augmanitai)

Status: Kandidat, Fassung 0.1. Spätere Fassungen bekommen eine eigene Adresse; diese bleibt abrufbar.Status: candidate, version 0.1. Later versions get their own address; this one stays available.