README
Reference Artifact#
Definition#
Ein 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 ist eine kanonische semantische Beschreibung eines dauerhaft identifizierbaren Konzepts. Es besitzt GlossarbegriffBedeutung beschreibt den fachlichen Sinn eines Elements und seine Relevanz für Menschen und Organisationen.Glossareintrag vollständig lesen unabhängig davon, ob es als Markdown, Datenbankeintrag, JSON, UI-Element oder in anderer Form materialisiert wird.
Mindestinhalt#
- kanonische Identität und Name
- Zweck und Kontext
- fachliche Verantwortlichkeit
- Geltungsbereich und Ausschlüsse
- Eigenschaften und Beziehungen
- Regeln beziehungsweise Invarianten
- Lebenszyklus und Versionierung
- bekannte Materialisierungen
- Provenienz und führende Quelle
Materialisierung#
Die technische Form wird nicht hier festgeschrieben. Engineering Tools dürfen mehrere Templates und Materialisierer anbieten, solange sie dieselbe semantische Quelle nachvollziehbar abbilden.
Änderungsregel#
Änderungen an der Bedeutung werden als Architekturänderung behandelt. Reine Format- oder Darstellungsänderungen gehören zur technischen Materialisierung.