RUNTIME-BETRIEBSSICHT-001

Betriebssicht – vom Arbeitsauftrag bis zur öffentlichen Seite#

Wofür diese Seite da ist#

Hier steht der praktische Bedienweg. Die Erklärung, warum die Schritte voneinander getrennt sind, bleibt in enterprise-architecture:20-vision/SE-0119-enterprise-bis-runtime-betriebssicht.md; die MVP-Verträge liegen in solution-architecture:90-deployment/MVP-001-enterprise-bis-runtime-betriebssicht.md. Die strukturelle Übersicht der Betriebsknoten, der darauf betriebenen Components und Runtime Targets liegt zentral in solution-architecture:90-deployment/MVP-001-deployment-view.md.

Die Runtime ist keine Quellablage für Architektur. Sie hält lokale Konfiguration, Test- und Produktionsmaterialisierung sowie die ⌘EvidenceTechnical documentation artifact. einer konkreten Ausführung.

Normaler Arbeitskreislauf#

1. Neues GAP aktivieren und Arbeitspaket erzeugen#

Nach dem Import eines gelieferten Semantic-GAP-ZIPs in den verarbeiteten Downloadordner genügt der kombinierte Einstieg:

python3 ~/engineering/runtime/bin/activate-latest-gap-and-prepare.py

Er prüft und aktiviert das jüngste passende GAP und erzeugt danach unter ~/netzwerksolution/workspace/out/chatgpt-upload/ ein eindeutig benanntes Verzeichnis. Darin liegen sources.zip und targets.zip. Das aktive Work Item bestimmt automatisch, welche Repositorys enthalten sind.

Für einen bewusst ausgewählten GAP-Download steht GAP_AKTIVIERUNG.md bereit; Details zum Paket enthält ARBEITSPAKET.md.

2. Gelieferte Änderungen kontrolliert importieren#

Die zurückgelieferten Einzel-ZIPs und das Semantic-GAP-ZIP kommen in das lokale Importverzeichnis. Vor dem ersten echten Lauf ist eine Vorprüfung sinnvoll:

python3 ~/engineering/runtime/bin/import-roundtrip.py \
                  --input-dir ~/netzwerksolution/workspace/downloads/roundtrip --dry-run

Danach folgt derselbe Aufruf ohne --dry-run. Der Import übernimmt nur tatsächlich gelieferte Repositorys, prüft sie vor der Änderung und schreibt einen Laufbericht. Anleitung und Grenzen stehen in ROUNDTRIP_IMPORT.md.

3. Dokumentation und Testansicht 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

Der Neuaufbau rendert zunächst in Staging, prüft die Links und ersetzt erst danach die veröffentlichte Reportstruktur atomar. Der Testeinstieg ist danach:

http://localhost:18082/reports/

Die Reports zeigen nicht nur Dokumentation, sondern auch Linkprüfungen, Kontextwirkung, Codeansichten und Regression-Evidence. Fehlt ein Pflichtnachweis oder schlägt ein Gate fehl, ist der Schritt nicht erfolgreich.

4. Lokale Produktion ausdrücklich promoten#

python3 ~/engineering/runtime/bin/promote-local-production.py

Dieser Schritt baut die Produktionsdokumentation, führt das lokale Deployment aus und prüft ⌘ServiceEin Service ist eine abgegrenzte bereitgestellte technische oder fachliche Leistung mit klarer Verantwortung., Health und Version. Seine Evidence liegt unter runtime/production/reports/[[ART-DEF-0049|promotion]]/. Die lokale Produktion ist vom Test getrennt und trägt in HTML die Kennzeichnung „Lokale Produktion“.

5. Öffentliche Produktion ausdrücklich promoten#

Erst nach einem erfolgreichen lokalen Produktionsnachweis:

python3 ~/engineering/runtime/bin/promote-online-production.py

Die nicht versionierte Konfiguration liegt lokal unter ~/.config/netzwerksolution/promotion/production-online.json und enthält Zugangsdaten sowie Zielpfade. Der Schritt prüft den Remote-Health-Endpunkt, HTTPS, den veröffentlichten /reports/-Einstieg und den Versionsmarker. Die öffentliche Produktion wird unter https://wissen.guggat.de/reports/ erreicht und zeigt keinen lokalen Umgebungsmarker.

Überwachen, Fehler behandeln, zurückfallen#

Ein Rückfall ist kein stilles Überschreiben: Der Promotionvertrag hält vor der Umschaltung einen Release-Snapshot fest. Kann ein Zustand nicht automatisch wiederhergestellt werden, bleibt der Fehler als manual_recovery_required sichtbar. Details stehen in PRODUCTION_PROMOTION.md.

Was gehört wohin?#

• ⌘BedeutungBedeutung beschreibt den fachlichen Sinn eines Elements und seine Relevanz für Menschen und Organisationen., Theorie und Entscheidungen: Enterprise Architecture.
• MVP- und Deployment-Verträge: Solution Architecture.
• Ausführbare Mechanik: Engineering Tools.
• Lokale Einstellungen, Installationen, Reports und Evidence: Runtime.

Damit ist ein Report kein Ersatz für ein Markdown-Quellartefakt, ein erfolgreicher Import kein Ersatz für Test oder Promotion und eine Produktionsadresse kein Nachweis ohne den zugehörigen Evidence-Record.

Beziehungen#

• GAP-Arbeitspaket — uses
• Runtime Validation — uses
• ◆ProduktionspromotionsvertragGetrennte und belegte Promotion in lokale und öffentliche Produktion. — uses