Netzwerksolution Documentation Report

README

Runtime#

Konkrete Laufzeitzustände für Test und Produktion.

Repository-Klassifikation#

Verantwortung: Owns materialized test and production runtime structure, configuration locations and mutable runtime state boundaries.

Die Klassifikation richtet sich nach der kanonischen Repository-Verantwortung. Anforderungen anderer Repository-Klassen werden nicht implizit übernommen.

Menschlicher und technischer Einstieg#

Für einen bedeutungsorientierten Überblick veröffentlicht der lokale Runtime- Roundtrip den Einstieg unter /reports/. Engineering Tools rendert diese Seite; Runtime materialisiert sie mitsamt auswählbaren Codeansichten und verlinkter Evidenz. Die gespeicherte Semantische Runtime-Übersicht bleibt der nachvollziehbare Quellstand der Veröffentlichung.

Für technische Arbeit bleiben Verantwortungsgrenze, Validierung und die einzelnen Reports unter reports/ die führenden Einstiege.

Der praktische Ablauf von GAP-Arbeitspaket, Import, Report-Neuaufbau, Test und getrennten Produktionspromotionen steht in der Betriebssicht.

Die Verantwortung und Übergänge zwischen ChatGPT-Arbeitsumgebung, lokalem TUXEDO-Rechner und öffentlicher Betriebsumgebung stehen in der Aktiven Deployment-Landschaft.

Die getrennten Produktionsziele, Prüfgates und Sicherheitsgrenzen beschreibt PRODUCTION_PROMOTION.md. Der Vertrag enthält keine Zugangsdaten und startet keine Online-Promotion.

Vollständiger Report-Neuaufbau#

ist der lokale Einstieg für einen vollständigen Neuaufbau. Er rendert alle übergebenen Repositorys und optionale Workspace-Building-Blocks zuerst in einer Staging-Wurzel. Erst nach der Materialisierung des semantischen Einstiegs und erfolgreicher Linkprüfung wird web/reports atomar ersetzt und anschließend in die Web-Wurzel der lokalen Testinstallation veröffentlicht. Bei einem Fehler bleibt der vorherige Stand des jeweils betroffenen Veröffentlichungziels unverändert. Nach erfolgreichem Engineering-Platform-Deployment ist der Testeinstieg http://localhost:18082/reports/. Mit --skip-test-publication lässt sich ausdrücklich nur die Quellveröffentlichung web/reports erneuern.

python3 ~/engineering/runtime/bin/rebuild-documentation-reports.py \
                  --engineering-tools-root ~/engineering/engineering-tools \
                  --enterprise-architecture-root ~/engineering/enterprise-architecture \
                  --solution-architecture-root ~/engineering/solution-architecture \
                  --workspace-root ~/netzwerksolution/workspace

--workspace-root ist ausschließlich eine explizite Inhaltsquelle für den Übergangsbestand; der Runtime-Befehl importiert keine Workspace-Pythonmodule. Wenn dort ../SolutionArchitecture vorhanden ist, verwendet der Befehl diese vollständige historische Solution Architecture zusätzlich und zuerst als Übergangsquelle. Sie kann bei Bedarf mit --legacy-solution-architecture-root explizit gesetzt werden. Ist neben Engineering Tools ein Verzeichnis engineering-platform vorhanden, wird es ebenfalls automatisch veröffentlicht; alternativ kann es mit --engineering-platform-root explizit angegeben werden.

GAP-Aktivierung#

Die sichere lokale Aktivierung und Versionierung heruntergeladener GAP-ZIPs ist in GAP_AKTIVIERUNG.md beschrieben. Sie löst seit SE-0039A eine eindeutig timestamp-präfixierte Datei im Importer-Ordner downloads/processed auf, wenn kein exakter Pfad vorliegt.

Repository-ZIP-Erzeugung#

Lokale Konfiguration und Aufruf sind in ZIP_ERZEUGUNG.md beschrieben. Die wiederverwendbare Implementierung verbleibt in engineering-tools.

Changed-only-Roundtrip-Import#

Die lokale Orchestrierung ist in ROUNDTRIP_IMPORT.md beschrieben.

GAP-Arbeitspaket#

Die automatische Orchestrierung des Zwei-Archiv-Arbeitspakets ist in ARBEITSPAKET.md beschrieben. liest Sources und Targets aus dem aktiven GAP und erzeugt ohne sprintbezogene Konfigurationsarbeit ein neues, eindeutig benanntes Uploadverzeichnis. Die wiederverwendbare Erzeugungs- und Validierungslogik verbleibt in engineering-tools.

Der vollständige Menschen-Einstieg aus verarbeitetem Download, sicherer GAP-Aktivierung und anschließender Paketerzeugung ist in AUTOMATISCHE_ROUNDTRIP_VORBEREITUNG.md dokumentiert und wird mit ausgeführt.

Der reproduzierbare Alt/Neu-Migrationsvergleich ist in PAKETGLEICHWERTIGKEIT.md beschrieben.

Seit SE-0012 ist der Vergleich historische Migrationsevidence. Aktive Repository-ZIP-Mengen für bestehende Fehleraufrufer werden lokal über orchestriert und ausschließlich durch die kanonische Implementierung in engineering-tools erzeugt.

Die operative Markdown-Textbaseline und ihre Abgrenzung von kanonischer Semantik stehen in reports/SE-0019-runtime-textbaseline.md.

Der nichtkanonische Runtime-Snapshot des Wissensstands steht im SE-0021-Knowledge-Dashboard.

↑