EA-ADR-014

ADR-014 – Erklärbarkeit durch stabile Wissensreferenzen#

Kontext#

Historische Architekturquellen beschreiben Glossar, Learning Nuggets, Traceability, kanonische Referenzauflösung, mehrsprachige Inhalte und semantische Präsentation. Diese Aussagen ergeben gemeinsam die Anforderung, Erklärungen nicht als isolierten Freitext zu behandeln.

Observability allein zeigt, dass etwas geschah. Für Knowledge-Level Logging und nachvollziehbare Entscheidungen muss zusätzlich erkennbar sein, welches Wissen, welche Regel und welche Evidenz zur Interpretation verwendet wurden.

Entscheidung#

Enterprise Explainability basiert auf:

• stabilen, sprachneutralen Reason Codes,
• kanonischen Knowledge References,
• expliziten ⌘EvidenceTechnical documentation artifact. References,
• nachvollziehbarem Execution Context,
• erkennbarer Revision oder Gültigkeit,
• getrennten maschinellen und menschenlesbaren Materialisierungen derselben semantischen Explanation.

Freitext bleibt erlaubt, ist aber nicht die alleinige Identität oder Begründungsstruktur einer Explanation.

Konsequenzen#

• Knowledge-Level Logging wird als semantische Erweiterung technischer Logs modelliert.
• Glossar, Learning, Decisions, Principles und Reference Models werden adressierbare Explainability-Quellen.
• Lokalisierung verändert Darstellung, nicht Reason ⌘CodeCode ist eine ausführbare oder interpretierbare technische Realisierung, die durch Tests und Runtime-Evidence überprüfbar bleibt. oder semantische Identity.
• Solutions müssen konkrete Resolver-, Persistenz- und Präsentationsmechanismen definieren.
• Historische Events müssen den verwendeten Wissensstand nachvollziehbar halten.

Nicht entschieden#

Diese ADR entscheidet keine konkrete API, Datenbank, Logplattform, Event-Schema-Version, Suchmaschine oder UI.

Migrationsprovenienz#

Semantisch konsolidiert aus der historischen Quelle SolutionArchitecture.zip:

• 40-concepts/architecture-knowledge-base/CON-002-Traceability-Knowledge-Graph.md
• 90-governance/GOV-006-Knowledge-Preservation-Governance.md
• 30-domain-model/DOM-005-Language-Terminology-Domain.md

Related Architecture#

• ◆Explainability by Reference PrincipleVerlangt erklärbare Entscheidungen und Zustandsübergänge durch stabile Referenzen auf Wissen, Regeln und Evidenz. – decides
• ◆Explainability Reference ModelDefiniert die universellen Bestandteile einer nachvollziehbaren maschinellen und menschlichen Erklärung. – realized-through
• ◆Knowledge-Level Logging ModelHebt technische Ereignisse durch stabile Knowledge-, Decision-, Principle- und Evidence-Referenzen auf eine nachvollziehbare Wissensebene. – realized-through
• Explainability Governance – governed-by