EA-KNOWLEDGE-GRAPH-001
Wissensgraph der Unternehmensarchitektur#
Zweck#
Die Enterprise-Dokumentation materialisiert selbst einen Wissensgraphen. Dokumente sind adressierbare Artifacts; ihre Inhalte tragen GlossarbegriffBedeutung beschreibt den fachlichen Sinn eines Elements und seine Relevanz für Menschen und Organisationen.Glossareintrag vollständig lesen; explizite Links materialisieren typisierte Relationships.
Der Graph dient drei Zielen:
- Menschen können von einer Aussage zu ihrer Begründung, Entscheidung, Governance und ihrem Learning navigieren.
- Publisher und Engineering Tools können Referenzen validieren und im HTML-Report darstellen.
- spätere Execution-, Evidence- und Logging-Artefakte können stabile Knowledge References auflösen.
Beziehungstypen#
| GlossarbegriffEine Beziehung beschreibt eine nachvollziehbare Verbindung zwischen Bedeutungen, Artefakten und ihrem Kontext.Glossareintrag vollständig lesen | Bedeutung |
|---|---|
derived-from |
Eine Aussage wurde aus einer führenden Quelle abgeleitet. |
specializes |
Ein Element verfeinert ein allgemeineres Element für einen kleineren Scope. |
constrained-by |
Principle, Governance oder Decision begrenzt zulässige Ausprägungen. |
explained-by |
Glossar oder GlossarbegriffDidaktisches Wissensartefakt, das ein Architektur- oder Technikthema verständlich erklärt, ohne normative Architekturregeln zu ersetzen.Glossareintrag vollständig lesen erklärt eine Aussage. |
realized-through |
Ein Modell wird durch Reference GlossarbegriffEin Artefakt ist jede eindeutig identifizierbare fachliche, technische, organisatorische oder reale Einheit, die in der Engineering-Landschaft modelliert wird. Alles Modellierbare wird als Artefakt geführt. Dazu gehören unter anderem Systeme, Beziehungen, Features, Dokumente, ADRs, Tests, UI-Buttons, Menüs, Farben, Icons, Konfigurationen, Diagramme, Runtime-Ressourcen, fachliche Objekte und reale Objekte wie ein Blumentopf, sofern sie modelliert werden. Knowledge ist keine Sonderklasse. UI- und Applikationsartefakte werden fachlich nach demselben Grundmodell behandelt.Glossareintrag vollständig lesen, Process oder GlossarbegriffEin Building Block ist ein abgegrenzter Baustein mit stabiler Verantwortung zur Realisierung von Capabilities.Glossareintrag vollständig lesen operationalisiert. |
produces-evidence-for |
Execution oder Verification erzeugt GlossarbegriffTechnical documentation artifact.Glossareintrag vollständig lesen für eine Aussage. |
learned-from |
Dauerhaftes Learning wurde aus Evidence oder Findings konsolidiert. |
governed-by |
Ein Lifecycle oder eine Veränderung wird durch Governance geregelt. |
decided-by |
Eine bewusste Architekturentscheidung trägt die Aussage. |
related-to |
Fachlich relevante Verbindung ohne stärkere behauptete Semantik. |
Zentrale Ableitungskette#
Vision → MeaningEnterprise-Capability-ModelDefiniert Capability als Meaning, ihre fachliche Herkunft, Beziehungen, Spezialisierung und Realisierung.Vollständig lesen → Reference Building Blocks → Solution Building Blocks → Implementation Modules → Runtime Components → Kontext & ZeitExecution-Kontext- und Ereignis-ModelDefiniert Execution als zeitliche Interpretation der Ontologie in einem konkreten Kontext.Vollständig lesen → Learning
Zentrale semantische Knoten#
- MeaningKernontologie der UnternehmensarchitekturDefiniert Meaning, Artifact und Relationship als fundamentale semantische Familien sowie Identity als universelle Eigenschaft.Vollständig lesen – Meaning, Artifact, Relationship und Identity.
- Capability Model – GlossarbegriffEine Capability beschreibt ein dauerhaft benötigtes fachliches Leistungsvermögen, nicht dessen technische Umsetzung.Glossareintrag vollständig lesen und fachliche GlossarbegriffProvenienz hält Quelle, Entstehungs- oder Ableitungskontext sowie gegebenenfalls Revision und Prüfung fest. Sie erklärt, warum etwas als Beleg erhalten bleibt, ohne daraus automatisch eine aktuell führende Aussage zu machen.Glossareintrag vollständig lesen.
- Execution Context and Event Model – konkrete Anwendung im zeitlichen Kontext.
- MeaningGeschichtetes Wissens-ModelDefiniert Gültigkeit, Herkunft und Entwicklung von Wissensartefakten entlang der Architekturebenen.Vollständig lesen – Scope, Provenance und Wissensschichten.
- MeaningErklärbarkeits-, Wissens-, Evidence- und LernstrukturOrdnet Explainability, Knowledge, Evidence und Learning als zusammenhängende, aber getrennt verantwortete Wissensstruktur ein.Vollständig lesen – gemeinsame Referenzkette von Explanation über Knowledge und Evidence zu Learning.
- BeziehungWissensreferenzmodellOrdnet Wissensartefakte, Wissensbeziehungen, fachliche Heimat, Scope und Sprachfassungen universell ein.Vollständig lesen – wiederverwendbare Knowledge Artifacts.
- Kontext & ZeitWissensevolutionsprozessLebenszyklus von Beobachtung und Evidence über Konsolidierung bis zur institutionalisierten Erkenntnis.Vollständig lesen – GlossarbegriffTechnical documentation artifact.Glossareintrag vollständig lesen aus Evidence und Findings.
Materialisierungsregel#
Links in Abschnitten mit Überschriften wie Related Architecture, Verweise oder Siehe auch sind semantische Navigation. Sie werden von der Documentation Pipeline validiert, aber nicht als harte Build-Abhängigkeiten interpretiert.
Eine Beziehung darf nur eingetragen werden, wenn ihre Bedeutung aus den beteiligten Dokumenten ableitbar ist. Links dürfen keine neue Architekturentscheidung vortäuschen.
Knowledge-Level Logging#
Ein erklärbares Event enthält neben technischen Angaben stabile Referenzen auf Execution, betroffene Artifacts, Reason Codes, Knowledge Artifacts und Evidence. Der Knowledge Graph verbindet diese Referenzen weiter mit Architecture Decisions, Principles, Meaning und GlossarbegriffEine Vision beschreibt eine langfristig gewünschte Wirkung und gibt der Weiterentwicklung eine gemeinsame Richtung.Glossareintrag vollständig lesen.
Die universelle Struktur ist im Kontext & ZeitWissensebenen-ProtokollierungsmodellHebt technische Ereignisse durch stabile Knowledge-, Decision-, Principle- und Evidence-Referenzen auf eine nachvollziehbare Wissensebene.Vollständig lesen beschrieben. Die konkrete Persistenz und Auflösung bleibt Aufgabe der jeweiligen Solution.
Related Architecture#
- Architecture Navigation –
explained-by - MeaningPrinzip typisierter RelationshipsFachliche Zusammenhänge werden als typisierte semantische Relationships modelliert.Vollständig lesen –
constrained-by - Layered Knowledge Model –
derived-from - MeaningÜberwachbarkeit by DesignVerlangt beobachtbare und erklärbare Actions, Decisions, State Transitions und Results.Vollständig lesen –
related-to - MeaningErklärbarkeitsreferenzmodellDefiniert die universellen Bestandteile einer nachvollziehbaren maschinellen und menschlichen Erklärung.Vollständig lesen –
realized-through - Knowledge-Level Logging Model –
realized-through