- 코드
NS-3- 제목
- 리스크 기록 UNI(문법, 기존 체계 대응, 할당 권한)
- 버전
- 0.1.0
- 상태
- 제안됨
- Date
- 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.
- 상태
- 제안됨
- 소유자
- the trust and assurance system (standard) and NXS-GRX (records)
- 참조 구현(nexus-foundry): 라이브러리
the network's own records, storeserver/grix/uni/recordUniStore.ts, 이주the 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. 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 및 @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. Legacy ids stay valid
NXS-GRX already carries record ids such as obs:unrisk:<key>, uni:source:worldbank.wdi, uni:indicator:<code> 그리고 다음과 같이 점으로 구분된 ID grix.eo.stac.catalogue. 이들은 다음과 같이 해석됩니다 LEGACY, keep working in <ref>@<version> refs (parseRecordRef, 현재 관리형 리스크 데이터 추출 바인더에서 사용됨), 할당되면 NS-1 UNI 에 대응됩니다. 기존 항목의 이름은 변경되지 않으며, 기록은 NS-1을 가집니다 recordUni (new records) or a legacy recordUni plus the allocated uni (ObservationFact.uni, optional during the transition).
인용
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, 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, workspace, account, UNI, kind, region, serial, 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 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.
인용
NS-3, clause 4. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-44. What changes for ingest paths
- 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. Adopted paths
- 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>ref of the hydration to an OB UNI (region = ISO3 for country-scoped hydrations) throughserver/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에 사용하는 시스템 소유 범위(accountACC-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. Follow-on
NS-3b delivered (NS-3b-dataset-and-product-metadata-profile.md). NS-3d(검증된 계정 전달)와 NS-3e(공개 데이터 수집)가 완료되었습니다. 남은 과제: 전용 uni 열 켜짐 grix_chrono.observation_facts 따라서 UNI 는 기록 페이로드를 읽지 않고도 조회할 수 있으며, Builder v2의 범위는 클레임 전용으로 바뀌어 해당 도구도 전달할 수 있다.
변경 이력
Versions from the catalogue; entries from the changelog that name this document.
| 버전 | Date | 비고 |
|---|---|---|
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/.