GLOSSARY-CONTRACT

Glossarvertrag#

Zweck#

Das Glossar ist semantische Infrastruktur. Es führt verbindliche Begriffe als eigenständige, versionierte Artefakte und ist weder eine lose alphabetische Liste noch eine Präsentationsfunktion.

Verbindliche Invarianten#

1. Eine ⌘BedeutungBedeutung beschreibt den fachlichen Sinn eines Elements und seine Relevanz für Menschen und Organisationen. wird genau einmal in ihrer fachlichen Heimat definiert.
2. Ein ⌘GlossareintragEin Glossareintrag ist ein eindeutig identifizierbares Architecture Artifact, das die verbindliche Bedeutung eines Begriffs, seine Kurzdefinition, fachliche Heimat, Ownership und optional weitere Erklärungen, Synonyme, Abgrenzungen und Themenfelder beschreibt. besitzt eine stabile [[ART-DEF-0003|⌘ArtifactEin Artefakt ist jede eindeutig identifizierbare fachliche, technische, organisatorische oder reale Einheit, die in der Engineering-Landschaft modelliert wird. ID]] und GUID, Owner, Lifecycle-Status und Version.
3. Genau ein Thema ist die fachliche Heimat; weitere Themen dürfen als zusätzliche Zuordnungen geführt werden.
4. Kurzdefinition und Definition dürfen einander nicht widersprechen.
5. Verbindliche Verwendungen referenzieren die stabile semantische Identität in der Form [[ART-DEF-0001]], nicht einen Dateipfad oder Darstellungstext.
6. Bei der ersten verbindlichen Verwendung entstehen Glossareintrag und semantische Referenz gemeinsam.
7. Verschiedene Bedeutungen eines Homonyms besitzen getrennte Einträge und eindeutige Referenzen.
8. Veraltete Begriffe bleiben auflösbar und verweisen auf den bevorzugten Begriff.
9. Glossareinträge verwenden den allgemeinen Artifact-Lifecycle; ein paralleles Statusmodell ist unzulässig.
10. ⌘RendererEin Renderer erzeugt eine konkrete technische Ausgabeform aus einer vorbereiteten Dokumentationsprojektion. Beispiele sind HTML, PDF, Markdown, JSON oder ein Suchindex. stellen bereits aufgelöste Semantik dar. Die Auflösung erfolgt vor der Präsentation und darf Bedeutung oder Identität nicht verändern.

Pflichtstruktur eines Eintrags#

• Artifact ID und GUID
• Begriff
• Kurzdefinition
• Definition
• fachliche Heimat
• Owner
• Status und Version

Optional sind Erläuterung, Abgrenzung, Synonyme, frühere Bezeichnungen, nicht empfohlene Begriffe, weitere Themenfelder, Begriffstyp, verwandte Begriffe sowie Quellen oder begründende Artefakte.

Die kanonische Struktur steht in Glossary Entry Template.

Sichten#

Thematische, alphabetische, typbezogene und Suchsichten werden aus denselben Einträgen erzeugt. Medium und Darstellung dürfen variieren; Bedeutung, Identität, Ownership und Lifecycle bleiben unverändert. Hover ist niemals der einzige Zugangsweg.

Auflösung und Föderation#

Ein semantischer Katalog indiziert führende Quellen, erzeugt aber keine neue Wahrheit oder Identität. Repositoryübergreifende Auflösung erhält Identität und Ownership und schlägt bei doppelten IDs, GUIDs oder Aliasen sichtbar fehl. Der Terminology ⌘ServiceEin Service ist eine abgegrenzte bereitgestellte technische oder fachliche Leistung mit klarer Verantwortung. darf Begriffe bereitstellen, übersetzen und anwenden, besitzt aber nicht automatisch deren Definition.

Migration#

Die historische Definition und ART-DEF-Identität bleiben erhalten, bis ein Eintrag kontrolliert promoviert ist. Eine ⌘PromotionTechnical documentation artifact. ergänzt eigenständigen Eintrag, GUID, fachliche Heimat, Owner, Lifecycle und Typ, behält vorhandene Referenzen bei und validiert Inhalt sowie Auflösung. Der historische Definition Catalog bleibt Migrationsquelle, bis Inhalt und Referenzen vollständig geprüft sind.

Related Architecture#

• Terminology Lifecycle Governance – governed-by
• Enterprise Core Terms – applied-by
• ◆Cross-Repository Reference ModelKanonische Syntax und Semantik repositoryqualifizierter Referenzen und Realisierungsketten. – resolved-through