Netzwerksolution Documentation Report

ET-WS-MIGRATION-INVENTORY-001

Workspace-Migrationsinventar#

Geltung und Grenze#

Dieses Inventar bezieht sich ausschließlich auf das unverändert eingelesene workspace(14).zip. Es dokumentiert Quellpfade und Migrationskandidaten, ist aber keine Migration und keine Zielarchitekturentscheidung. Die seit SE-0012 stillgelegte Workspace-Prozesskette wird dadurch nicht reaktiviert.

Dokumentation und Reporting#

Historische Komponente Aufgabe und belegte Abhängigkeit Klassifikation Zielkandidat Testbezug / Stilllegungsvoraussetzung
tools/documentation_pipeline.py, `tools/ns/documentation/[[ART-DEF-0053 discovery]].py, ` Markdown-Inventur, Header-/Referenzprüfung und Verarbeitung von [[…]] migrieren Engineering Tools Referenz-, Link- und Build-Tests müssen die bekannten Fälle abdecken.
tools/ns/documentation/resolver.py, Priorisierte Auflösung von ID, GUID und Alias zu relativen HTML-Zielen migrieren Engineering Tools Kein veröffentlichter href darf einen repository-qualifizierten Rohwert enthalten.
tools/ns/documentation/knowledge.py, `[[ART-DEF-0017 renderer]].py, themes/default/report.css` Glossar- und Learning-Nugget-Präsentation: Vorschau, details, Fokus, Klick und Touch migrieren Engineering Tools Gleichwertige Interaktion für Glossar, und ein weiteres Spezialelement.
tools/ns/documentation/annotations.py und tools/ns/documentation_annotations.py Todo-/Review-Marker als Inline- und Blockelemente migrieren Engineering Tools Marker bleiben semantisch sichtbar und werden nicht als Artefaktlink fehlinterpretiert.
tools/ns/documentation/navigation.py, , , , Navigation, Verteilung, Plattformregister und Report-/Dashboard-Aufbau Entscheidung erforderlich Engineering Tools + Runtime Erst nach Abgleich mit bestehendem und Runtime-Materialisierung.
tools/documentation_roundtrip.py Vollständiger Plattform-Neuaufbau; ruft Workspace-Pipeline auf und delegiert anschließend den /reports/-Einstieg Adapter belassen bis ersetzt Runtime-Adapter + Engineering Tools Neuer Roundtrip muss ohne diesen Workspace-Aufruf vollständig reproduzierbar sein.

Roundtrip und Umgebung#

Historische Komponente Klassifikation Begründung
tools/ns/workpackage/generator.py, tools/workspace-assembler.sh, tools/workspace-drift-check.py Entscheidung erforderlich Sie berühren Paketbildung, Arbeitskopien und lokale Pfade; der heutige GAP-Work-Package-Mechanismus liegt bereits in Engineering Tools/Runtime. Nur belegte Restlücken werden migriert.
`tools/[[EA-GLOSS-RELEASE-001 release]]/, tools/validator/, tools/repository-validator/*` historisch archivieren oder Entscheidung erforderlich Kein automatischer Umzug: zuerst Überschneidung mit den vorhandenen Engineering-Tools-Verträgen und Validatoren nachweisen.
tools/ns/universe/* Entscheidung erforderlich Eigenständige lokale Registry; keine Report-Pipeline und keine implizite Runtime-Persistenz.

Reproduzierbarer HTML-Befund#

Das vorgelegte veröffentlichte Dokument enthält beispielsweise:

<a href="enterprise-architecture:98-glossary/entries/ART-DEF-0043-Evidence.html">Evidence</a>

Dieser Wert ist kein browserfähiges relatives HTML-Ziel. Er trägt außerdem weder data-artifact-ref noch einen Typ oder eine Vorschau. Im historischen Renderer wird eine aufgelöste Glossar- oder Nugget-Referenz dagegen als knowledge-reference mit Tooltip, details-Panel, erreichbarem Voll-Link und Tastaturfokus erzeugt. Normale Artefakte erhalten mindestens einen artifact-ref mit relativem href.

Damit sind drei reproduzierbare Fehlklassen festgehalten:

  1. Glossar: Roh-href statt aufgelöstem Wissenverweis und Vorschau.
  2. Learning Nugget: derselbe fehlende Knowledge-Pfad; daher keine

Kurzfassung und keine Klick-/Touch-Detailansicht.

  1. Spezialelement Todo/Review: die alte Pipeline kennt eigene

processing-annotation-Elemente; ein bloßer Link kann diese nicht transportieren.

SQLite-/WAL-Befund#

tools/ns/universe/store.py implementiert eine lokale SQLite-Universe-Registry mit den Tabellen metadata, repositories, artifacts, artifact_materializations, aliases, artifact_references und issues. Sie aktiviert Foreign Keys und PRAGMA journal_mode = WAL; Änderungen laufen über BEGIN IMMEDIATE. snapshot.py schreibt und restauriert versionierte JSON-Snapshots, während cli.py die Befehle init, import, issues, reconcile, snapshot und restore bereitstellt.

Im gelieferten Workspace liegt keine Datenbankdatei, kein -wal und kein -shm vor. Die Registry ist damit eine Implementierung mit lokalem, reproduzierbarem Laufzustand, nicht ein zu migrierender Datenbestand. Ob sie als Runtime-Persistenz benötigt wird, entscheidet erst SE-0078 einschließlich Schema, Backup, Recovery, Datenschutz und Eigentum.

Folgegrenze#

SE-0073 legt Zielverantwortungen erst nach diesem Inventar fest. Insbesondere werden weder die alte Publisher-Implementierung noch SQLite pauschal kopiert.

↑