- Code
NS-3- Titre
- UNI de fiches de risque (grammaire, correspondance avec l'existant, autorité d'attribution)
- Version
- 0.1.0
- Statut
- PROPOSÉ
- Date
- catalogue 2026-10-16 · circulated 17 October 2026
- Unique Nexus Identifier
NXS-STD-ST-000003- Périmètre de responsabilité
- confiance ; données canoniques
- Sources
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.
- Statut
- PROPOSÉ
- Propriétaire
- le système de confiance et d'assurance (norme) et NXS-GRX (enregistrements)
- Implémentation de référence (nexus-foundry) : bibliothèque
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).
Citer
NS-3, clause 1. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-11. Grammaire
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 accepte donc @3 ainsi que @1.2.0; an artefact carries a semantic version, a record an integer. A ref with a semantic version is not a record ref.
| Type | Code | Type | Code |
|---|---|---|---|
| Fait d'observation | OB | Version du chronotope | CT |
| Version source | SR | Fiche de correction | CR |
| Définition de l'indicateur | IN | Fiche de produit analytique | AP |
| Définition de la mesure | ME | Subject (place, asset, organisation) | SU |
| Version des limites | BD |
Record kinds and artefact categories never share a code (registry/nexus-standards.yaml#recordCategories; tools/validate.mjs et le test unitaire du consommateur l'imposent).
Citer
NS-3, clause 2. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-22. Les anciens identifiants restent valides
NXS-GRX porte déjà des identifiants d'enregistrement tels que obs:unrisk:<key>, uni:source:worldbank.wdi, uni:indicator:<code> et des identifiants à points tels que grix.eo.stac.catalogue. Ils sont analysés comme LEGACY, keep working in <ref>@<version> refs (parseRecordRef, désormais utilisé par le classeur gouverné des extractions de données de risque), et sont mis en correspondance avec un UNI NS-1 lorsqu'il est attribué. Rien n'est renommé sur place ; un enregistrement porte soit un NS-1 recordUni (nouveaux enregistrements) ou un ancien recordUni plus the allocated uni (ObservationFact.uni, facultatif pendant la transition).
Citer
NS-3, clause 3. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-33. Allocation
Les numéros de série ne sont jamais dérivés ni saisis à la main (NS1-R2). Ils proviennent de nexus_uni.allocate_record_serial(scope, category, region), un compteur atomique par (GRX, kind, region) in nexus_uni.record_serial_sequence, avancé uniquement dans une transaction de locataire délimitée (ou le contournement de la plateforme). Chaque allocation est une ligne en ajout seul dans nexus_uni.record_uni_allocation (tenant, workspace, account, UNI, kind, region, serial, legacy_uni, principal vérifié). L'identifiant historique est la clé d'idempotence au sein d'un compte : allouer deux fois le même identifiant historique renvoie le même UNI avec 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'isolation suit le modèle FORCE RLS du dépôt (paire v956 de portée de compte, garde de portée systémique, garde d'appartenance v959). Les compteurs ne contiennent aucune donnée de locataire ; ils sont lisibles depuis n'importe quelle portée. Le test d'intégration démontre, sur un véritable PostgreSQL, en tant que 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)Hors ligne correspond à une erreur 503 typée (AuthoritativeStoreUnavailableError); there is no memory fallback.
Citer
NS-3, clause 4. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-44. Ce qui change pour les voies d'ingestion
- 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. - Réf. : construire avec
formatRecordRef(recordUni, recordVersion)and read withparseRecordRef(ref); both forms are accepted so correction dependencies keep resolving across the transition.
Citer
NS-3, clause 4a. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-4a4a. Voies adoptées
- Amorçage WDI (CGRIC-03) : attribue des UNI SR et OB avec une vérification
uniScope;WdiBootstrapResult.uniAllocation. - Real-data hydration (
server/unrisk/realDataHydration.ts, NS-3c):hydrateUnriskRealData(context, { uniScope: { accountId }, recordUniStore? })établit des correspondances entre chaqueobs:unrisk:<key>@<version>réf. de l'hydratation à un OB UNI (région = ISO3 pour les hydratations à portée nationale) viaserver/unrisk/realDataRecordUni.tset consigne le résultat dansdata.uniAllocation(ALLOCATEDwith crosswalks,NOT_REQUESTED, orUNAVAILABLEavec progression partielle). L'ingestion synchrone (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.tslectures{ 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/runle transmet sous la formeuniScopeaux rééchantillonnages bootstrap des WDI ;UnriskFabricScope.accountIdis forwarded byrunUnriskFabricQuerythroughhydrateUnriskRealDataCompleteethydrateUnriskRealDataExtendedtohydrateUnriskRealData. 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.tsattribue un identifiant UNI OB à chaque observation écrite par le plan de données publiques (indicateurs natifs de la Banque mondiale, de l'UNSD, de l'OMS, du FMI et des adaptateurs statistiques ; événements d'aléas publics ; enregistrements courants, de prévision et d'ensemble d'Open-Meteo) dans le périmètre propre au système que le plan utilise déjà pour SQL (compteACC-GRIX-PUBLIC-DATA, identitysystem:grix-public-data). REGION est la dimension ISO3 ou la référence de lieu du pays ; les points et les valeurs globales n'ont pas de région. L'ancienrecordUnistays 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'suniAllocationrapportsUNAVAILABLEwith the partial counts; any other scope isNOT_REQUESTED.
Citer
NS-3, clause 5. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-55. Suites
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 colonne activée grix_chrono.observation_facts afin que l' UNI puisse être interrogé sans lire le contenu de l'enregistrement ; le périmètre de Builder v2 devient limité aux déclarations, de sorte que son outil puisse aussi transmettre.
Historique des modifications
Versions from the catalogue; entries from the changelog that name this document.
| Version | Date | Note |
|---|---|---|
0.1.0 | 16 octobre 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/.