Netzwerksolution Documentation Report

NUG-0008-WARUM-MEHRERE-MATERIALISIERUNGEN-NUR-EIN-REFERENZZIEL-HABEN

Warum mehrere Materialisierungen nur ein Referenzziel haben#

Enterprise Solution Engineering Runtime Beziehung: folgt diesem Vertrag; Pfeilrichtung: NUG-0008-WARUM-MEHRERE-MATERIALISIERUNGEN-NUR-EIN-REFERENZZIEL-HABEN → LEARNING-NUGGET-CONTRACTfolgt diesem Vertrag Learning-Nugget-Vertrag — Bedeutung (meaning) · EnterpriseBedeutung (meaning)Learning-Nugget-Vertrag Beziehung der zweiten Ebene: folgt diesem Vertrag; Pfeilrichtung: LN-0001-AI-REPOSITORY-UPLOAD-STRUCTURE → LEARNING-NUGGET-CONTRACTfolgt diesem Vertrag Beziehung der zweiten Ebene: folgt diesem Vertrag; Pfeilrichtung: LN-ARCH-001 → LEARNING-NUGGET-CONTRACTfolgt diesem Vertrag Beziehung der zweiten Ebene: folgt diesem Vertrag; Pfeilrichtung: EA-LN-EXP-001 → LEARNING-NUGGET-CONTRACTfolgt diesem Vertrag Beziehung der zweiten Ebene: folgt diesem Vertrag; Pfeilrichtung: EA-LN-EXP-002 → LEARNING-NUGGET-CONTRACTfolgt diesem Vertrag Beziehung der zweiten Ebene: folgt diesem Vertrag; Pfeilrichtung: LN-OBS-001-SYSTEMS-MUST-EXPLAIN-THEMSELVES → LEARNING-NUGGET-CONTRACTfolgt diesem Vertrag Beziehung der zweiten Ebene: folgt diesem Vertrag; Pfeilrichtung: LN-TEST-001-TESTS-AS-EXECUTABLE-SPECIFICATION → LEARNING-NUGGET-CONTRACTfolgt diesem Vertrag Beziehung der zweiten Ebene: folgt diesem Vertrag; Pfeilrichtung: LN-TEST-002-HAPPY-PATH-IS-NOT-A-SAFETY-NET → LEARNING-NUGGET-CONTRACTfolgt diesem Vertrag Beziehung der zweiten Ebene: folgt diesem Vertrag; Pfeilrichtung: LN-TEST-003-BOUNDARIES-CONCURRENCY-AND-TRANSACTIONS → LEARNING-NUGGET-CONTRACTfolgt diesem Vertrag Beziehung der zweiten Ebene: folgt diesem Vertrag; Pfeilrichtung: NUG-0001-WARUM-SQLITE-MIT-WAL → LEARNING-NUGGET-CONTRACTfolgt diesem Vertrag Beziehung der zweiten Ebene: folgt diesem Vertrag; Pfeilrichtung: NUG-0002-WARUM-GIT-NUR-FUER-VALIDIERTE-SNAPSHOTS → LEARNING-NUGGET-CONTRACTfolgt diesem Vertrag Beziehung der zweiten Ebene: folgt diesem Vertrag; Pfeilrichtung: NUG-0003-WARUM-ARTEFAKT-IDS-UNIVERSUMSWEIT-EINDEUTIG-SIND → LEARNING-NUGGET-CONTRACTfolgt diesem Vertrag Beziehung der zweiten Ebene: folgt diesem Vertrag; Pfeilrichtung: NUG-0004-WARUM-PENDING-INPUT-KEIN-KAPUTTER-LINK-IST → LEARNING-NUGGET-CONTRACTfolgt diesem Vertrag Beziehung der zweiten Ebene: folgt diesem Vertrag; Pfeilrichtung: NUG-0005-WARUM-EIN-PROCESSED-DOCUMENT-BENOETIGT-WIRD → LEARNING-NUGGET-CONTRACTfolgt diesem Vertrag Beziehung der zweiten Ebene: folgt diesem Vertrag; Pfeilrichtung: NUG-0006-WARUM-RENDERER-KEINE-SEMANTIK-AUFLOESEN → LEARNING-NUGGET-CONTRACTfolgt diesem Vertrag Beziehung der zweiten Ebene: folgt diesem Vertrag; Pfeilrichtung: NUG-0007-WARUM-TODO-UND-REVIEW-KEINE-LINKS-SIND → LEARNING-NUGGET-CONTRACTfolgt diesem Vertrag Beziehung der zweiten Ebene: folgt diesem Vertrag; Pfeilrichtung: NUG-0009-WARUM-BERICHTE-KEINE-INSTALLATIONSPAKETE-SIND → LEARNING-NUGGET-CONTRACTfolgt diesem Vertrag Beziehung der zweiten Ebene: folgt diesem Vertrag; Pfeilrichtung: NUG-0010-WARUM-ARCHITEKTUR-COMPLIANCE-EXPLIZITE-VERTRAEGE-BRAUCHT → LEARNING-NUGGET-CONTRACTfolgt diesem Vertrag Beziehung der zweiten Ebene: verwendet diese kanonische Struktur; Pfeilrichtung: LEARNING-NUGGET-CONTRACT → LEARNING-NUGGET-TEMPLATEverwendet diese kanon… Beziehung der zweiten Ebene: folgt dem Wissensevolutionsprozess; Pfeilrichtung: LEARNING-NUGGET-CONTRACT → RP-KNOWLEDGE-EVOLUTIONfolgt dem Wissensevol… Beziehung der zweiten Ebene: leitet sich aus Explainability, Knowledge, Evidence and Learning ab; Pfeilrichtung: LEARNING-NUGGET-CONTRACT → EA-SEMANTICS-EKEL-001leitet sich aus Expla… Reason Codes sind keine vollständigen Erklärungen — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)Reason Codes sindkeine vollständigen… Lokalisierung darf den Grund nicht verändern — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)Lokalisierung darfden Grund nicht ver… Erklärbarkeits-, Wissens-, Evidence- und Lernstruktur — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)Erklärbarkeits-,Wissens-, Evidence-… Learning-Nugget-Vorlage — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)Learning-Nugget-Vorlage Learning Nugget – Strukturierung von Repository-Uploads für KI-gestützte Engineering-Aufgaben — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)Learning Nugget –Strukturierung von … Architektur wächst durch Konsolidierung — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)Architektur wächstdurch Konsolidierung LN-OBS-001 – Systeme müssen sich selbst erklären — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)LN-OBS-001 – Systememüssen sich selbst … LN-TEST-001 – Tests als ausführbare Spezifikation — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)LN-TEST-001 – Testsals ausführbare Spe… LN-TEST-002 – Der Happy Path ist kein Sicherheitsnetz — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)LN-TEST-002 – DerHappy Path ist kein… LN-TEST-003 – Grenzwerte, Nebenläufigkeit und Transaktionen — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)LN-TEST-003 –Grenzwerte, Nebenlä… Warum SQLite mit WAL? — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)Warum SQLite mitWAL? Warum Git nur für validierte Snapshots? — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)Warum Git nur fürvalidierte Snapshot… Warum Artefakt-IDs universumsweit eindeutig sind — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)Warum Artefakt-IDsuniversumsweit eind… Warum Pending Input noch kein kaputter Link ist — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)Warum Pending Inputnoch kein kaputter … Warum ein ProcessedDocument benötigt wird — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)Warum einProcessedDocument b… Warum Renderer keine Semantik auflösen — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)Warum Renderer keineSemantik auflösen Warum Todo und Review keine Links sind — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)Warum Todo undReview keine Links … Warum Berichte keine Installationspakete sind — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)Warum Berichte keineInstallationspakete… Warum Architektur-Compliance explizite Verträge braucht — zweite Beziehungsebene, Bedeutung (meaning) · EnterpriseBedeutung (meaning)WarumArchitektur-Complia… Wissensevolutionsprozess — zweite Beziehungsebene, Kontext & zeitliche Einordnung (context-time) · EnterpriseKontext & zeitliche Einordnung (context-time)Wissensevolutionsprozess Warum mehrere Materialisierungen nur ein Referenzziel haben — Bedeutung (meaning) · Enterprise. Strukturkontext öffnen.Bedeutung (meaning)Warum mehrereMaterialisierungen nur e…
Übersicht · 2: zweite Ebene · Ziehen/Klicken: navigieren

