Infrastruktur · Die Module: was sie tun, betreiben, testen, ansteuern
Registry-Standard
Manifest-Standard, Schemas, Ontologie und Kontext, auf denen das Verzeichnis steht.
Auf dieser Seite
Was es tut
Der Registry-Standard ist das Regelwerk, auf dem das Verzeichnis steht: ein Manifest-Profil über DCAT-AP-CH mit einer Erweiterung für KI-Schnittstellen, dazu JSON-Schema, JSON-LD-Kontext, SHACL-Shapes und die oh:-Ontologie. Ein Manifest ist gewöhnliches JSON in genau einer normierten Gestalt — bis hinunter zu den Bytes: feste Schlüsselreihenfolge, zwei Leerzeichen Einzug, LF, Schlusszeile, damit ein Git-Diff Inhalt trägt und nicht Stil. Das Werkzeug oh-validate fährt vier Stufen über den ganzen Korpus: JSON-Schema, JSON-LD-Rundlauf gegen den mitgelieferten Kontext, SHACL gegen die versionierten Shapes, und zuletzt den Zusammenzug aller Dokumente zu einem einzigen Graphen mit RDFC-1.0-Fingerabdruck und kritischen Invarianten als SPARQL-Abfragen. Alle Prozessoren laufen offline auf den mitgelieferten Kopien; ein fremder IRI wird verweigert statt aufgelöst. Zwei weitere Tore hängen daran: ein Siegelregister, das jede Änderung an einem Vertragsartefakt zu einer bewussten Handlung macht, und ein Deckungstor, das jeden Begriff der veröffentlichten Artefakte in der Ontologie nachweist. Was der Standard nicht tut: er nimmt niemanden auf, misst nichts und beansprucht keine Verbindlichkeit — v0.1 ist Entwurf, normativ erst nach Ratifikation durch die Standard-Kommission nach Art. 13 der Statuten.
Selbst betreiben
Sie brauchen:
- Rust (stable über rustup) und Git; alle Befehle laufen aus der Wurzel des Korpus-Checkouts.
Aus der Wurzel des Korpus-Checkouts, Zeile für Zeile:
cargo run --locked --manifest-path registry/standard/oh-validate/Cargo.toml -- registry/standard/schema/manifest.schema.json registry/standard/test-corpus --stage2 registry/standard/context/v1.jsonld --stage3 registry/standard/shapes/manifest-v1.ttl --stage4
Danach sehen Sie:
checked 19 file(s): OK
Die vier Prüfstufen über den Testkorpus, ohne Netz. Das Siegelregister prüft: cargo run --locked --manifest-path registry/standard/seal/Cargo.toml -- --root registry/standard
Testen
cargo test --locked --manifest-path registry/standard/oh-validate/Cargo.toml
- Aufgezeichnete Fixtures:
registry/standard/test-corpus - Läuft ohne Netz: jede Antwort kommt aus dem Repository, das Ergebnis ist bei jedem Lauf gleich.
Ansteuern
- Öffentlich: noch nicht — Die Website ist noch nicht unter openhelvetia.swiss aufgeschaltet; die Artefakte werden mit ihr unter /ns/ byte-identisch ausgeliefert.
- Lokal: im Website-Build unter /ns/
Verträge
- Manifest-Schema (datiert)
registry/standard/schema/manifest.schema.json - JSON-LD-Kontext
registry/standard/context/v1.jsonld - SHACL-Shapes
registry/standard/shapes/manifest-v1.ttl - Verzeichnis-Umschlag v0.2
registry/standard/directory.schema.json - Siegelregister
registry/standard/artifacts.json
Aufruf und Optionen
usage: oh-validate <manifest.schema.json> <file-or-dir>... [--stage2 <context/v1.jsonld>] [--stage3 <shapes/manifest-v1.ttl>] [--stage4] [--write]
Mitwirken
Änderungen laufen über Merge Request und dieselben Gates wie für den Verein: Formatierung, Clippy ohne Warnungen, Tests, Siegel- und Drift-Prüfungen. Sicherheitsmeldungen vertraulich an [email protected].
Die Basis-Stufe kostet nichts; wovon der Betrieb lebt, steht unter Über uns, Finanzierung.
Steckbrief
Zustand, Belege, Download und Abhängigkeiten stehen auf der Infrastruktur-Seite: Registry-Standard.