- Código
NS-3- Título
- UNIs de registros de risco (gramática, correspondência com o legado, autoridade de alocação)
- Versão
- 0.1.0
- Situação
- PROPOSTO
- Data
- catalogue 2026-10-16 · circulated 17 October 2026
- Unique Nexus Identifier
NXS-STD-ST-000003- Escopo de responsabilidade
- confiança; dados canônicos
- 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.
- Situação
- PROPOSTO
- Proprietário
- the trust and assurance system (standard) and NXS-GRX (records)
- Implementação de referência (nexus-foundry): biblioteca
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).
Citar
NS-3, clause 1. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-11. Gramática
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 bem como @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 | Código | Tipo | Código |
|---|---|---|---|
| Fato de observação | OB | Versão do cronótopo | CT |
| Versão de origem | SR | Registro de correção | CR |
| Definição do indicador | IN | Registro de produto analítico | AP |
| Definição da medida | ME | Objeto (lugar, ativo, organização) | SU |
| Versão dos limites | 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).
Citar
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 já traz identificadores de registro como obs:unrisk:<key>, uni:source:worldbank.wdi, uni:indicator:<code> e identificadores com pontos, como grix.eo.stac.catalogue. São interpretados como LEGACY, keep working in <ref>@<version> refs (parseRecordRef, hoje usado pelo fichário governado de recortes de dados de risco), e são mapeados para um NS-1 UNI quando este é alocado. Nada é renomeado no local; um registro ou carrega um NS-1 recordUni (novos registros) ou um legado recordUni mais o valor alocado uni (ObservationFact.uni, opcional durante a transição).
Citar
NS-3, clause 3. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-33. Allocation
Os números de série nunca são derivados nem digitados à mão (NS1-R2). Eles vêm de nexus_uni.allocate_record_serial(scope, category, region), um contador atômico por (GRX, kind, region) in nexus_uni.record_serial_sequence, avançado apenas dentro de uma transação de locatário delimitada (ou do bypass da plataforma). Cada alocação é uma linha somente de acréscimo em 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.
O isolamento segue o padrão FORCE RLS do repositório (par de escopo de conta v956, proteção de escopo sistêmico, proteção de associação v959). Os contadores não contêm dados de inquilinos; podem ser lidos por qualquer escopo. O teste de integração comprova, em um PostgreSQL real, como um NOSUPERUSER NOBYPASSRLS papel: seriais compartilhados entre contas, tabela de correspondência privada da conta, um escopo forjado não grava nada, mutação recusada, o contador recusado fora de uma transação com escopo, e a migração é reaplicada sem efeito (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 é um 503 tipado (AuthoritativeStoreUnavailableError); there is no memory fallback.
Citar
NS-3, clause 4. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-44. O que muda para os caminhos de ingestão
- 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. - Refs: construir com
formatRecordRef(recordUni, recordVersion)e leia comparseRecordRef(ref); both forms are accepted so correction dependencies keep resolving across the transition.
Citar
NS-3, clause 4a. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-4a4a. Caminhos adotados
- WDI bootstrap (CGRIC-03): allocates SR and OB UNIs with a verified
uniScope;WdiBootstrapResult.uniAllocation. - Hidratação com dados reais (
server/unrisk/realDataHydration.ts, NS-3c):hydrateUnriskRealData(context, { uniScope: { accountId }, recordUniStore? })correlaciona cadaobs:unrisk:<key>@<version>referência da hidratação a um OB UNI (região = ISO3 para hidratações com escopo de país) por meio deserver/unrisk/realDataRecordUni.tsand records the outcome indata.uniAllocation(ALLOCATEDwith crosswalks,NOT_REQUESTED, orUNAVAILABLEcom progresso parcial). A ingestão síncrona (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.
- Encaminhamento verificado de conta (NS-3d):
server/standards/verifiedUniScope.tsleituras{ 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/runo transmite comouniScopepara os bootstraps do WDI;UnriskFabricScope.accountIdé encaminhado porrunUnriskFabricQuerypor meio dehydrateUnriskRealDataCompleteehydrateUnriskRealDataExtendedtohydrateUnriskRealData. 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.tsaloca um OB UNI para cada observação que o plano de dados públicos grava (indicadores nativos do World Bank, UNSD, WHO, IMF e dos adaptadores estatísticos; eventos públicos de ameaças; registros atuais, de previsão e de conjunto do Open-Meteo) sob o escopo de propriedade do sistema que o plano já usa para SQL (accountACC-GRIX-PUBLIC-DATA, identitysystem:grix-public-data). REGION é a dimensão ISO3 ou a referência de lugar do país; pontos e dados globais não têm região. O legadorecordUnistays 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'suniAllocationrelatóriosUNAVAILABLEwith the partial counts; any other scope isNOT_REQUESTED.
Citar
NS-3, clause 5. NXS-STD-ST-000003@0.1.0. https://nexustandards.com/standards/ns-3/#nx-c-55. Acompanhamento
NS-3b delivered (NS-3b-dataset-and-product-metadata-profile.md). NS-3d (encaminhamento de conta verificada) e NS-3e (ingestões de dados abertos) entregues. Restante: um dedicado uni coluna ativada grix_chrono.observation_facts para que o UNI possa ser consultado sem ler a carga útil do registro; o escopo do Builder v2 passa a ser somente de declarações, de modo que sua ferramenta também possa encaminhar.
Histórico de alterações
Versions from the catalogue; entries from the changelog that name this document.
| Versão | Data | Nota |
|---|---|---|
0.1.0 | 16 de outubro de 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/.