Kurzfassung#

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.

Warum die frühere Mehrdeutigkeit entstand#

Der Architecture Definition Catalog enthielt Überschriften wie [ART-DEF-0001](historical:ART-DEF-0001). Später entstand zusätzlich ein eigenständiger Glossary Entry mit derselben ID. Ein einfacher Parser sah zwei Dateien und meldete Mehrdeutigkeit.

Fachlich existierte aber nur ein Glossarbegriff. Der Catalog war die Migrationsquelle, der eigenständige Entry das kanonische Artefakt.

Die Lösung#

Der Resolver bewertet die Herkunft eines Ziels:

  1. eigenständiges Artefakt mit expliziter ID,
  2. Alias dieses Artefakts,
  3. eingebettete Definition in einem Catalog als Fallback.

So bleibt die Historie erhalten, ohne die aktuelle Wissensstruktur unbrauchbar zu machen.

Wichtig#

Die Regel darf keine echten Identitätskonflikte verstecken. Zwei eigenständige Artefakte mit derselben ID und unterschiedlichen GUIDs bleiben ein harter Fehler.

Verbindliche Regeln: CON-023-ARTIFACT-REFERENCE-RESOLUTION-STRATEGY und ADR-0043-CANONICAL-ARTIFACT-REFERENCE-RESOLUTION.

Migrationsherkunft#

Dieses Learning Nugget wurde aus SolutionArchitecture:85-knowledge/20-learning-nuggets/NUG-0008-WARUM-MEHRERE-MATERIALISIERUNGEN-NUR-EIN-REFERENZZIEL-HABEN.md für die Enterprise-Ebene konsolidiert. Historische Contract-, ADR- und Glossarreferenzen bleiben als Provenienz sichtbar; sie werden nicht als aktuelle Enterprise-Definitionen interpretiert.

Beziehungen#

↑