Process Under The Hood

Diese Sicht zeigt den Publishing- und Projektionsprozess als echte Ablaufdiagramme mit Gates, Variablen, Konfigurationspunkten, Artefaktpfaden und Runtime-Snapshot.

Fail-Closed Deterministic HITL Gate Config-Sensitive Operator-Ready

1) End-to-End Pipeline als Swimlane

Von Seed-Generierung bis Tenant-Paket, inklusive Qualitätsgates und Artefaktübergaben.

Orchestrator: specs/scripts/generate-manual-and-tenants.sh

Start

  • Input: workspace_root
  • Node Discovery
→

Seed Generation

  • generate-seed-hitl-representations.sh
  • manual/public artifacts
→

Tenant Loop

  • generate-hitl-operator-package.sh
  • per node
Projection: iio/specs/scripts/project-seed-to-node.sh

Step 0 Gate

  • validate-manual-css.sh
  • fail on drift
→

Step 1 Project Pages

  • iio/manual/*.html -> node/manual/seed/
  • path rewrite + markers
→

Step 2 Data Projection

  • iio/public/data/*.js
  • prefix iio-*
→

Step 2f Docs Build

  • VitePress build
  • dist -> node/manual/docs
→

Step 3 Index Regeneration

  • generate-manual-index.sh
  • seed + node pages
Governance Gates

Workspace Rails

  • validate-workspace-root-cleanliness.sh
  • root file allowlist
→

Semantic Crosscheck

  • run-foundation-semantic-crosscheck.sh
  • lane status coherence
→

Full Stack Audit

  • run-full-stack-audit.sh
  • GO/BLOCK evidence

2) Detaildiagramm: Steuerfluss + Gate-Entscheidungen

Visualisierung der harten Stop-Bedingungen und Artefaktübergänge.

generate-manual-and-tenants var: workspace_root out: seed package + tenant package project-seed-to-node SEED_ROOT / NODE_ROOT steps: 0,1,2,2f,3,4 CSS Drift PASS? VitePress Build doc source -> static docs target: node/manual/docs Semantic Crosscheck? GO hitl operator package evidence file written BLOCK gate fail / drift / mismatch stop publish, emit reason Konfigurations- und Variablenebene (unter der Haube) - script args: SEED_ROOT, NODE_ROOT, DRY_RUN, WORKSPACE_ROOT - env flags: IIO_LANG_FAIL_CLOSED, iio-shell-preferences (uiLang/langStyle), color scheme - contracts: lane status in status.yaml vs node-state.yaml (active-lane coherence) - artifacts: public/data/*.js, manual/index.html, projection-manifest.json, evidence/*.md - fail-closed gates: css drift, root cleanliness, semantic crosscheck, full stack audit

3) Variablen- und Konfigurationsmatrix

Layer Variable / Config Quelle Wirkung Fail-Closed Verhalten
Orchestrator workspace_root specs/scripts/generate-manual-and-tenants.sh Definiert Seed/Node-Auflösung und Generator-Loop Fehlender Rootpfad blockiert gesamte Ausführung
Projection SEED_ROOT, NODE_ROOT, DRY_RUN iio/specs/scripts/project-seed-to-node.sh Steuert Kopierpfade, Rewrite und Build-Schritte Ungültige Roots beenden sofort mit Exit != 0
Language Delivery IIO_LANG_FAIL_CLOSED iio/base/credential-delivery/scripts/resolve-language-profile.sh Erzwingt harte Fehler bei fehlender Sprach-DB Bei =1 kein Fallback-Text, sondern BLOCK
Shell UI iio-shell-preferences.uiLang/langStyle iio/theme/_shell.js DE/EN + technical/business/training Darstellungsmodus Ungültige Werte werden auf Defaults normalisiert
Semantik active_lane vs active-lane status.yaml, node-state.yaml GO/NO-GO für semantische Konsistenz Mismatch erzeugt BLOCK im Crosscheck

4) Mermaid-Quelle für maschinenverifizierbare Prozessgraphen

Diese Quelle ist direkt in Tooling prüfbar und kann in Diagrammrenderer übernommen werden.

flowchart LR
  A[generate-manual-and-tenants.sh]\nworkspace_root --> B[generate-seed-hitl-representations.sh]
  B --> C[project-seed-to-node.sh]
  C --> D{CSS drift pass?}
  D -- no --> X[BLOCK: stop projection]
  D -- yes --> E[step1 pages projection]
  E --> F[step2 data projection]
  F --> G[step2f vitepress build]
  G --> H[step3 regenerate manual index]
  H --> I{semantic crosscheck pass?}
  I -- no --> X
  I -- yes --> J[full-stack audit]
  J --> K{all gates pass?}
  K -- no --> X
  K -- yes --> L[tenant package generation]
  L --> M[GO: evidence written]

  subgraph Config
    C1[SEED_ROOT]
    C2[NODE_ROOT]
    C3[DRY_RUN]
    C4[IIO_LANG_FAIL_CLOSED]
    C5[iio-shell-preferences uiLang/langStyle]
  end

  C1 -.influences.-> C
  C2 -.influences.-> C
  C3 -.influences.-> C
  C4 -.influences.-> L
  C5 -.influences.-> H

5) Live Runtime Snapshot

Node State

  • Lade Daten...

HITL Status

  • Lade Daten...

Shell Preferences

  • Lade Daten...

6) Wie man die Sicht operational baut

View Layer

Eigene Manual-Seite pro Kernprozess mit drei festen Blöcken: Diagramm, Config-Matrix, Runtime Snapshot.

Data Layer

Live-Einspeisung aus public/data/*.js, plus JSON-Manifeste aus Project/Transfomation Evidence.

Gate Layer

Jeder Prozessknoten trägt Gate-ID + Fail-Grund, damit GO/BLOCK sichtbar und prüfbar bleibt.

Operator Layer

Schalter für "nur Blocker", "nur Konfigurationsdrift", "nur fehlende Evidence" für schnelle Incident-Diagnose.

7) Erweiterte Laufdiagnose

Fuer die zeitliche Analyse ueber mehrere Runs und den Gate-Diff zwischen Layern nutze die ergänzende Sicht:

process-observability.html