- Codice
NS-3- Titolo
- UNI dei record di rischio (grammatica, corrispondenza con il pregresso, autorità di assegnazione)
- Versione
- 0.1.0
- Stato
- PROPOSTO
- Data
- catalogue 2026-10-16 · circulated 17 October 2026
- Unique Nexus Identifier
NXS-STD-ST-000003- Ambito di responsabilità
- fiducia; dati canonici
- Fonte
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.
- Stato
- PROPOSTO
- Titolare
- il sistema di fiducia e garanzia (standard) e NXS-GRX (registri)
- Implementazione di riferimento (nexus-foundry): libreria
the network's own records, storeserver/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).
Cita
NS-3, clause 1. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-11. Grammatica
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 accetta pertanto @3 nonché @1.2.0; an artefact carries a semantic version, a record an integer. A ref with a semantic version is not a record ref.
| Tipo | Codice | Tipo | Codice |
|---|---|---|---|
| Fatto osservativo | OB | Versione del cronotopo | CT |
| Versione della fonte | SR | Scheda di correzione | CR |
| Definizione dell'indicatore | IN | Scheda del prodotto analitico | AP |
| Definizione della misura | ME | Oggetto (luogo, bene, organizzazione) | SU |
| Versione dei confini | BD |
Record kinds and artefact categories never share a code (registry/nexus-standards.yaml#recordCategories; tools/validate.mjs e il test unitario del consumatore lo fanno rispettare).
Cita
NS-3, clause 2. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-22. Gli identificativi storici restano validi
NXS-GRX already carries record ids such as obs:unrisk:<key>, uni:source:worldbank.wdi, uni:indicator:<code> e identificatori con punti come grix.eo.stac.catalogue. Vengono interpretati come LEGACY, continuare a lavorare in <ref>@<version> refs (parseRecordRef, ora utilizzato dal raccoglitore governato dei dati di rischio estratti), e sono collegati a un UNI NS-1 quando questo viene assegnato. Nulla viene rinominato sul posto; un record riporta un NS-1 oppure recordUni (new records) or a legacy recordUni più la quota allocata uni (ObservationFact.uni, facoltativo durante la transizione).
Cita
NS-3, clause 3. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-33. Assegnazione
I numeri di serie non sono mai derivati né digitati a mano (NS1-R2). Provengono da nexus_uni.allocate_record_serial(scope, category, region), un contatore atomico per (GRX, kind, region) in nexus_uni.record_serial_sequence, fatto avanzare solo all'interno di una transazione tenant circoscritta (o del bypass di piattaforma). Ogni assegnazione è una riga di sola aggiunta in nexus_uni.record_uni_allocation (tenant, workspace, account, UNI, kind, region, serial, legacy_uni, principale verificato). L'identificativo legacy è la chiave di idempotenza all'interno di un account: assegnare due volte lo stesso identificativo legacy restituisce lo stesso UNI con 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.
L'isolamento segue il modello FORCE RLS del repository (coppia v956 di ambito account, protezione sistemica dell'ambito, protezione v959 dell'appartenenza). I contatori non contengono dati dei tenant; sono leggibili da qualsiasi ambito. Il test di integrazione dimostra, su un PostgreSQL reale, come un 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 è un errore 503 tipizzato (AuthoritativeStoreUnavailableError); there is no memory fallback.
Cita
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.tse gli altri): invariati finché ogni percorso non viene migrato; possono allocare e impostareunion the fact without changing theirrecordUnichiave. - Rif.: costruito con
formatRecordRef(recordUni, recordVersion)and read withparseRecordRef(ref); entrambe le forme sono accettate affinché le dipendenze delle correzioni continuino a risolversi durante la transizione.
Cita
NS-3, clause 4a. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-4a4a. Percorsi adottati
- WDI bootstrap (CGRIC-03): allocates SR and OB UNIs with a verified
uniScope;WdiBootstrapResult.uniAllocation. - Idratazione con dati reali (
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.tsand records the outcome indata.uniAllocation(ALLOCATEDwith crosswalks,NOT_REQUESTED, orUNAVAILABLEcon avanzamento parziale). L'acquisizione sincrona (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.
- Inoltro verificato dell'account (NS-3d):
server/standards/verifiedUniScope.tsletture{ 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/runlo trasmette comeuniScopeai bootstrap dei WDI;UnriskFabricScope.accountIdè inoltrato darunUnriskFabricQuerythroughhydrateUnriskRealDataCompleteehydrateUnriskRealDataExtendedtohydrateUnriskRealData. 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.tsallocates an OB UNI for every observation the public-data plane writes (native indicators from World Bank, UNSD, WHO, IMF and the statistical adapters; public hazard events; Open-Meteo current, forecast and ensemble records) under the system-owned scope the plane already uses for SQL (accountACC-GRIX-PUBLIC-DATA, identitysystem:grix-public-data). REGION è la dimensione ISO3 o il riferimento di luogo del paese; i punti e i dati globali non sono regionalizzati. Il vecchiorecordUnistays 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'suniAllocationrapportiUNAVAILABLEwith the partial counts; any other scope isNOT_REQUESTED.
Cita
NS-3, clause 5. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-55. Seguito
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 colonna attiva grix_chrono.observation_facts così che l' UNI sia interrogabile senza leggere il contenuto del record; l'ambito del Builder v2 diventa limitato alle sole dichiarazioni, in modo che anche il suo strumento possa inoltrare.
Cronologia delle modifiche
Versions from the catalogue; entries from the changelog that name this document.
| Versione | Data | Nota |
|---|---|---|
0.1.0 | 16 ottobre 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/.