EA-REF-MODEL-EXPLAINABILITY-001

Erklärbarkeitsreferenzmodell#

Zweck#

Dieses Modell beschreibt die universellen Bestandteile einer Erklärung. Es definiert keine konkrete Logging-Bibliothek, API, Datenbank oder Benutzeroberfläche.

Kernobjekte#

Explanation#

Eine Explanation ist ein adressierbares Knowledge ⌘ArtifactEin Artefakt ist jede eindeutig identifizierbare fachliche, technische, organisatorische oder reale Einheit, die in der Engineering-Landschaft modelliert wird., das eine Entscheidung, Bewertung, Auswahl oder Zustandsänderung nachvollziehbar macht.

Reason Code#

Ein Reason ⌘CodeCode ist eine ausführbare oder interpretierbare technische Realisierung, die durch Tests und Runtime-Evidence überprüfbar bleibt. ist eine stabile, sprachneutrale Kennung für einen wiederkehrenden Begründungstyp. Er ist kein vollständiger Erklärungstext.

Explanation Context#

Der Explanation Context benennt den konkreten Execution Context, das betroffene Artifact, den Zeitpunkt, die relevante Revision und den auslösenden Event.

Knowledge Reference Set#

Das Knowledge Reference Set verweist auf die tatsächlich angewendeten Bedeutungen, Regeln, Principles, Architecture Decisions, Reference Models, Glossary Entries oder Learning Artifacts.

Evidence Reference Set#

Das ⌘EvidenceTechnical documentation artifact. Reference Set verweist auf Beobachtungen, Prüfungen, Messwerte oder Reports, die die Erklärung stützen.

Human Explanation#

Eine Human Explanation ist die zielgruppen- und sprachgerechte Materialisierung einer Explanation. Sie darf gekürzt, strukturiert oder didaktisch erweitert werden, muss aber dieselbe semantische Identity bewahren.

Machine Explanation#

Eine Machine Explanation ist eine strukturierte Materialisierung mit Reason Code, stabilen Referenzen, Kontext und Evidence. Sie muss ohne Interpretation des Freitexts auswertbar sein.

Minimales Erklärungsmodell#

Explanation
                ├── explanation identity
                ├── reason code
                ├── execution context reference
                ├── affected artifact reference
                ├── knowledge references
                ├── evidence references
                ├── source revisions or validity
                └── human-readable materializations

Qualitätskriterien#

Eine Explanation ist vollständig, wenn:

• Reason Code und betroffener Kontext eindeutig sind,
• alle behaupteten Gründe durch auflösbare Referenzen getragen werden,
• Evidence von Interpretation unterscheidbar bleibt,
• verwendete Revisionen oder Gültigkeitsstände erkennbar sind,
• maschinelle und menschliche Darstellung semantisch übereinstimmen,
• fehlende Informationen ausdrücklich sichtbar bleiben.

Abgrenzung#

Ein Logeintrag ist nicht automatisch eine Explanation. Ein Log kann eine Explanation referenzieren oder deren strukturierte Materialisierung enthalten. Ebenso ist eine Fehlermeldung ohne Reason Code, Kontext und Knowledge References keine vollständige Explanation.

Migrationsprovenienz#

Semantisch konsolidiert aus der historischen Quelle SolutionArchitecture.zip:

• 40-concepts/architecture-knowledge-base/CON-002-Traceability-Knowledge-Graph.md
• 40-concepts/capabilities/CAP-004-Artefakte-und-Abhaengigkeiten-Verbinden.md
• 40-concepts/capabilities/CAP-024-Validation-Compliance-und-Evidence.md

Related Architecture#

• ◆Explainability by Reference PrincipleVerlangt erklärbare Entscheidungen und Zustandsübergänge durch stabile Referenzen auf Wissen, Regeln und Evidenz. – constrained-by
• ◆Execution Context and Event ModelDefiniert Execution als zeitliche Interpretation der Ontologie in einem konkreten Kontext. – derived-from
• ◆Execution Evidence ModelOrdnet Engineering Execution und Evidence als Spezialisierung der universellen Enterprise-Execution ein. – related-to
• ◆Knowledge Reference ModelOrdnet Wissensartefakte, Wissensbeziehungen, fachliche Heimat, Scope und Sprachfassungen universell ein. – derived-from
• ◆Knowledge-Level Logging ModelHebt technische Ereignisse durch stabile Knowledge-, Decision-, Principle- und Evidence-Referenzen auf eine nachvollziehbare Wissensebene. – realized-through