- コード
NS-3- タイトル
- リスク記録の UNI(文法、旧体系との対照、割当権限)
- バージョン
- 0.1.0
- 状況
- 提案中
- 日付
- catalogue 2026-10-16 · circulated 17 October 2026
- Unique Nexus Identifier
NXS-STD-ST-000003- 責任範囲
- 信頼、正準データ
- 出典
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.
- 状況
- 提案中
- オーナー
- 信頼と保証のシステム(標準)および NXS-GRX (記録)
- 参照実装(nexus-foundry): ライブラリ
the network's own records、保存server/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).
引用する
NS-3, clause 1. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-11. 文法
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)バージョン部分は NXS-GRX 整数 recordVersion. NS-1 v1.1 therefore accepts @3 ならびに @1.2.0; an artefact carries a semantic version, a record an integer. A ref with a semantic version is not a record ref.
| 種別 | コード | 種別 | コード |
|---|---|---|---|
| 観測ファクト | OB | クロノトープ・バージョン | CT |
| ソース・リリース | SR | 訂正記録 | CR |
| 指標の定義 | IN | 分析プロダクト記録 | AP |
| メジャーの定義 | ME | Subject (place, asset, organisation) | SU |
| 境界バージョン | BD |
Record kinds and artefact categories never share a code (registry/nexus-standards.yaml#recordCategories; tools/validate.mjs また、コンシューマー単体テストがこれを強制します)。
引用する
NS-3, clause 2. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-22. 従来の識別子は引き続き有効
NXS-GRX はすでに次のようなレコード ID を保持しています obs:unrisk:<key>, uni:source:worldbank.wdi, uni:indicator:<code> およびドット区切りの ID(例: grix.eo.stac.catalogue。これらは次のように解析される LEGACY、引き続き作業する: <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 (新規記録)または旧来の recordUni 加えて、配分された uni (ObservationFact.uni。移行期間中は任意とします。)
引用する
NS-3, clause 3. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-33. Allocation
シリアル番号は、導出したり手で入力したりすることはありません(NS1-R2)。次のものから取得されます。 nexus_uni.allocate_record_serial(scope, category, region)、次の単位ごとのアトミック・カウンター (GRX, kind, region) in nexus_uni.record_serial_sequence、スコープを指定したテナント・トランザクション内(またはプラットフォームのバイパス)でのみ進められます。すべての割り当ては、追記専用の 1 行として、次に記録されます nexus_uni.record_uni_allocation (テナント、ワークスペース、アカウント、 UNI、種類、地域、シリアル、 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.
分離は、リポジトリの FORCE RLS パターン(v956 のアカウントスコープ対、システミック・スコープ・ガード、v959 のメンバーシップ・ガード)に従う。カウンターにテナントデータは含まれず、どのスコープからも読み取れる。統合テストは、実際の PostgreSQL 上で、ある NOSUPERUSER NOBYPASSRLS 役割:シリアルはアカウント間で共有され、対応づけはアカウント内で非公開となり、偽造されたスコープは何も書き込まず、変更は拒否され、カウンターはスコープ付きトランザクションの外では拒否され、マイグレーションは再適用しても何も起こりません。
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.
引用する
NS-3, clause 4. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-44. 取り込み経路に生じる変更
- New records: allocate through the store at write time and store the NS-1 form in
recordUni. - Existing paths (
obs:unrisk:…inserver/unrisk/realDataObservationIngest.tsand the others): unchanged until each path is migrated; they can allocate and setunion the fact without changing theirrecordUnikey. - 参照:構築に使用
formatRecordRef(recordUni, recordVersion)and read withparseRecordRef(ref); both forms are accepted so correction dependencies keep resolving across the transition.
引用する
NS-3, clause 4a. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-4a4a. 採用された経路
- 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? })すべてを対応づけるobs:unrisk:<key>@<version>OB の UNI に対するハイドレーションの ref(国単位のハイドレーションでは region = ISO3)、経由:server/unrisk/realDataRecordUni.tsand records the outcome indata.uniAllocation(ALLOCATED対応づけを備え、NOT_REQUESTED、またはUNAVAILABLE部分的な進捗を伴う)。同期取り込み(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.
- Verified account forwarding (NS-3d):
server/standards/verifiedUniScope.tsreads{ 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/runpasses it asuniScopeWDI のブートストラップに対して;UnriskFabricScope.accountIdis forwarded byrunUnriskFabricQuerythroughhydrateUnriskRealDataCompleteとhydrateUnriskRealDataExtendedtohydrateUnriskRealData. 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.
- Open-data ingests (NS-3e):
server/grix/fusion/openData/openDataRecordUni.ts公開データ・プレーンが書き込むすべての観測(World Bank、UNSD、WHO、IMF および各統計アダプターのネイティブ指標、公開されているハザード事象、Open-Meteo の現況・予報・アンサンブル記録)に対して OB UNI を割り当てる。割り当ては、プレーンが SQL 用にすでに使用しているシステム所有のスコープの下で行われる(アカウントACC-GRIX-PUBLIC-DATA, identitysystem:grix-public-data)。REGION は ISO3 の次元または国の場所参照であり、点とグローバルのデータには地域は付されない。従来のrecordUnistays 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'suniAllocationレポートUNAVAILABLEwith the partial counts; any other scope isNOT_REQUESTED.
引用する
NS-3, clause 5. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-55. フォローオン
NS-3b delivered (NS-3b-dataset-and-product-metadata-profile.md)。NS-3d(検証済みアカウント転送)と NS-3e(オープンデータの取り込み)は提供済みです。残りは、専用の uni column on grix_chrono.observation_facts これにより、 UNI はレコードのペイロードを読まなくても照会できる。Builder v2 のスコープはクレームのみとなり、そのツールも転送できるようになる。
変更履歴
Versions from the catalogue; entries from the changelog that name this document.
| バージョン | 日付 | 注記 |
|---|---|---|
0.1.0 | 2026 年 10 月 16 日 | 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/.