Offenlegungsschema¶
Jeder veröffentlichte Record besteht aus einem Snapshot — einem eingefrorenen JSON-Dokument nach dem hier beschriebenen Schema (englisch Disclosure Schema). Der Snapshot ist die einzige Quelle für alles, was öffentlich angezeigt wird: die HTML-Seite, das PDF, die JSON- und JSON-LD-Antworten der API werden alle aus demselben Objekt gerendert (siehe Grundsätze).
Die aktuelle Version dieses Schemas ist 0.3 (disclosureSchemaVersion).
Jede veröffentlichte Version eines Records speichert die zum
Veröffentlichungszeitpunkt gültige Schema-Version fest — ändert sich das
Schema später, bleiben ältere Snapshots unverändert in ihrer damaligen Form
gültig. Alle bisherigen Schema-Änderungen waren additiv: Ein Snapshot
nach Schema 0.1 oder 0.2 enthält die später hinzugekommenen Felder
schlicht nicht (siehe Änderungsprotokoll).
| Schema | Neu gegenüber der Vorversion |
|---|---|
0.1 |
Grundaufbau: Kopfdaten, aiSystems, contributions, Zusammenfassungen, referenceVerification, dataProtection, accountability, comment, Versionsstände. |
0.2 |
author und studyContext — getrennt freigebbare öffentliche Felder, sonst null. |
0.3 |
contributions[].additionalAiSystemIndexes, contributions[].description, interactionDocumentation. |
Vollständiges Beispiel¶
Das folgende Beispiel ist der echte, veröffentlichte Snapshot des
Pilot-Records PILOT-2026-0002 in Version 1.2 — genau so, wie ihn
GET /api/v1/records/PILOT-2026-0002/versions/1.2 liefert (ohne die dort
zusätzlich beigefügten Felder recordHash, versions und url). Er wurde
unter Schema 0.2 veröffentlicht und enthält daher die Felder von Schema
0.3 noch nicht; diese zeigt der Abschnitt danach. Weil veröffentlichte
Versionen unveränderlich sind, bleibt dieses Beispiel dauerhaft gültig:
seine Prüfsumme (recordHash) ist
051c0126d838a555af38ed810e9acaf06219ab51d22f0bcd1c835069c99223e8.
{
"schemaVersion": "0.2",
"recordId": "PILOT-2026-0002",
"recordVersion": "1.2",
"status": "amended",
"publishedAt": "2026-09-18T03:14:50.520382+00:00",
"createdAt": "2026-09-16T06:10:28.463145+00:00",
"title": "Durchführung einer Nutzwertanalyse ausgewählter Vitamine und Mineralstoffe hinsichtlich ihrer Nutzbarkeit bei Lorenz Snacks GmbH & Co. KG Germany",
"author": "Marc Robin Keller",
"studyContext": "Projektarbeit im Rahmen eines dualen Studiums an der DHBW Heilbronn",
"workType": {
"code": "projektarbeit",
"label": "Projektarbeit"
},
"workYear": 2026,
"aiSystems": [
{
"index": 1,
"provider": "Google",
"system": "Gemini",
"selfDeclared": false,
"model": "Thinking",
"modelVersion": "",
"usageFrom": null,
"usageTo": null,
"accessType": "web"
},
{
"index": 2,
"provider": "OpenAI",
"system": "ChatGPT",
"selfDeclared": false,
"model": "5.4 Thinking",
"modelVersion": "",
"usageFrom": null,
"usageTo": null,
"accessType": "web"
},
{
"index": 3,
"provider": "Elicit",
"system": "Elicit",
"selfDeclared": false,
"model": "Free",
"modelVersion": "",
"usageFrom": null,
"usageTo": null,
"accessType": "web"
},
{
"index": 4,
"provider": "PubGenius Inc.",
"system": "SciSpace",
"selfDeclared": true,
"model": "1.0.4",
"modelVersion": "",
"usageFrom": null,
"usageTo": null,
"accessType": "web"
},
{
"index": 5,
"provider": "Google",
"system": "NotebookLM",
"selfDeclared": false,
"model": "Standard",
"modelVersion": "",
"usageFrom": null,
"usageTo": null,
"accessType": "web"
}
],
"contributions": [
{
"activity": {
"code": "literaturrecherche",
"group": "literature",
"label": "Literaturrecherche"
},
"aiSystemIndex": 3,
"contributionLevel": "A4",
"verificationLevel": "V2",
"purpose": null,
"researchCritical": true
},
{
"activity": {
"code": "literaturzusammenfassung",
"group": "literature",
"label": "Literaturzusammenfassung"
},
"aiSystemIndex": 5,
"contributionLevel": "A3",
"verificationLevel": "V2",
"purpose": "summarising",
"researchCritical": false
},
{
"activity": {
"code": "methodik",
"group": "methods",
"label": "Methodik"
},
"aiSystemIndex": 1,
"contributionLevel": "A2",
"verificationLevel": "V1",
"purpose": "ideation",
"researchCritical": false
},
{
"activity": {
"code": "original-draft",
"group": "writing",
"label": "Original Draft"
},
"aiSystemIndex": 1,
"contributionLevel": "A3",
"verificationLevel": "V1",
"purpose": "drafting",
"researchCritical": false
},
{
"activity": {
"code": "sprachoptimierung",
"group": "writing",
"label": "Sprachoptimierung"
},
"aiSystemIndex": 1,
"contributionLevel": "A1",
"verificationLevel": "V2",
"purpose": "language",
"researchCritical": false
},
{
"activity": {
"code": "literaturverzeichnis",
"group": "references",
"label": "Literaturverzeichnis"
},
"aiSystemIndex": 2,
"contributionLevel": "A1",
"verificationLevel": "V2",
"purpose": "checking",
"researchCritical": false
}
],
"contributionSummary": {
"maxLevel": "A4",
"levels": {
"A0": 0,
"A1": 2,
"A2": 1,
"A3": 2,
"A4": 1
}
},
"verificationSummary": {
"minLevel": "V1",
"levels": {
"V0": 0,
"V1": 2,
"V2": 4,
"V3": 0
}
},
"researchCriticalAI": true,
"referenceVerification": {
"existenceChecked": "full",
"originalsChecked": "full",
"aiSuggestedSources": "yes",
"bibliographicChecked": "full",
"unverifiedReferencesUsed": "no"
},
"dataProtection": {
"dataStatus": [],
"externalTransfer": "no"
},
"accountability": {
"confirmed": true,
"confirmedAt": "2026-09-14T12:00:00+02:00",
"statements": [
"completeness",
"content",
"sources",
"integrity",
"interpretation",
"finalVersion",
"rules"
]
},
"comment": "Mehrfachnutzung je Taetigkeit laut Fragebogen (das Datenmodell fuehrt pro Taetigkeit ein KI-System; das jeweils erstgenannte wurde verknuepft): Literaturrecherche - Reformulieren und Definieren der Suchstrings (Elicit, SciSpace). Literaturzusammenfassung - Zusammenfassen und Erlaeutern der Literatur (NotebookLM). Methodik/Studiendesign - Absprache und Brainstorming ueber das Konzept (Gemini). Erster Textentwurf - Erstellung von Vorschlaegen und Entwuerfen (Gemini, ChatGPT). Sprachliche Optimierung - Verbesserungsvorschlaege fuer Grammatik und Rechtschreibung (Gemini, ChatGPT). Quellen-/Literaturverzeichnis - Anpassen der Literatur an die DHBW-Richtlinien (ChatGPT). KI-Interaktionen wurden laut Fragebogen nur fuer wissenschaftlich relevante Arbeitsschritte dokumentiert, nicht vollstaendig archiviert.",
"platformVersion": "0.1.1",
"disclosureSchemaVersion": "0.2",
"evaluationSchemaVersion": "0.1"
}
Auf der Record-Seite trägt dieser Record zusätzlich das Verifiziert-Kennzeichen. Es ist bewusst kein Teil des Snapshots: Der Snapshot ist die Selbstauskunft der Autorin/des Autors; die Bestätigung durch eine dritte Stelle wird getrennt geführt und verändert weder den Snapshot noch seine Prüfsumme.
Ergänzungen in Schema 0.3¶
Ein Snapshot nach Schema 0.3 enthält zusätzlich je Tätigkeit die weiteren
beteiligten KI-Systeme und eine Beschreibung sowie auf Record-Ebene die
Angabe, wie weit die KI-Interaktionen dokumentiert wurden:
{
"contributions": [
{
"activity": {"code": "literaturrecherche", "label": "Literaturrecherche", "group": "literature"},
"aiSystemIndex": 3,
"additionalAiSystemIndexes": [4],
"description": "Reformulieren und Definieren der Suchstrings",
"contributionLevel": "A4",
"verificationLevel": "V2",
"purpose": null,
"researchCritical": true
}
],
"interactionDocumentation": "relevant",
"disclosureSchemaVersion": "0.3"
}
Feldreferenz¶
Kopfdaten¶
| Feld | Typ | Beschreibung |
|---|---|---|
schemaVersion |
string | Identisch mit disclosureSchemaVersion; historisch als Kurzform mitgeführt. |
recordId |
string | Feste Record-ID, z. B. PILOT-2026-0002. |
recordVersion |
string | Versionslabel dieses Snapshots, z. B. 1.2 (siehe Versionierung). |
status |
string | Einer von draft, self_declared, pending_full_disclosure, published, amended, withdrawn. Das Verifiziert-Kennzeichen ist kein Status und nicht Teil des Snapshots. |
publishedAt |
string (ISO 8601, UTC) | Veröffentlichungszeitpunkt dieser Version. |
createdAt |
string (ISO 8601, UTC) | Erstellungszeitpunkt des zugrundeliegenden Records. |
title |
string oder null |
Titel der Arbeit, sofern die Autorin/der Autor die Veröffentlichung des Titels gewählt hat; sonst null (siehe Datenschutzmodell). |
author |
string oder null |
Seit Schema 0.2. Name der Autorin/des Autors, nur wenn ausdrücklich zur Veröffentlichung freigegeben; sonst null. |
studyContext |
string oder null |
Seit Schema 0.2. Studienkontext (z. B. Studienform, Hochschule), nur wenn ausdrücklich freigegeben; sonst null. |
workType |
Objekt {code, label} |
Art der Arbeit aus einer kontrollierten Vokabelliste (z. B. Bachelorarbeit, Masterarbeit, Projektarbeit, Dissertation, Artikel). |
workYear |
integer | Jahr der Arbeit. |
aiSystems[]¶
Jeder Eintrag beschreibt ein im Rahmen der Arbeit genutztes KI-System.
| Feld | Typ | Beschreibung |
|---|---|---|
index |
integer | 1-basierter Index, referenziert aus contributions[].aiSystemIndex und contributions[].additionalAiSystemIndexes. |
provider |
string | Anbieter, z. B. „OpenAI“. |
system |
string | Systemname, z. B. „ChatGPT“. |
selfDeclared |
boolean | true, wenn Anbieter/System zum Zeitpunkt der Eingabe nicht in der kontrollierten Vokabelliste geführt wurden und erst zur Moderation vorgeschlagen wurden. |
model |
string | Konkretes Modell, sofern bekannt. |
modelVersion |
string | Modellversion, sofern bekannt; sonst leer. |
usageFrom / usageTo |
string (Datum) oder null |
Zeitraum der Nutzung dieses Systems, sofern angegeben. |
accessType |
string | web, api, local, institutional_platform oder other. |
contributions[]¶
Jeder Eintrag verknüpft eine Tätigkeit mit einem KI-System und den beiden Stufen.
| Feld | Typ | Beschreibung |
|---|---|---|
activity |
Objekt {code, label, group} |
Tätigkeit aus der kontrollierten Vokabelliste, mit Anzeigegruppe (z. B. literature, methods, writing, references). |
aiSystemIndex |
integer | Hauptsächlich genutztes System, verweist auf aiSystems[].index. |
additionalAiSystemIndexes |
Liste von integer | Seit Schema 0.3. Weitere an dieser Tätigkeit beteiligte Systeme (ohne das Hauptsystem), ebenfalls Verweise auf aiSystems[].index. |
description |
string | Seit Schema 0.3. Was die KI bei dieser Tätigkeit konkret getan hat; leer, wenn nicht angegeben. |
contributionLevel |
string | A0–A4, siehe Beitragsstufen. |
verificationLevel |
string | V0–V3, siehe Prüfstufen. |
purpose |
string oder null |
Zweck der Nutzung aus einer kontrollierten Vokabelliste (z. B. ideation, summarising, drafting, language, checking); null, wenn nicht angegeben. |
researchCritical |
boolean | Markiert die Tätigkeit als forschungskritisch, unabhängig von der Beitragsstufe. |
Zusammenfassungen¶
| Feld | Typ | Beschreibung |
|---|---|---|
contributionSummary.levels |
Objekt | Anzahl der Tätigkeiten je Beitragsstufe (A0…A4). |
contributionSummary.maxLevel |
string | Höchste im Record vorkommende Beitragsstufe. |
verificationSummary.levels |
Objekt | Anzahl der Tätigkeiten je Prüfstufe (V0…V3). |
verificationSummary.minLevel |
string | Niedrigste im Record vorkommende Prüfstufe. |
researchCriticalAI |
boolean | true, sobald mindestens eine Tätigkeit als forschungskritisch markiert ist. |
referenceVerification¶
Dokumentiert den Umgang mit KI-vorgeschlagenen Quellen (siehe Prüfstufen).
| Feld | Typ | Werte |
|---|---|---|
aiSuggestedSources |
string | yes / no — wurden Quellen von einer KI vorgeschlagen? |
existenceChecked |
string | no / partial / full — wurde die Existenz der Quellen geprüft? |
originalsChecked |
string | no / partial / full — wurden Originaltexte eingesehen? |
bibliographicChecked |
string | no / partial / full — wurden bibliografische Angaben geprüft? |
unverifiedReferencesUsed |
string | yes / no — wurden trotz allem ungeprüfte Referenzen verwendet? |
dataProtection¶
| Feld | Typ | Werte |
|---|---|---|
externalTransfer |
string | yes / no / na — wurden Daten an ein externes KI-System übermittelt? |
dataStatus |
Liste von strings | Zutreffende Einträge aus anonymized, pseudonymized, public, institutionally_released, other_legal_basis. Kann leer sein. |
accountability¶
| Feld | Typ | Beschreibung |
|---|---|---|
confirmed |
boolean | Ob die Verantwortungserklärung vor Veröffentlichung bestätigt wurde (Pflicht für eine Veröffentlichung). |
confirmedAt |
string (ISO 8601) | Zeitpunkt der Bestätigung. |
statements |
Liste von strings | Die bestätigten Erklärungscodes; siehe Menschliche Verantwortung für den vollständigen, festen Wortlaut je Code. |
Sonstiges¶
| Feld | Typ | Beschreibung |
|---|---|---|
interactionDocumentation |
string oder null |
Seit Schema 0.3. Wie weit die KI-Interaktionen selbst dokumentiert wurden: none (nicht), relevant (nur für wissenschaftlich relevante Schritte), complete (vollständig); null, wenn nicht angegeben. |
comment |
string | Optionaler freier Kommentar der Autorin/des Autors. Wird veröffentlicht, wenn ausgefüllt — siehe Datenschutzmodell. |
platformVersion |
string | Plattformversion zum Veröffentlichungszeitpunkt, z. B. 0.3.1. |
disclosureSchemaVersion |
string | Version dieses Schemas zum Veröffentlichungszeitpunkt. |
evaluationSchemaVersion |
string | Version des Evaluation-Schemas zum Veröffentlichungszeitpunkt. |
Was absichtlich nicht im Snapshot steht¶
Der Snapshot enthält keine Angaben zu Matrikelnummer, Studiengang, Betreuung, internen Referenzen oder Konto der Autorin/des Autors — und nichts darüber, ob und durch wen ein Record verifiziert wurde. Diese Angaben werden auf getrennten, privaten Datenmodellen geführt, die der Baustein, der den Snapshot erzeugt, nicht liest — siehe Datenschutzmodell für die vollständige Gegenüberstellung.