diff --git a/docs/architecture/codex-workflow.md b/docs/architecture/codex-workflow.md index bc1fde6..ea60021 100644 --- a/docs/architecture/codex-workflow.md +++ b/docs/architecture/codex-workflow.md @@ -1,5 +1,7 @@ # VG-Environment Codex Workflow +Vor Beginn fachlicher Arbeiten ist `docs/architecture/project-philosophy.md` als maßgebliche Beschreibung des Projektkerns zu berücksichtigen. + ## Grundprinzip VG-Environment wird schrittweise modularisiert. diff --git a/docs/architecture/project-philosophy.md b/docs/architecture/project-philosophy.md new file mode 100644 index 0000000..fad0d50 --- /dev/null +++ b/docs/architecture/project-philosophy.md @@ -0,0 +1,103 @@ +# VG-Environment – Wesen und Kern des Projekts + +VG-Environment ist kein GVL-Explorer. + +VG-Environment ist kein Dashboard. + +VG-Environment ist keine Analyse-Engine. + +VG-Environment ist ein lokales, evidenzorientiertes Rekonstruktionswerkzeug zur Untersuchung der technisch beobachtbaren Wirkungen von Consent-Entscheidungen. + +Die zentrale Frage des Projekts lautet: + +> Was ist tatsächlich geschehen, nachdem ich dieser konkreten Entscheidung zugestimmt habe? + +Zur Beantwortung dieser Frage trennt VG-Environment bewusst drei unterschiedliche Wirklichkeitsebenen. + +## 1. Die Provider-Erzählung + +Ein CMP präsentiert dem Nutzer eine Erklärung. + +Der Nutzer trifft eine Entscheidung. + +Aus dieser Entscheidung entsteht ein tcString. + +Der tcString dokumentiert nicht die technische Realität. Er dokumentiert die Behauptung des Systems darüber, welche Zustimmungen, Ablehnungen und Berechtigungen vorliegen sollen. + +Er ist die digitale Selbstbeschreibung des Consent-Vorgangs. + +VG-Environment behandelt diese Beschreibung als Evidenzobjekt – nicht als Wahrheit. + +## 2. Die technische Realität + +Unabhängig von jeder Erklärung werden technische Folgehandlungen beobachtet. + +Requests finden statt oder finden nicht statt. + +Empfänger werden kontaktiert oder werden nicht kontaktiert. + +Parameter werden übertragen oder werden nicht übertragen. + +Diese Beobachtungen stellen die stärkste Form der Primärevidence des Projekts dar. + +Sie benötigen keine GVL und keine Interpretation, um zu existieren. + +Sie sind die dokumentierte technische Realität. + +## 3. Das Regelwerk + +Die GVL beschreibt nicht die technische Realität. + +Sie erklärt auch nicht die Requests. + +Sie beschreibt vielmehr, wie die Behauptungen des Providers innerhalb des TCF-Regelwerks einzuordnen gewesen wären. + +Sie beantwortet Fragen wie: + +- Welche Zwecke hatte ein Vendor angegeben? +- Welche Eigenschaften waren einem Vendor zugeordnet? +- Welche Beziehungen waren innerhalb des Regelwerks vorgesehen? + +Die GVL ist daher Referenz- und Analysematerial. + +Sie ist ein historisches Wörterbuch zur Bewertung der Provider-Erzählung. + +Sie ist nicht Bestandteil des beobachteten Vorgangs selbst. + +## Die eigentliche Rekonstruktion + +VG-Environment bringt diese drei Ebenen nicht durcheinander. + +Es hält sie bewusst getrennt. + +Erst aus ihrer Gegenüberstellung entstehen die entscheidenden Fragen: + +- Was wurde behauptet? +- Was ist tatsächlich geschehen? +- Entspricht die Behauptung dem eigenen Regelwerk? + +Die Antworten darauf entstehen nicht durch versteckte Bewertungen, sondern durch nachvollziehbare, auditierbare Evidence-Ketten. + +## Das Leitprinzip + +VG-Environment entscheidet nicht, was richtig oder falsch ist. + +VG-Environment dokumentiert. + +Es rekonstruiert. + +Es macht technische Realität sichtbar. + +Es zeigt Herkunft, Zusammenhänge und Widersprüche transparent auf. + +Die Bewertung bleibt dem Nutzer, Forschenden, Journalisten, Aufsichtsbehörden oder Gerichten überlassen. + +## Der Kern des Projekts + +> VG-Environment ist ein Werkzeug zur Rekonstruktion technischer Realität im Spannungsfeld zwischen Provider-Erzählung, beobachtbarer Handlung und Regelwerk. + +Oder kürzer: + +> Es zeigt nicht, was hätte geschehen sollen. +> +> Es zeigt, was behauptet wurde, was tatsächlich geschah und auf welcher Grundlage beides beurteilt werden kann. diff --git a/docs/architecture/project-principles.md b/docs/architecture/project-principles.md index 0170b08..efb46de 100644 --- a/docs/architecture/project-principles.md +++ b/docs/architecture/project-principles.md @@ -1,5 +1,8 @@ # VG-Environment — Project Principles +Hinweis: +Die grundlegende Zieldefinition und das Erkenntnisinteresse von VG-Environment sind in `docs/architecture/project-philosophy.md` beschrieben und bei allen Architektur-, Implementierungs- und Analyseentscheidungen vorrangig zu berücksichtigen. + ## Core purpose VG-Environment is a local evidence and runtime reconstruction environment for consent-related browser activity.