- Code
NS-3- Titel
- UNIs für Risikodatensätze (Grammatik, Zuordnung zum Altbestand, Vergabestelle)
- Version
- 0.1.0
- Status
- VORGESCHLAGEN
- Datum
- catalogue 2026-10-16 · circulated 17 October 2026
- Unique Nexus Identifier
NXS-STD-ST-000003- Verantwortungsbereich
- Vertrauen; kanonische Daten
- Quelle
standards/NS-3-grix-record-uni.mdat2cbe0d41b5f8
Preparatory working draft, circulated for review and comment. Not for implementation. Prepared and circulated by Saeed Valadbaygi, Chief Steward, Nexus Standards (saeed@therisk.global), 17 October 2026. Technical review area: TR-02. This document is not a Nexus Standard; it may change without notice and is not to be implemented, relied upon or cited as a Nexus Standard. Its stage is designated only by the Global Standards Council and its technical committees under NS-13. Recipients are invited to submit comments with supporting reasons, and to notify any patent rights of which they are aware. See the notice of circulation.
- Status
- VORGESCHLAGEN
- Inhaber
- das Vertrauens- und Zusicherungssystem (Standard) und NXS-GRX (Aufzeichnungen)
- Übergeordnet
NS-1-identifier-and-artifact-catalog.md- Referenzimplementierung (nexus-foundry): Bibliothek
the network's own records, speichernserver/grix/uni/recordUniStore.ts, Migrationthe network's own records, proofthe network's own records
NS-1 gives artefacts (software, reports, datasets, figures) a UNI allocated by the catalogue. NS-3 gives NXS-GRX records (observation facts, source releases, indicators, boundaries, chronotopes, corrections, analytical products, subjects) a UNI allocated by the UNI fabric in PostgreSQL, on the same grammar, so a record can be cited, resolved and crosswalked like any other Nexus artefact. A UNI identifies and resolves a record; it never certifies the record's truth (V3 directive, section 12).
Zitieren
NS-3, clause 1. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-11. Grammatik
NXS-GRX-<KIND>[-<REGION>]-<SERIAL> the record concept (ObservationFact.recordUni) NXS-GRX-<KIND>[-<REGION>]-<SERIAL>@<version> one record version (recordUni@recordVersion) NXS-GRX-OB-KEN-000042@3 observation fact 42 for Kenya, version 3 NXS-GRX-SR-000001 source release 1 (global)Das Versionssegment ist die NXS-GRX Ganzzahl recordVersion. NS-1 v1.1 akzeptiert daher @3 sowie @1.2.0; an artefact carries a semantic version, a record an integer. A ref with a semantic version is not a record ref.
| Art | Code | Art | Code |
|---|---|---|---|
| Beobachtungsfakt | OB | Chronotop-Version | CT |
| Quellversion | SR | Korrekturdatensatz | CR |
| Indikatordefinition | IN | Datensatz des Analyseprodukts | AP |
| Maßdefinition | ME | Gegenstand (Ort, Vermögenswert, Organisation) | SU |
| Grenzversion | BD |
Record kinds and artefact categories never share a code (registry/nexus-standards.yaml#recordCategories; tools/validate.mjs and the consumer unit test enforce it).
Zitieren
NS-3, clause 2. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-22. Frühere Kennungen bleiben gültig
NXS-GRX enthält bereits Eintragskennungen wie obs:unrisk:<key>, uni:source:worldbank.wdi, uni:indicator:<code> and dotted ids such as grix.eo.stac.catalogue. Sie werden geparst als LEGACY, keep working in <ref>@<version> refs (parseRecordRef, now used by the governed risk data-cut binder), and are crosswalked to an NS-1 UNI when allocated. Nothing is renamed in place; a record either carries an NS-1 recordUni (neue Datensätze) oder ein älterer recordUni zuzüglich der zugeordneten uni (ObservationFact.uni, während der Übergangszeit optional).
Zitieren
NS-3, clause 3. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-33. Zuteilung
Seriennummern werden nie abgeleitet oder von Hand eingegeben (NS1-R2). Sie stammen aus nexus_uni.allocate_record_serial(scope, category, region), ein atomarer Zähler pro (GRX, kind, region) in nexus_uni.record_serial_sequence, advanced only inside a scoped tenant transaction (or the platform bypass). Every allocation is one append-only row in nexus_uni.record_uni_allocation (Mandant, Arbeitsbereich, Konto, UNI, Art, Region, Seriennummer, legacy_uni, verifizierter Auftraggeber). Die Legacy-ID ist der Idempotenzschlüssel innerhalb eines Kontos: Wird dieselbe Legacy-ID zweimal vergeben, wird dieselbe UNI zurückgegeben mit reused: true. UNIs werden nie wiederverwendet oder neu zugewiesen: UPDATE, DELETE und TRUNCATE lösen aus UNI_RECORD_ALLOCATION_IMMUTABLE, and a CHECK keeps the UNI string equal to its segment columns.
Die Isolation folgt dem FORCE-RLS-Muster des Repositorys (v956 Kontobereichspaar, systemischer Bereichswächter, v959 Mitgliedschaftswächter). Die Zähler enthalten keine Mandantendaten; sie sind in jedem Bereich lesbar. Der Integrationstest belegt auf einem echten PostgreSQL, als ein NOSUPERUSER NOBYPASSRLS role: serials shared across accounts, crosswalk private to the account, a forged scope writes nothing, mutation refused, the counter refused outside a scoped transaction, and the migration re-applies as a no-op.
const store = resolveRecordUniStore(); const { uni, reused } = await store.allocate(scope, { kind: "OB", region: "KEN", legacyUni: "obs:unrisk:wdi.KEN.SP.POP.TOTL.2020" }); // uni = "NXS-GRX-OB-KEN-000042"; ref for version 3: formatRecordRef(uni, 3)Offline ist ein typisiertes 503 (AuthoritativeStoreUnavailableError); there is no memory fallback.
Zitieren
NS-3, clause 4. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-44. Was sich für Ingest-Pfade ändert
- Neue Datensätze: beim Schreiben über den Speicher zuweisen und die NS-1-Form darin ablegen
recordUni. - Bestehende Wege (
obs:unrisk:…inserver/unrisk/realDataObservationIngest.tsund die übrigen): bleiben unverändert, bis jeder Pfad migriert ist; sie können zuweisen und festlegenunizur Tatsache, ohne ihre zu ändernrecordUnikey. - Verweise: Erstellt mit
formatRecordRef(recordUni, recordVersion)und gelesen mitparseRecordRef(ref); beide Formen werden akzeptiert, damit Korrekturabhängigkeiten über den Übergang hinweg weiter aufgelöst werden.
Zitieren
NS-3, clause 4a. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-4a4a. Übernommene Pfade
- WDI-Bootstrap (CGRIC-03): vergibt SR- und OB-UNIs mit einer geprüften
uniScope;WdiBootstrapResult.uniAllocation. - Hydration mit Realdaten (
server/unrisk/realDataHydration.ts, NS-3c):hydrateUnriskRealData(context, { uniScope: { accountId }, recordUniStore? })gleicht jeden abobs:unrisk:<key>@<version>Verweis der Hydratisierung auf einen OB UNI (Region = ISO3 bei länderbezogenen Hydratisierungen) überserver/unrisk/realDataRecordUni.tsund hält das Ergebnis fest indata.uniAllocation(ALLOCATEDmit Crosswalks,NOT_REQUESTED, oderUNAVAILABLEmit Teilfortschritt). Die synchrone Aufnahme (realDataObservationIngest.ts) keeps its legacy keys; the data cut and consumers keep matching them, and a product's PROV-O bundle maps both forms (NS-3b). The envelope's requester carries no account id, so callers supply it (NS-3d below); without it hydration reportsNOT_REQUESTED.
- Verifizierte Kontoweiterleitung (NS-3d):
server/standards/verifiedUniScope.tsreads{ accountId, principalId }ausschließlich aus den verifizierten Claims der Anfrage; eine Angabe im Header, Body oder in der Abfrage ist nie maßgeblich, und dieacct:<tenant>the authority context synthesises is never used.POST /source-bootstrap/rungibt es weiter alsuniScopezu den WDI-Bootstraps;UnriskFabricScope.accountIdwird weitergeleitet vonrunUnriskFabricQuerythroughhydrateUnriskRealDataCompleteundhydrateUnriskRealDataExtendedbishydrateUnriskRealData. Die Routen der Fabric-Abfrage, des NEIF-Mission-Agent, des Data-Agent und des Commons-Agent-Team sowie der hex-intel-UNRISK-Beitragende leiten ihn weiter; das Builder-v2-UNRISK-Werkzeug tut dies nicht (sein Geltungsbereich akzeptiert ein Header-Konto, NS3D-G1). Ohne Anspruch bleibt jeder PfadNOT_REQUESTED.
- Open-data ingests (NS-3e):
server/grix/fusion/openData/openDataRecordUni.tsvergibt für jede Beobachtung, die die Ebene der öffentlichen Daten schreibt, einen OB UNI (native Indikatoren von Weltbank, UNSD, WHO und IWF sowie der statistischen Adapter; öffentliche Gefahrenereignisse; aktuelle, Vorhersage- und Ensemble-Datensätze von Open-Meteo) im systemeigenen Geltungsbereich, den die Ebene bereits für SQL verwendet (accountACC-GRIX-PUBLIC-DATA, identitysystem:grix-public-data). REGION ist die ISO3-Dimension oder die Länderortsreferenz; Punkte und globale Werte haben keine Region. Das ältererecordUnibleibt der Fabric-Schlüssel; die UNI wird dem gespeicherten Fakt mitgegeben (dauerhafte Datei und PostgreSQL-Datensatz-Payload), bleibt über Korrekturen hinweg erhalten, und eine aktuelle Version, die vor NS-3e geschrieben wurde, erhält ihre UNI bei der nächsten Korrektur über das Legacy-Crosswalk. Unveränderte Zeilen verursachen keinen Fabric-Roundtrip. Ein Fabric-Ausfall blockiert nie einen Beobachtungsschreibvorgang: Der erste typisierte Ausfall löst einen Schutzschalter pro Durchlauf aus, und der Beleg desuniAllocationberichteUNAVAILABLEmit den Teilzählungen; jeder andere Geltungsbereich istNOT_REQUESTED.
Zitieren
NS-3, clause 5. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-55. Folgemaßnahmen
NS-3b delivered (NS-3b-dataset-and-product-metadata-profile.md). NS-3d (verifizierte Kontoweiterleitung) und NS-3e (Open-Data-Erfassungen) geliefert. Ausstehend: ein eigener uni Spalte ein grix_chrono.observation_facts damit die UNI abgefragt werden kann, ohne die Nutzdaten des Datensatzes zu lesen; der Geltungsbereich von Builder v2 wird auf reine Claims beschränkt, damit auch sein Werkzeug weiterleiten kann.
Änderungshistorie
Versions from the catalogue; entries from the changelog that name this document.
| Version | Datum | Hinweis |
|---|---|---|
0.1.0 | 16. Oktober 2026 | current version in the catalogue |
- 0.1.0 – 2026-10-16 Canonical repository bootstrapped from the standards first drafted inside nexus-foundry (work items LEGAL-NAME-ARCHITECTURE-001, NS-3-7-RECORD-UNI-RESOLVER-001, NS-3B-DATA-PROFILE-001).
- 0.1.0 – 2026-10-16 NS-1 (the UNI and the artefact catalogue), NS-3 (NXS-GRX record UNIs) and NS-3b (STAC, DCAT, PROV-O profile) as PROPOSED documents under
standards/.