Glossarbegriffe erklären Begriffe. Learning Nuggets vermitteln Zusammenhänge. Die Übersicht wird vollständig aus den vorhandenen Wissensartefakten generiert.
Die Symbole ordnen ein Wissenselement ein. Die englischen Schlüssel bleiben für Verträge und Übersetzungen stabil; die deutsche Bezeichnung ist die primäre Lesesprache.
meaningartifactrelationshipcontext-timeDie 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.
Ein 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.
Eine 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.
Der Documentation Publisher ist die Komponente, die Documentation Sources, Artefaktreferenzen, Navigation und Assets in menschenlesbare Reports materialisiert.
Eine Documentation Source ist die führende, manuell gepflegte Quelle einer Dokumentationsaussage oder Definition. Sie darf wiederverwendbare Definitionen referenzieren, soll sie aber nicht duplizieren.
Ein 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 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.
Medienneutrale, validierte und bereits aufgelöste Dokumentprojektion, die einem Renderer zur Darstellung übergeben wird.
Der 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.
Ein Renderer erzeugt eine konkrete technische Ausgabeform aus einer vorbereiteten Dokumentationsprojektion. Beispiele sind HTML, PDF, Markdown, JSON oder ein Suchindex.
Ein Theme beschreibt die visuelle und strukturelle Gestaltung eines Reports, beispielsweise CSS, einfache JavaScript-Erweiterungen, Navigation, Logo, Schriftgrößen oder Farbdefinitionen.
Didaktisches Wissensartefakt, das ein Architektur- oder Technikthema verständlich erklärt, ohne normative Architekturregeln zu ersetzen.
Ein ADR (Architecture Decision Record) dokumentiert eine Architekturentscheidung mit ihrem Kontext, ihrer Begründung und ihren Folgen.
Ein Architecture Compliance Contract verbindet eine Architekturregel mit konkreten Implementierungs- und Testnachweisen.
Technical documentation artifact.
Bedeutung beschreibt den fachlichen Sinn eines Elements und seine Relevanz für Menschen und Organisationen.
Eine Beziehung beschreibt eine nachvollziehbare Verbindung zwischen Bedeutungen, Artefakten und ihrem Kontext.
Ein Building Block ist ein abgegrenzter Baustein mit stabiler Verantwortung zur Realisierung von Capabilities.
Eine Capability beschreibt ein dauerhaft benötigtes fachliches Leistungsvermögen, nicht dessen technische Umsetzung.
Code ist eine ausführbare oder interpretierbare technische Realisierung, die durch Tests und Runtime-Evidence überprüfbar bleibt.
Technical documentation artifact.
Technical documentation artifact.
Technical documentation artifact.
Bezeichnet die Capability zur kontrollierten technischen Ausführung und Nachweisführung, ohne die universelle Execution-Semantik zu ersetzen.
Ein Feature ist eine abgegrenzte, nutzbare und lieferbare Ausprägung einer Lösung.
Technical documentation artifact.
Technical documentation artifact.
Git ist das verwendete Versionsverwaltungssystem für nachvollziehbare Änderungsgeschichte.
Technical documentation artifact.
Technical documentation artifact.
Kontext und Zeitbezug beschreiben, unter welchen Bedingungen und zu welchem Zeitpunkt eine Aussage oder Evidence gilt.
Ein Ledger ist eine versionierte, menschenlesbare Ergänzung für ausgewählte Beziehungen.
Ein Metamodell beschreibt die zulässigen Kategorien, Eigenschaften und Beziehungen, mit denen Wissen modelliert wird.
Ein MVP ist eine kleinste überprüfbare Materialisierung mit bewusst begrenztem Umfang.
Ein Plateau ist ein zeitlich eingeordneter, freigegebener Reife- oder Materialisierungsstand.
Technical documentation artifact.
Technical documentation artifact.
Provenienz beschreibt die nachvollziehbare Herkunft eines Wissenselements, einer Aussage oder einer abgeleiteten Darstellung.
Ein Release ist ein bewusst freigegebener und nachvollziehbarer Stand von Artefakten und ihrer Realisierung.
Technical documentation artifact.
Ein Service ist eine abgegrenzte bereitgestellte technische oder fachliche Leistung mit klarer Verantwortung.
Technical documentation artifact.
supersedes bedeutet: Ein neuer Stand löst einen früheren Stand explizit ab.
Technical documentation artifact.
Eine Vision beschreibt eine langfristig gewünschte Wirkung und gibt der Weiterentwicklung eine gemeinsame Richtung.
Technical documentation artifact.
Ein 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.
Ephemerer 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.
Operativ 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.
Eine Runtime Resource ist eine materialisierte Laufzeitdarstellung freigegebener Artefakte oder Projektionen. Sie kann technisch als JSON, YAML, Resource-Bundle oder vergleichbare Datei vorliegen.
Das 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.
Ein Artefakt ist jede eindeutig identifizierbare fachliche, technische, organisatorische oder reale Einheit, die in der Engineering-Landschaft modelliert wird.
Die 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.
Die Artifact ID ist die sprechende, menschenlesbare Identität eines Artefakts. In Markdown-Headern wird sie im Feld id geführt.
Attribute sind Eigenschaften eines Artefakts. Sie werden nicht automatisch als eigene Artefakte modelliert.
Eine Dimension beschreibt eine Ausprägung eines Artefakts oder eines Attributwerts. Sprache ist keine Sonderbehandlung, sondern eine mögliche Dimension.
Eine Materialisierung ist die technisch erzeugte und persistierte Darstellung einer Projektion.
Eine Projektion ist eine fachliche Sicht auf ein Artefakt oder eine Artefaktmenge in einem bestimmten Kontext.
Eine 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.
Ein Artefakt existiert fachlich genau einmal im Universum der Engineering-Landschaft. Mehrfache Darstellungen, Verwendungen, Diagrammknoten, Runtime-Dateien, Reports oder Exportformate erzeugen keine weiteren Artefakte.
Die 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.
Zentrale Autorität für universumsweit eindeutige Artefaktidentitäten, GUIDs, referenzierbare Aliase und führende Quellen.
Abgeschlossene Menge aller Artefakte und Repositorys, die für eine konkrete Prüfung oder Bearbeitung aufgrund ihrer Abhängigkeiten benötigt werden.
Minimierter, versionierter Arbeitskontext aus betroffenen Artefakten, Repository-Katalogen und der erforderlichen Dependency Closure.
Versionierte Zusammenstellung eines bekannten Universe-Zustands mit Artefaktidentitäten, Beziehungen, Issues, Eingangsständen und Validierungsergebnis.
Issue-Zustand für ein derzeit nicht auflösbares Ziel, das durch ein noch nicht bereitgestelltes Repository oder Artefakt nachgeliefert werden kann.
Erneute, zustandsbasierte Bewertung des Universe Catalogs und seiner Issues nach geänderten oder nachgelieferten Eingängen.
Ein SourceDocument enthält noch nicht alle für eine Ausgabe benötigten, medienneutralen Auflösungen. Das ProcessedDocument bündelt aufgelöste Referenzen, semantische Annotationen und Validierungsergebnisse vor dem Rendering.
Renderer entscheiden über die technische Ausgabeform. Würden sie zusätzlich Begriffe, Identitäten und Beziehungen auflösen, entstünden für HTML, PDF und andere Medien konkurrierende Wahrheiten.
Erklärt die Trennung zwischen stabiler semantischer Begründung und lokalisierter Darstellung.
Erklärt, warum ein Reason Code erst zusammen mit Kontext, Wissen und Evidenz eine belastbare Explanation bildet.
Ein Architekturtext ist wie eine Bauordnung: Er beschreibt, was gelten soll. Ein Test ist wie eine konkrete Abnahme am Gebäude. Dazwischen braucht es eine Prüfliste, die sagt, welche Regel an welcher Stelle und mit welchem Nachweis kontrolliert wird.
Ein Paket kann wie ein Paket aussehen und trotzdem etwas völlig anderes wollen. Ein Möbelkarton enthält Teile, die eingebaut werden sollen. Ein Prüfbericht im Umschlag enthält dagegen Informationen über das Möbelstück. Niemand würde den Prüfbericht in den Schrank einbauen. Genauso verändern SolutionArchitecture-, Workspace- und Patch-Pakete einen Zielzustand. Cleanup- und Verifikationsberichte erklären nur, was geprüft wurde oder noch zu tun ist.
Ein Buch bleibt dasselbe Buch, auch wenn es als Hardcover, E-Book und PDF vorliegt. Die Ausgaben sind unterschiedliche Materialisierungen, aber sie beschreiben nicht drei verschiedene Werke. Genauso kann ein Artefakt in der Engineering-Landschaft als Markdown-Quelle, HTML-Seite, PDF oder historische Kopie erscheinen. Die Referenz zeigt fachlich auf die eine Artefaktidentität. Erst danach wird entschieden, welche Darstellung für den aktuellen Zweck verwendet wird.
Eine Artefaktreferenz sagt: „Dieses andere Artefakt ist gemeint.“ Eine Todo- oder Review-Annotation sagt: „An dieser Stelle ist Arbeit nötig.“ Beide verwenden sichtbare Marker, erfüllen aber völlig unterschiedliche Aufgaben.
Git ist sehr gut darin, bestätigte textbasierte Zustände nachvollziehbar zu versionieren. Es ist jedoch kein Transaktionssystem für jeden einzelnen Laufzeitschritt einer Registry.
SQLite speichert eine relationale Datenbank in einer Datei. Im WAL-Modus werden Änderungen zunächst in ein separates Write-Ahead Log geschrieben. Dadurch bleibt ein abgeschlossener Zustand auch bei einem Prozess- oder Rechnerabbruch rekonstruierbar.
Transparenz, gemeinsames Lagebild und rollenbezogener Kontext
Kommunikation ohne fachliche Heimat
Arbeitsartefakte, Ideen und Rückführung in die fachliche Heimat
Vom sichtbaren Ergebnis her denken
Gelebte Prozesse und Wissen der Menschen in der Produktion
Technisches Dokumentations-Artifact.
Praxiserfahrung zur gemeinsamen Wissensquelle für Architektur-, Betriebs-, Incident-, Problem- und Release-Dokumentation.
Erkenntnis aus der Vertiefung des State Models und der Klärung des Snapshot-Begriffs.
Repositorys sind Ablage- und Ownership-Kontexte, aber keine getrennten Identitätsräume. Ein Artefakt bleibt dasselbe Artefakt, auch wenn es in mehreren Projektionen oder Materialisierungen erscheint.
Eine Referenz kann vorübergehend nicht auflösbar sein, weil das zuständige Repository noch nicht eingespielt wurde. Das ist ein unvollständiger Universe-Zustand, nicht automatisch ein fachlicher Fehler.
Erklärt, warum Architektur durch semantische Konsolidierung stabil wächst.
Technisches Dokumentations-Artifact.