SE-0015-GLOSSARY-MIGRATION-MATRIX
SE-0015 – Glossarmodell und Aufbau: Übernahmematrix#
Ergebnis#
Der Legacy-Vertrag für GlossarbegriffBedeutung beschreibt den fachlichen Sinn eines Elements und seine Relevanz für Menschen und Organisationen.Glossareintrag vollständig lesen, Aufbau, Referenzierung, Auflösung und Pflege ist vollständig im Enterprise-Glossarvertrag und dessen Eintragsvorlage abgebildet. Die Solution spezialisiert ausschließlich Auflösung und Bereitstellung. Keine bestehende Definition wurde in SE-0015 verändert oder neu interpretiert.
Vertragsdisposition#
| Legacy-Quelle | Ziel | Disposition |
|---|---|---|
CON-017-Glossary-Architecture.md |
enterprise-architecture:98-glossary/glossary-contract.md |
vollständig übernommen |
ADR-0037-Glossary-As-Semantic-Infrastructure.md |
Glossary Contract und bestehende SADR-011 | vollständig übernommen |
DOM-005-Language-Terminology-Domain.md |
Glossary Contract, Lifecycle Governance, Solution-Datenmodell | vollständig übernommen |
85-knowledge/10-glossary/README.md |
Enterprise Glossary README | vollständig übernommen |
entries/README.md |
Glossary Entry Template | vollständig übernommen |
GLOSSARY-GOVERNANCE.md |
Terminology Lifecycle Governance und Glossary Contract | vollständig übernommen |
GLOSSARY-REFERENCING-RULES.md |
Glossary Contract und Solution-Datenmodell | vollständig übernommen |
SEMANTIC-CATALOG.md |
Glossary Contract | vollständig übernommen |
CROSS-REPOSITORY-SEMANTIC-RESOLUTION.md |
Glossary Contract und Solution-Servicevertrag | vollständig übernommen |
GLOSSARY-MIGRATION-STRATEGY.md |
Glossary Contract | vollständig übernommen |
SEMANTIC-RESOLUTION-PIPELINE.md |
Solution-Servicevertrag | vollständig übernommen |
Definitionseinträge#
Alle 42 historischen Identitäten bleiben Migrationsquellen. inventarisiert bedeutet: erhalten, nicht umgedeutet und erst durch ein eigenes kontrolliertes Work Item als eigenständiger Zieleintrag zu promovieren.
| ID | Begriff | Status |
|---|---|---|
| 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 | Artifact | inventarisiert |
| ART-DEF-0002 | GlossarbegriffDie artifactguid ist die stabile, globale und technische Identität eines Artefakts. Sie identifiziert das Artefakt dauerhaft und eindeutig, unabhängig von Dateiname, Ordner, Alias, Titel, Projektion oder Materialisierung. Eine GUID beschreibt das Artefakt, nicht seine Darstellung.Glossareintrag vollständig lesen | inventarisiert |
| GlossarbegriffDie Artifact ID ist die sprechende, menschenlesbare Identität eines Artefakts. In Markdown-Headern wird sie im Feld id geführt. Sie dient Kommunikation, Navigation, Reviews und lesbaren Referenzen. Sie ersetzt die artifactguid nicht. Beide Identitäten sind erforderlich und erfüllen unterschiedliche Zwecke.Glossareintrag vollständig lesen | Artifact ID | inventarisiert |
| ART-DEF-0004 | GlossarbegriffEin Artefakt existiert fachlich genau einmal im Universum der Engineering-Landschaft. Mehrfache Darstellungen, Verwendungen, Diagrammknoten, Runtime-Dateien, Reports oder Exportformate erzeugen keine weiteren Artefakte. Sie sind Referenzen, Views, Replikationen, Projektionen oder Materialisierungen derselben artifactguid.Glossareintrag vollständig lesen | inventarisiert |
| GlossarbegriffAttribute sind Eigenschaften eines Artefakts. Sie werden nicht automatisch als eigene Artefakte modelliert. Ein Button-Artefakt besitzt beispielsweise Label, Tooltip, Farbe, Icon, Aktion und Position. Ein System-Artefakt besitzt beispielsweise Titel, Beschreibung, Systemtyp, Status und Verantwortlichkeit. Ob ein Attribut direkt am Artefakt liegt oder dimensionsabhängige Attributwerte besitzt, wird fachlich je Attribut entschieden.Glossareintrag vollständig lesen | Attribute | inventarisiert |
| GlossarbegriffEine Dimension beschreibt eine Ausprägung eines Artefakts oder eines Attributwerts. Sprache ist keine Sonderbehandlung, sondern eine mögliche Dimension. Weitere mögliche Dimensionen sind Lifecycle, Version, Terminologie, Zielgruppe, Mandant, Sicherheitsklassifikation, Gültigkeit, Release, Region oder Produktvariante. Das Datenmodell darf nicht für jede neue Dimension spezialfallartig erweitert werden.Glossareintrag vollständig lesen | Dimension | inventarisiert |
| GlossarbegriffEine Relationship beschreibt eine fachliche oder technische Beziehung zwischen Artefakten. Sie erhält eine stabile eigene Relationship-Identität, wenn sie eigene Attribute, Status, Historie oder Governance trägt. Sie bleibt dabei ein eigenständiges UAM-Grundelement und wird nicht zu einem Artifact. Relationen bilden das Netzwerk der Engineering-Landschaft.Glossareintrag vollständig lesen | Relation | inventarisiert |
| GlossarbegriffEine Projektion ist eine fachliche Sicht auf ein Artefakt oder eine Artefaktmenge in einem bestimmten Kontext. Beispiele sind Diagramme, REST-Sichten, UI-Sichten, Suchsichten, Dokumentationssichten oder Release-Sichten. Projektionen erzeugen keine neue führende Artefaktidentität.Glossareintrag vollständig lesen | Projection | inventarisiert |
| ART-DEF-0009 | GlossarbegriffEine Materialisierung ist die technisch erzeugte und persistierte Darstellung einer Projektion. Beispiele sind JSON, HTML, Markdown, PDF, Suchindex, Diagrammdatei, Runtime-Ressource oder Report. Materialisierungen sind abgeleitet und dürfen fachlich nicht zum Single Point of Truth werden.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0010 | GlossarbegriffDie führende Quelle für fachliche Artefakte ist das Artefaktmodell beziehungsweise die Modellierungsdatenbank. Dateien, Reports, Runtime-Ressourcen und Exporte sind nur dann führend, wenn sie ausdrücklich als Quellartefakte des jeweiligen Arbeitsmodus definiert sind. Für die aktuelle Markdown-basierte Konzeptphase sind Markdown-Dateien das Austauschformat. Inhaltlich soll dennoch jede Definition nur einmal geführt und an anderer Stelle referenziert werden.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0011 | GlossarbegriffEine Runtime Resource ist eine materialisierte Laufzeitdarstellung freigegebener Artefakte oder Projektionen. Sie kann technisch als JSON, YAML, Resource-Bundle oder vergleichbare Datei vorliegen. Runtime Resources werden generiert, nicht manuell gepflegt.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0012 | GlossarbegriffEine Documentation Source ist die führende, manuell gepflegte Quelle einer Dokumentationsaussage oder Definition. Sie darf wiederverwendbare Definitionen referenzieren, soll sie aber nicht duplizieren.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0013 | GlossarbegriffEin Human Readable Report ist eine generierte, lesbare Ausgabe aus Documentation Sources und Artefaktreferenzen. Er kann für Menschen Definitionen auflösen, Links erzeugen und Kontextinformationen einbetten. Markdown kann sowohl Austauschformat als auch Reportformat sein. HTML ist der bevorzugte Zielkandidat für komfortables Lesen und Navigieren.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0014 | GlossarbegriffMarkdown ist in der Engineering-Landschaft ein Austausch-, Arbeits- und Reportformat. Es ist nicht die endgültige fachliche Quelle, sobald das Artefaktmodell als führende Modellierungsquelle verfügbar ist. Markdown-Dateien dürfen Artefaktreferenzen wie ART-DEF-0001 enthalten. Diese Referenzen bleiben stabil und werden erst in Reports, HTML-Ausgaben oder anderen Materialisierungen zu lesbaren Links oder eingebetteten Texten aufgelöst.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0015 | GlossarbegriffDer Documentation Publisher ist die Komponente, die Documentation Sources, Artefaktreferenzen, Navigation und Assets in menschenlesbare Reports materialisiert. Er ist fachlich Teil der Packaging-/Publishing-Architektur und wird technisch im Workspace, vorzugsweise über ns-cli, umgesetzt.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0016 | GlossarbegriffDer Reference Resolver löst stabile Artefaktreferenzen wie ART-DEF-0001, konkrete ADR-IDs oder spätere GUID-basierte Referenzen gegen das Artefaktmodell beziehungsweise den aktuellen Markdown-Arbeitsbestand auf. Er entscheidet nicht über HTML, PDF oder Markdown-Layout, sondern liefert aufgelöste Referenzinformationen an Renderer oder Publisher.Glossareintrag vollständig lesen | inventarisiert |
| GlossarbegriffEin Renderer erzeugt eine konkrete technische Ausgabeform aus einer vorbereiteten Dokumentationsprojektion. Beispiele sind HTML, PDF, Markdown, JSON oder ein Suchindex. Renderer enthalten keine fachlichen Artefaktdefinitionen. Sie materialisieren bereits aufgelöste Inhalte in ein Zielmedium.Glossareintrag vollständig lesen | Renderer | inventarisiert |
| GlossarbegriffEin Theme beschreibt die visuelle und strukturelle Gestaltung eines Reports, beispielsweise CSS, einfache JavaScript-Erweiterungen, Navigation, Logo, Schriftgrößen oder Farbdefinitionen. Themes ändern nicht die fachliche Aussage der Dokumentation. Sie betreffen ausschließlich die Darstellung der Materialisierung.Glossareintrag vollständig lesen | Theme | inventarisiert |
| GlossarbegriffDas Write Model ist die fachlich führende Quelle veränderbarer Informationen. Hier entsteht und ändert sich fachliche Wahrheit über die dokumentierten Schreibpfade des jeweiligen Owners. Das Write Model ist ein fachlicher Architekturbegriff und kein konkretes Datenbankprodukt.Glossareintrag vollständig lesen | Write Model | inventarisiert |
| ART-DEF-0020 | GlossarbegriffOperativ persistierter Zustand wird für Betrieb, Synchronisation, Verarbeitung, Nachvollziehbarkeit oder Wiederaufnahme dauerhaft geführt, ist aber keine fachliche Wahrheit des Write Models. Er kann eine eigene operative Identität und einen eigenen Lebenszyklus besitzen.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0021 | GlossarbegriffEphemerer Runtime State unterstützt eine laufende Interaktion oder Sitzung und darf ohne Verlust bestätigter fachlicher Wahrheit ablaufen oder verloren gehen. Presence, Cursor und kurzfristige Sitzungszustände sind typische Beispiele.Glossareintrag vollständig lesen | inventarisiert |
| GlossarbegriffEin Cache ist ein technischer Beschleunigungsmechanismus für Inhalte aus einer bestehenden Zustandsklasse. Er ist keine eigenständige fachliche Zustandsklasse und darf keine konkurrierende fachliche Wahrheit erzeugen.Glossareintrag vollständig lesen | Cache | inventarisiert |
| ART-DEF-0023 | GlossarbegriffEin 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.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0024 | GlossarbegriffDie fachliche Heimat ist das genau eine primäre Themenfeld, das Verantwortung, Pflege und bevorzugten fachlichen Einstieg eines Glossareintrags bestimmt. Weitere Themenfelder dürfen zusätzliche Verwendungskontexte sichtbar machen, erzeugen aber keine zweite Heimat.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0025 | GlossarbegriffEine semantische Glossarreferenz verweist stabil auf die Identität und Bedeutung eines Glossareintrags. Sie legt nicht fest, ob eine Ausgabe daraus einen Link, eine Kurzdefinition, eine Fußnote, ein Popover oder eine andere Darstellung erzeugt.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0026 | SQLite | inventarisiert |
| ART-DEF-0027 | Write-Ahead Logging (WAL) | inventarisiert |
| ART-DEF-0028 | GlossarbegriffVersionierte Zusammenstellung eines bekannten Universe-Zustands mit Artefaktidentitäten, Beziehungen, Issues, Eingangsständen und Validierungsergebnis.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0029 | GlossarbegriffZentrale Autorität für universumsweit eindeutige Artefaktidentitäten, GUIDs, referenzierbare Aliase und führende Quellen.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0030 | GlossarbegriffMinimierter, versionierter Arbeitskontext aus betroffenen Artefakten, Repository-Katalogen und der erforderlichen Dependency Closure.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0031 | GlossarbegriffAbgeschlossene Menge aller Artefakte und Repositorys, die für eine konkrete Prüfung oder Bearbeitung aufgrund ihrer Abhängigkeiten benötigt werden.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0032 | GlossarbegriffIssue-Zustand für ein derzeit nicht auflösbares Ziel, das durch ein noch nicht bereitgestelltes Repository oder Artefakt nachgeliefert werden kann.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0033 | GlossarbegriffErneute, zustandsbasierte Bewertung des Universe Catalogs und seiner Issues nach geänderten oder nachgelieferten Eingängen.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0034 | GlossarbegriffMedienneutrale, validierte und bereits aufgelöste Dokumentprojektion, die einem Renderer zur Darstellung übergeben wird.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0035 | GlossarbegriffDidaktisches Wissensartefakt, das ein Architektur- oder Technikthema verständlich erklärt, ohne normative Architekturregeln zu ersetzen.Glossareintrag vollständig lesen | inventarisiert |
| ART-DEF-0036 | Processing Annotation | inventarisiert |
| ART-DEF-0037 | Review Annotation | inventarisiert |
| ART-DEF-0038 | Todo Annotation | inventarisiert |
| ART-DEF-0039 | Canonical Reference Target | inventarisiert |
| ART-DEF-0040 | Non-installable Package | inventarisiert |
| ART-DEF-0041 | Report Package | inventarisiert |
| ART-DEF-0042 | GlossarbegriffEin Architecture Compliance Contract verbindet eine Architekturregel mit konkreten Implementierungs- und Testnachweisen.Glossareintrag vollständig lesen | inventarisiert |
Vollständigkeitsurteil#
- Vertragsquellen disponiert: 11/11
- historische Definitionseinträge inventarisiert: 42/42
- geänderte historische Definitionen: 0
- ungesteuert verworfene Vertragsregeln: 0