Cita
NS-16, clause 1. NXS-STD-ST-000015@0.1.0. https://nexustandards.com/standards/ns-16/#nx-c-1
1. The pattern (NS16-R1 to NS16-R4)
Context name NXS-<SCOPE>[-<DOMAIN>][-<SECTOR>][-<REGION>][-<ENV>] NXS-GRX-WAT-CAN Artifact UNI NXS-<SCOPE>-<CAT>[-<DOMAIN>][-<SECTOR>][-<REGION>][-<ENV>]-<SERIAL>[@<VERSION>] NXS-GRX-AR-WAT-CAN-000012@1.0.0 Context record NXS-<SCOPE>-DP|PR[-<DOMAIN>][-<SECTOR>][-<REGION>][-<ENV>]-<SERIAL> NXS-GRX-DP-WAT-CAN-000001
- NS16-R1 One name, many artefacts. Everything about one context carries the same context name and differs only in CAT and SERIAL: the article
NXS-GRX-AR-WAT-CAN-000012, the dataset NXS-GRX-DS-WAT-CAN-000004, il rapporto NXS-GRX-RP-WAT-CAN-000002, il valore mostrato nella dashboard NXS-GRX-FG-WAT-CAN-000009, il dispiegamento NXS-GRX-DP-WAT-CAN-000001, la clausola NXS-GOV-CL-WAT-CAN-000003 (a clause's scope is its issuer, its context segments its subject). - NS16-R2 Il nome è derivato, l' UNI è assegnato. Un nome di contesto non viene mai coniato né digitato con un numero di serie; viene calcolato a partire da un UNI eliminando CAT e SERIAL. Scrivere
NXS-GRX-WAT-CAN-000012 (no CAT) è un errore, così come lo è inventare un numero di serie. - NS16-R3 I segmenti sono codici, non parole.
WAT, CAN, WUT, PRD come from the registries (domains.yaml, sectors.yaml, regions.yaml, nexus-standards.yaml#identifier.environments); un'etichetta di giurisdizione già presente in un modulo (ISO 3166-1 alpha-2, GLOBAL, un'etichetta regionale) corrisponde a una REGION solo tramite registry/jurisdictions.yaml, never by guess. A new domain or sector is a proposal under NS-13 before any artefact uses it. Prose spells the meaning next to the code on first use: "NXS-GRX-WAT-CAN (the data system, water, Canada)". - NS16-R4 Most specific true context, nothing more. An artefact carries only the segments that are true of all of it. A Canada-wide water article is
…-WAT-CAN-…; un articolo solo sui servizi di pubblica utilità aggiunge WUT; un metodo globale per l'acqua comporta WAT alone; an artefact about two countries carries the M49 region that contains both or no REGION, with the countries in context.jurisdictions o quello del registro keywords. A segment is never added for search engine reasons.
Cita
NS-16, clause 2. NXS-STD-ST-000015@0.1.0. https://nexustandards.com/standards/ns-16/#nx-c-2
2. Articoli e pubblicazioni (AR, PP, RP, TN, WP, BK, CP, PS, PO) (da NS16-R5 a NS16-R8)
| Superficie | Trasporta | Esempio |
|---|
| Frontespizio (Markdown, head HTML, proprietà di base DOCX) | uni, contextName, version, publisherRef, license | uni: NXS-GRX-AR-WAT-CAN-000012, contextName: NXS-GRX-WAT-CAN |
| Riquadro del titolo | title; the UNI sotto di esso nello stile identificativo del documento; il nome del contesto come chip | "Osservazioni idriche per i bacini canadesi" · NXS-GRX-AR-WAT-CAN-000012@1.0.0 · etichetta NXS-GRX-WAT-CAN |
| Running header or footer | UNI con versione | NXS-GRX-AR-WAT-CAN-000012@1.0.0 · page 3 |
| Citazione (NS-2) | UNI, versione, editore, data, URL del resolver | … NXS-GRX-AR-WAT-CAN-000012@1.0.0. https://nexustandards.com/uni/NXS-GRX-AR-WAT-CAN-000012 |
| Dati e figure all'interno | ciascuno citato con il proprio UNI e la propria versione nella didascalia o nella nota della tabella | Fig. 2 NXS-GRX-FG-WAT-CAN-000009@1, dati NXS-GRX-DS-WAT-CAN-000004@2 |
| WordPress | _nexus_uni meta, <meta name="nexus-uni">, data-nexus-uni on the article root, slug derived from the title (never from the UNI) | /water-observations-canadian-basins/ |
- NS16-R5 L'UNI di un articolo viene generato al momento della creazione della bozza, non della pubblicazione; il record resta in stato DRAFT fino alla pubblicazione e non cambia mai identificativo.
- NS16-R6 A new edition that changes claims is a new version (
@2.0.0) della stessa UNI; una traduzione è una versione con language set; a new article is a new serial. - NS16-R7 Every number, figure, dataset and model the article relies on is cited by UNI and version; a claim without a citable record carries the NS-0 P6 wording ("not observed", "estimated", "declared").
- NS16-R8 L'articolo non designa mai il sistema con un termine di marca; lo designa con il nome visualizzato (
NXS-GRX) and context name, with the meaning spelled on first use.
Cita
NS-16, clause 3. NXS-STD-ST-000015@0.1.0. https://nexustandards.com/standards/ns-16/#nx-c-3
3. Documenti, standard, politiche e clausole (DC, ST, PC, CL, TN, DL) (da NS16-R9 a NS16-R11)
- NS16-R9 First line of every Markdown document:
Nexus-UNI: <uni>; a context-specific document also carries the context name in its title block (NS-4). Standards themselves have no context segments (they are STD-scope and global). - NS16-R10 Una politica o una clausola riporta l'emittente come SCOPE e il contesto del soggetto come segmenti:
NXS-GOV-PC-WAT-CAN-000001 è una politica di governance per l'acqua in Canada; il suo appliesTo e subjects selectors list the same domain and jurisdiction, and the standards validator refuses a mismatch between segments and selectors. - NS16-R11 Le attestazioni di una clausola (
NXS-NSF-AT-…) non hanno segmenti di contesto propri: li reca il soggetto UNI all'interno dell'attestazione.
Cita
NS-16, clause 4. NXS-STD-ST-000015@0.1.0. https://nexustandards.com/standards/ns-16/#nx-c-4
4. Codice, schemi, migrazioni e modelli (SW, SV, SC, MG, WF, MD) (NS16-R12 a NS16-R15)
| Superficie | Trasporta | Esempio |
|---|
| Source file header, line 1 or 2 | // Nexus-UNI: <uni> (the module's own UNI, scope of the owning system, no context segments) | // Nexus-UNI: NXS-GRX-SW-000004 |
| Context-specific module (a Canada water adapter) | il modulo UNI con segmenti | // Nexus-UNI: NXS-GRX-SW-WAT-CAN-000001 |
| Manifesto del pacchetto | nexus.uni, nexus.contextName | "nexus": { "uni": "NXS-GRX-SW-000004" } |
| JSON Schema | $id riporta il percorso nel repository; x-nexus-uni carries the UNI | "x-nexus-uni": "NXS-STD-SC-000002" |
| Migrazione SQL | -- Nexus-UNI: <uni> alla riga 2 | -- Nexus-UNI: NXS-GOV-MG-000001 |
| Model card, dataset sheet (NS-12) | uni, contextName, UNI dei dati di addestramento | NXS-GRX-MD-WAT-CAN-000002 |
| Container image, SBOM, build attestation | the UNI as an OCI annotation org.nexus.uni and in the SBOM externalReferences | |
| Git | trailer del commit Nexus-UNI: <uni> when a commit introduces or versions an artefact (optional, recommended) | |
- NS16-R12 L'UNI di un modulo di codice identifica il modulo, non le sue implementazioni; un'implementazione è un record di contesto NS-9 (
DP) il cui context.ofUni is the module or system UNI, and the deployment's context name (NXS-GRX-WAT-WUT-CAN-PRD) is what operators, dashboards and incident records use. - NS16-R13 The header UNI is checked by the repository validator against the catalogue; a header naming a UNI the catalogue does not hold fails CI.
- NS16-R14 Configuration keyed by context uses the context name as the key (
contexts["NXS-GRX-WAT-CAN"]), never a free-text label, so that configuration, records and pages join on one string. - NS16-R15 Gli identificatori nel codice sono stringhe convalidate dalla libreria NS-1 (
parseNxsId); il codice non costruisce mai un UNI per concatenazione se non tramite formatNxsId with a serial the fabric returned.
Cita
NS-16, clause 5. NXS-STD-ST-000015@0.1.0. https://nexustandards.com/standards/ns-16/#nx-c-5
5. Dati e registrazioni (DS, EV; tipi di registrazione NS-3) (da NS16-R16 a NS16-R18)
- NS16-R16 Un dataset relativo a un contesto riporta i segmenti di contesto:
NXS-GRX-DS-WAT-CAN-000004. I suoi record NS-3 mantengono una propria grammatica (NXS-GRX-OB-CAN-000042@3): record kinds carry REGION and may carry DOMAIN and SECTOR; the dataset lists its records' UNIs in the STAC, DCAT and PROV-O crosswalks (NS-3b). - NS16-R17 Every table or file that stores records has a
uni column or field holding the full UNI and, where it helps queries, a context_name colonna da essa derivata; la derivazione è una funzione dell'UNI, mai una seconda fonte di verità. - NS16-R18 A map tile, figure or product rendered from data carries the UNIs of the data it rendered (NS-5) and its own UNI; a tile without a provenance UNI is a fixture and is labelled as one.
Cita
NS-16, clause 6. NXS-STD-ST-000015@0.1.0. https://nexustandards.com/standards/ns-16/#nx-c-6
6. APIs and services (SV) (NS16-R19 to NS16-R22)
| Superficie | Trasporta |
|---|
| Intestazione della risposta | X-Nexus-UNI: <uni of the primary record>; X-Nexus-Context: <context name> quando la risposta è circoscritta a un contesto |
| Corpo della risposta | uni on every record; contextName in ogni elenco circoscritto a un contesto; mai un punteggio derivato senza gli UNI da cui proviene |
| Richiesta | context filters use the context name or its segments (?context=NXS-GRX-WAT-CAN or ?domain=WAT®ion=CAN); never a free-text label |
| Resolver | GET /uni/<uni> landing page or JSON; GET /ctx/<contextName> every published record of the context, newest first, by CAT |
| OpenAPI | x-nexus-uni on the document and on every operation that serves a catalogued record |
| Errori | Problema RFC 9457 con uni e contextName quando noto, e il codice digitato (UNI_INVALID, UNI_NOT_IN_CATALOG, CONTEXT_UNKNOWN) |
- NS16-R19 L' UNI (SV) di un servizio si trova nella sua risposta sullo stato di salute; un servizio distribuito per un contesto riporta l'UNI del record del contesto di distribuzione (
DP) e il nome del contesto in /ready. - NS16-R20 Un'API non ricava mai un contesto dall'indirizzo, dalla lingua o dal tenant del chiamante; il contesto è esplicito nella richiesta o nel record.
- NS16-R21 Gli endpoint di elenco limitati a un contesto restituiscono record di quel preciso nome di contesto e, quando
?include=narrower, of names that extend it (NXS-GRX-WAT-CAN comprende NXS-GRX-WAT-WUT-CAN); never the reverse. - NS16-R22 Writes that create a catalogued artefact return
201 with the allocated UNI and the X-Nexus-UNI intestazione; quando la struttura non è disponibile, la risposta riporta il tipo uniAllocation state and the record stays DRAFT (NS-10/11 Commons adoption).
Cita
NS-16, clause 7. NXS-STD-ST-000015@0.1.0. https://nexustandards.com/standards/ns-16/#nx-c-7
7. Interfacce: pagine, sale, dashboard e passaporti (da NS16-R23 a NS16-R27)
| Elemento | Regola |
|---|
| Intestazione della pagina | <meta name="nexus-uni">, <link rel="canonical"> alla pagina di destinazione del resolver, JSON-LD identifier |
| Percorso di navigazione | display name → context name chips in segment order → artefact: NXS-GRX › WAT › CAN › Article 000012 |
| Identifier line | l' UNI completo con versione in monospazio, azione di copia, collegamento a /uni/<uni> |
| Context chip | NXS-GRX-WAT-CAN, one chip, links to /ctx/<contextName>; al passaggio del puntatore ogni segmento viene scandito per esteso |
| Pannello della sala | every row shows its UNI (or its typed pending state) and its supported claim level; a context panel is titled by the context name |
| Passaporto (NS-15) | identity section: SU UNI first, then the contexts (DP, PR) the subject belongs to, each as a context chip |
| Filtri | per segmento con le etichette del registro (Dominio: Water; Regione: Canada), mai testo libero |
| Empty state | "No record is catalogued for NXS-GRX-WAT-CAN" with the typed reason, never a blank |
- NS16-R23 L'interfaccia non mostra mai un punteggio, un badge, una classifica o uno stato "live" per un contesto; mostra i record, i relativi UNI e i loro stati registrati (NS-0 P6).
- NS16-R24 A context chip is where a context is named; free-text labels ("Canada water programme") are titles, never identifiers, and never appear without the chip.
- NS16-R25 Token, tipo e entrambi i temi seguono l'UI kit; la riga dell'identificativo usa il token monospace del kit; il chip usa lo stile dell'identificativo, mai un colore di marca.
- NS16-R26 Ogni figura, CSV, PDF o immagine esportati da un cruscotto riportano nei metadati e nel piè di pagina gli UNI di ciò che mostrano.
- NS16-R27 Search indexes the UNI, the context name and each segment with its registry label, so that "Canada water" and
NXS-GRX-WAT-CAN trovano gli stessi record.
Cita
NS-16, clause 8. NXS-STD-ST-000015@0.1.0. https://nexustandards.com/standards/ns-16/#nx-c-8
8. Esempio pratico: il lavoro del sistema di dati sull'acqua in Canada
| Elemento | UNI | Context name | Where it shows |
|---|
| The data system | NXS-GRX-SV-000001 (servizio) | NXS-GRX | pagine dei sistemi, salute |
| Canadian water utilities production deployment | NXS-GRX-DP-WAT-WUT-CAN-PRD-000001 | NXS-GRX-WAT-WUT-CAN-PRD | operator room, /ready, registri degli incidenti |
| Water observations dataset for Canada | NXS-GRX-DS-WAT-CAN-000004@2 | NXS-GRX-WAT-CAN | STAC, DCAT, pagina del dataset |
| Un singolo record di osservazione | NXS-GRX-OB-CAN-000042@3 | NXS-GRX-CAN | API dei registri, elenchi delle evidenze |
| Scheda metodologica sul rischio idrico | NXS-GRX-MD-WAT-000002 | NXS-GRX-WAT | method registry |
| Articolo | NXS-GRX-AR-WAT-CAN-000012@1.0.0 | NXS-GRX-WAT-CAN | nexustandards.com, citation, Zenodo deposit |
| Figure in the article | NXS-GRX-FG-WAT-CAN-000009@1 | NXS-GRX-WAT-CAN | didascalia, piè di pagina dell'esportazione |
| Politiche per gli operatori idrici canadesi | NXS-GOV-PC-WAT-WUT-CAN-000001 | NXS-GOV-WAT-WUT-CAN | Commons, pannello della sala |
| Clausola: copertura delle osservazioni | NXS-GOV-CL-WAT-CAN-000003 | NXS-GOV-WAT-CAN | Commons, evaluation |
| Attestazione della clausola sull'implementazione | NXS-NSF-AT-000017 | nessuno (il contesto è riportato nell'oggetto) | sezione della politica sui passaporti, pannello della sala |
Reading any row: the display name tells which system, the chip tells where and about what, the UNI tells which artefact and version, the resolver tells what is recorded about it.
Cita
NS-16, clause 9. NXS-STD-ST-000015@0.1.0. https://nexustandards.com/standards/ns-16/#nx-c-9
9. Conformità (NS-14)
| Livello | Requisiti |
|---|
| NS-16 Base | R1, R2, R3, R9, R12, R13, R15, R19, R22, R23 |
| Standard NS-16 | Base più da R4 a R8, R10, R14, R16, R17, R20, R21, R24, R27 |
| NS-16 Full | ogni regola |
A consumer declares its level in registry/consumers.yaml; VERIFIED needs NS-11 attestations by a mandated evaluator (the repository validator and the API contract validator are the evaluators of R9, R13, R19 and R22).
Cita
NS-16, clause 10. NXS-STD-ST-000015@0.1.0. https://nexustandards.com/standards/ns-16/#nx-c-10
10. Questioni aperte
- NS16-O1 whether record kinds (NS-3) may carry DOMAIN and SECTOR in production allocations, or REGION only (fabric key change in nexus-foundry SQL 2033).
- NS16-O2 the
/ctx/ resolver's treatment of restricted records (count only, or omit). - Giurisdizioni di suddivisione NS16-O3 (ISO 3166-2,
CA-ON) as a fifth segment or record-only; record-only until decided. - NS16-O4 (resolved 2026-10-16) how jurisdiction labels already held by forms reach the REGION segment: through
registry/jurisdictions.yaml (alpha-2, etichette GLOBAL e regionali verso alpha-3 o M49; UE deliberatamente assente), incorporata nel codice (vendored) e verificata dai consumatori tramite test di deriva.
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 |
Il registro delle modifiche non riporta alcuna voce che citi NS-16.