wiki/e-compliance/ims/cockpit/README.md

1.4 KiB

IMS Management Cockpit

Offline nutzbares HTML-Cockpit zur Navigation und Einsicht aller IMS-Dokumente.

Nutzen

IMS-Cockpit.html per Doppelklick im Browser öffnen. Es enthält alle IMS-Dokumente gerendert (Markdown -> HTML), einen Navigationsbaum nach ISO-Kapitel, Volltextsuche, ein Dashboard (Dokumentenzahl, Status, überfällige Reviews) und eine Pendenzen-Seite (Massnahmenregister + überfällige Reviews + [ZU PRÜFEN]-Marker). Mermaid-Diagramme sind eingebettet und werden offline gerendert. Keine Internetverbindung nötig.

Neu generieren (nach Doku-Änderungen)

python build_cockpit.py

Das aktualisiert IMS-Cockpit.html. Beim ersten Lauf wird mermaid.min.js einmalig vom CDN geladen und unter _vendor/ zwischengespeichert; danach läuft der Build offline.

Hintergrund (technisch)

Browser blockieren fetch() lokaler Dateien unter file://. Deshalb wird der gerenderte Inhalt zur Build-Zeit in die HTML eingebettet (eine portable Datei, Mermaid inline) -- so genügt ein Doppelklick. Der Generator hat keine externen Python-Abhängigkeiten.

Automatisierung (optional)

python build_cockpit.py kann als Forgejo-CI-Schritt oder Pre-Commit-Hook laufen, damit das Cockpit bei jeder Doku-Änderung automatisch aktuell bleibt.

Dateien

  • build_cockpit.py -- Generator
  • IMS-Cockpit.html -- generierte Cockpit-Datei (Doppelklick)
  • _vendor/mermaid.min.js -- lokal zwischengespeicherte Mermaid-Bibliothek