- Kode
NS-3- Judul
- UNI catatan risiko (tata bahasa, pemetaan silang warisan, otoritas alokasi)
- Versi
- 0.1.0
- Status
- DIUSULKAN
- Tanggal
- catalogue 2026-10-16 · circulated 17 October 2026
- Unique Nexus Identifier
NXS-STD-ST-000003- Lingkup tanggung jawab
- kepercayaan; data kanonis
- Sumber
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
- DIUSULKAN
- Pemilik
- the trust and assurance system (standard) and NXS-GRX (records)
- Reference implementation (nexus-foundry): library
the network's own records, simpanserver/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).
Kutip
NS-3, clause 1. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-11. Grammar
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)The version segment is the NXS-GRX integer recordVersion. NS-1 v1.1 therefore accepts @3 as well as @1.2.0; an artefact carries a semantic version, a record an integer. A ref with a semantic version is not a record ref.
| Jenis | Kode | Jenis | Kode |
|---|---|---|---|
| Fakta observasi | OB | Versi kronotop | CT |
| Rilis sumber | SR | Catatan koreksi | CR |
| Definisi indikator | IN | Catatan produk analitis | AP |
| Definisi ukuran | ME | Subjek (tempat, aset, organisasi) | SU |
| Versi batas | 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).
Kutip
NS-3, clause 2. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-22. Legacy ids stay valid
NXS-GRX already carries record ids such as obs:unrisk:<key>, uni:source:worldbank.wdi, uni:indicator:<code> and dotted ids such as grix.eo.stac.catalogue. They parse as LEGACY, keep working in <ref>@<version> refs (parseRecordRef, kini digunakan oleh bundel pemotongan data risiko yang diatur), dan dipetakan silang ke UNI NS-1 saat dialokasikan. Tidak ada yang diganti namanya di tempat; sebuah catatan membawa NS-1 recordUni (new records) or a legacy recordUni ditambah yang dialokasikan uni (ObservationFact.uni, opsional selama masa transisi).
Kutip
NS-3, clause 3. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-33. Alokasi
Nomor seri tidak pernah diturunkan atau diketik secara manual (NS1-R2). Nomor tersebut berasal dari nexus_uni.allocate_record_serial(scope, category, region), penghitung atomik per (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 (tenant, ruang kerja, akun, UNI, jenis, wilayah, nomor seri, legacy_uni, verified principal). The legacy id is the idempotency key within an account: allocating the same legacy id twice returns the same UNI with reused: true. UNIs are never reused or reassigned: UPDATE, DELETE and TRUNCATE raise UNI_RECORD_ALLOCATION_IMMUTABLE, and a CHECK keeps the UNI string equal to its segment columns.
Isolasi mengikuti pola FORCE RLS repositori (pasangan lingkup akun v956, penjaga lingkup sistemik, penjaga keanggotaan v959). Penghitung tidak menyimpan data tenant; penghitung dapat dibaca oleh lingkup mana pun. Uji integrasi membuktikan pada PostgreSQL sungguhan, sebagai 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 is a typed 503 (AuthoritativeStoreUnavailableError); there is no memory fallback.
Kutip
NS-3, clause 4. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-44. Perubahan pada jalur ingest
- New records: allocate through the store at write time and store the NS-1 form in
recordUni. - Existing paths (
obs:unrisk:…inserver/unrisk/realDataObservationIngest.tsdan lainnya): tidak berubah hingga setiap jalur dimigrasikan; semuanya dapat mengalokasikan dan menetapkanunion the fact without changing theirrecordUnikey. - Refs: build with
formatRecordRef(recordUni, recordVersion)dan dibaca bersamaparseRecordRef(ref); kedua bentuk diterima agar ketergantungan koreksi tetap terselesaikan selama masa transisi.
Kutip
NS-3, clause 4a. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-4a4a. Jalur yang diadopsi
- WDI bootstrap (CGRIC-03): allocates SR and OB UNIs with a verified
uniScope;WdiBootstrapResult.uniAllocation. - Real-data hydration (
server/unrisk/realDataHydration.ts, NS-3c):hydrateUnriskRealData(context, { uniScope: { accountId }, recordUniStore? })crosswalks everyobs:unrisk:<key>@<version>ref of the hydration to an OB UNI (region = ISO3 for country-scoped hydrations) throughserver/unrisk/realDataRecordUni.tsdan mencatat hasilnya dalamdata.uniAllocation(ALLOCATEDwith crosswalks,NOT_REQUESTED, orUNAVAILABLEdengan kemajuan parsial). Ingest sinkron (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.
- Penerusan akun terverifikasi (NS-3d):
server/standards/verifiedUniScope.tsmembaca{ accountId, principalId }from the request's verified claims only; a header, body or query account is never authority, and theacct:<tenant>the authority context synthesises is never used.POST /source-bootstrap/runmeneruskannya sebagaiuniScopeto the WDI bootstraps;UnriskFabricScope.accountIdis forwarded byrunUnriskFabricQuerymelaluihydrateUnriskRealDataCompletedanhydrateUnriskRealDataExtendedtohydrateUnriskRealData. The fabric query, NEIF mission-agent, data-agent and Commons agent-team routes and the hex-intel UNRISK contributor forward it; the Builder v2 UNRISK tool does not (its scope accepts a header account, NS3D-G1). Without a claim every path staysNOT_REQUESTED.
- Penarikan data terbuka (NS-3e):
server/grix/fusion/openData/openDataRecordUni.tsmengalokasikan OB UNI untuk setiap observasi yang ditulis oleh bidang data publik (indikator asli dari World Bank, UNSD, WHO, IMF dan adaptor statistik; peristiwa bahaya publik; rekaman terkini, prakiraan, dan ansambel Open-Meteo) di bawah cakupan milik sistem yang sudah digunakan bidang tersebut untuk SQL (accountACC-GRIX-PUBLIC-DATA, identitysystem:grix-public-data). REGION is the ISO3 dimension or country place ref; points and globals are unregioned. The legacyrecordUnistays the fabric key; the UNI rides on the stored fact (durable file and the PostgreSQL record payload), is kept across corrections, and a current version written before NS-3e receives its UNI on its next correction through the legacy crosswalk. Unchanged rows cost no fabric round-trip. A fabric outage never blocks an observation write: the first typed outage trips a per-pass circuit and the receipt'suniAllocationlaporanUNAVAILABLEwith the partial counts; any other scope isNOT_REQUESTED.
Kutip
NS-3, clause 5. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-55. Follow-on
NS-3b delivered (NS-3b-dataset-and-product-metadata-profile.md). NS-3d (verified account forwarding) and NS-3e (open-data ingests) delivered. Remaining: a dedicated uni column on grix_chrono.observation_facts sehingga UNI dapat dikueri tanpa membaca muatan rekaman; cakupan Builder v2 menjadi hanya klaim agar alatnya juga dapat meneruskan.
Riwayat perubahan
Versions from the catalogue; entries from the changelog that name this document.
| Versi | Tanggal | Catatan |
|---|---|---|
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/.