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, el conjunto de datos NXS-GRX-DS-WAT-CAN-000004, el informe NXS-GRX-RP-WAT-CAN-000002, la cifra del panel NXS-GRX-FG-WAT-CAN-000009, el despliegue NXS-GRX-DP-WAT-CAN-000001, la cláusula NXS-GOV-CL-WAT-CAN-000003 (a clause's scope is its issuer, its context segments its subject). - NS16-R2 El nombre se deriva, el UNI se asigna. Un nombre de contexto nunca se acuña ni se escribe con un número de serie; se calcula a partir de un UNI eliminando CAT y SERIAL. Escribir
NXS-GRX-WAT-CAN-000012 (no CAT) is an error, as is inventing a serial. - NS16-R3 Los segmentos son códigos, no palabras.
WAT, CAN, WUT, PRD come from the registries (domains.yaml, sectors.yaml, regions.yaml, nexus-standards.yaml#identifier.environments); una etiqueta de jurisdicción que ya figura en un formulario (ISO 3166-1 alpha-2, GLOBAL, una etiqueta regional) se asigna a una REGION solo mediante 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-…; a utilities-only article adds WUT; un método hídrico mundial conlleva WAT alone; an artefact about two countries carries the M49 region that contains both or no REGION, with the countries in context.jurisdictions or the record's 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. Artículos y publicaciones (AR, PP, RP, TN, WP, BK, CP, PS, PO) (NS16-R5 a NS16-R8)
| Superficie | Transporta | Ejemplo |
|---|
| Metadatos iniciales (Markdown, cabecera HTML, propiedades básicas de DOCX) | uni, contextName, version, publisherRef, license | uni: NXS-GRX-AR-WAT-CAN-000012, contextName: NXS-GRX-WAT-CAN |
| Bloque de título | title; the UNI bajo él con el estilo de identificador del documento; el nombre del contexto como etiqueta | "Observaciones del agua para cuencas canadienses" · NXS-GRX-AR-WAT-CAN-000012@1.0.0 · chip NXS-GRX-WAT-CAN |
| Running header or footer | UNI with version | NXS-GRX-AR-WAT-CAN-000012@1.0.0 · page 3 |
| Cita (NS-2) | UNI, versión, editor, fecha, URL del resolvedor | … NXS-GRX-AR-WAT-CAN-000012@1.0.0. https://nexustandards.com/uni/NXS-GRX-AR-WAT-CAN-000012 |
| Datos y figuras incluidos | cada una citada con su propio UNI y su versión en el pie de figura o en la nota de la tabla | Figura 2 NXS-GRX-FG-WAT-CAN-000009@1, data 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 El UNI de un artículo se genera cuando se crea el borrador, no cuando se publica; el registro permanece en estado DRAFT hasta la publicación y nunca cambia de identificador.
- NS16-R6 A new edition that changes claims is a new version (
@2.0.0) del mismo UNI; una traducción es una versión con language set; a new article is a new serial. - NS16-R7 Todo número, cifra, conjunto de datos y modelo en que se apoya el artículo se cita por UNI y versión; una afirmación sin registro citable lleva la formulación NS-0 P6 ("no observado", "estimado", "declarado").
- NS16-R8 The article never names the system by a brand word; it names it by display name (
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. Documentos, normas, políticas y cláusulas (DC, ST, PC, CL, TN, DL) (NS16-R9 a NS16-R11)
- NS16-R9 First line of every Markdown document:
Nexus-UNI: <uni>; un documento específico de un contexto también incluye el nombre del contexto en su bloque de título (NS-4). Las normas en sí no tienen segmentos de contexto (son de ámbito STD y globales). - NS16-R10 Una política o cláusula lleva al emisor como SCOPE y el contexto del asunto como segmentos:
NXS-GOV-PC-WAT-CAN-000001 es una política de gobernanza del agua en Canadá; su appliesTo y subjects los selectores enumeran el mismo dominio y la misma jurisdicción, y el validador de estándares rechaza una discrepancia entre segmentos y selectores. - NS16-R11 Las atestaciones de una cláusula (
NXS-NSF-AT-…) no llevan segmentos de contexto propios: los lleva el UNI del sujeto dentro de la atestación.
Cita
NS-16, clause 4. NXS-STD-ST-000015@0.1.0. https://nexustandards.com/standards/ns-16/#nx-c-4
4. Código, esquemas, migraciones y modelos (SW, SV, SC, MG, WF, MD) (NS16-R12 a NS16-R15)
| Superficie | Transporta | Ejemplo |
|---|
| Source file header, line 1 or 2 | // Nexus-UNI: <uni> (la UNIpropia del módulo, alcance del sistema propietario, sin segmentos de contexto) | // Nexus-UNI: NXS-GRX-SW-000004 |
| Context-specific module (a Canada water adapter) | el módulo UNI con segmentos | // Nexus-UNI: NXS-GRX-SW-WAT-CAN-000001 |
| Package manifest | nexus.uni, nexus.contextName | "nexus": { "uni": "NXS-GRX-SW-000004" } |
| JSON Schema | $id carries the repository path; x-nexus-uni carries the UNI | "x-nexus-uni": "NXS-STD-SC-000002" |
| SQL migration | -- Nexus-UNI: <uni> en la línea 2 | -- Nexus-UNI: NXS-GOV-MG-000001 |
| Model card, dataset sheet (NS-12) | uni, contextName, UNI de los datos de entrenamiento | NXS-GRX-MD-WAT-CAN-000002 |
| Imagen de contenedor, SBOM, atestación de compilación | the UNI as an OCI annotation org.nexus.uni y en el SBOM externalReferences | |
| Git | commit trailer Nexus-UNI: <uni> when a commit introduces or versions an artefact (optional, recommended) | |
- NS16-R12 El UNI de un módulo de código identifica el módulo, no sus despliegues; un despliegue es un registro de contexto NS-9 (
DP) cuyo 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"]), nunca una etiqueta de texto libre, de modo que la configuración, los registros y las páginas se vinculen mediante una misma cadena. - NS16-R15 Los identificadores en el código son cadenas validadas por la biblioteca NS-1 (
parseNxsId); el código nunca construye un UNI por concatenación, salvo mediante formatNxsId con un número de serie devuelto por la infraestructura.
Cita
NS-16, clause 5. NXS-STD-ST-000015@0.1.0. https://nexustandards.com/standards/ns-16/#nx-c-5
5. Data and records (DS, EV; NS-3 record kinds) (NS16-R16 to NS16-R18)
- NS16-R16 Un conjunto de datos sobre un contexto lleva los segmentos de contexto:
NXS-GRX-DS-WAT-CAN-000004. Sus registros NS-3 conservan su propia gramática (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 column derived from it; the derivation is a function of the UNI, never a second source of truth. - 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 | Transporta |
|---|
| Encabezado de respuesta | X-Nexus-UNI: <uni of the primary record>; X-Nexus-Context: <context name> when the response is scoped to a context |
| Response body | uni en cada registro; contextName en cada lista acotada a un contexto; nunca una puntuación derivada sin los UNI de los que procede |
| Solicitud | los filtros de contexto usan el nombre del contexto o sus segmentos (?context=NXS-GRX-WAT-CAN or ?domain=WAT®ion=CAN); nunca una etiqueta de texto libre |
| Resolutor | 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 |
| Errores | RFC 9457 problem with uni y contextName cuando se conoce, y el código introducido (UNI_INVALID, UNI_NOT_IN_CATALOG, CONTEXT_UNKNOWN) |
- NS16-R19 El propio UNI (SV) de un servicio figura en su respuesta de estado; un servicio desplegado para un contexto informa el UNI del registro del contexto de despliegue (
DP) y nombre del contexto en /ready. - NS16-R20 Una API nunca deriva un contexto a partir de la dirección, el idioma o el inquilino de quien realiza la llamada; el contexto es explícito en la solicitud o en el registro.
- NS16-R21 Los puntos de acceso de listado acotados a un contexto devuelven registros de ese nombre de contexto exacto y, cuando
?include=narrower, of names that extend it (NXS-GRX-WAT-CAN incluye NXS-GRX-WAT-WUT-CAN); never the reverse. - NS16-R22 Writes that create a catalogued artefact return
201 con el UNI asignado y el X-Nexus-UNI header; when the fabric is unavailable the response carries the typed 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. Interfaces: pages, rooms, dashboards and passports (NS16-R23 to NS16-R27)
| Elemento | Regla |
|---|
| Encabezado de página | <meta name="nexus-uni">, <link rel="canonical"> a la página de destino del resolutor, JSON-LD identifier |
| Ruta de navegación | display name → context name chips in segment order → artefact: NXS-GRX › WAT › CAN › Article 000012 |
| Identifier line | el UNI completo con la versión en monoespaciado, acción de copia, enlace a /uni/<uni> |
| Context chip | NXS-GRX-WAT-CAN, one chip, links to /ctx/<contextName>; al pasar el cursor se detalla cada segmento |
| Room panel | every row shows its UNI (or its typed pending state) and its supported claim level; a context panel is titled by the context name |
| Passport (NS-15) | identity section: SU UNI first, then the contexts (DP, PR) the subject belongs to, each as a context chip |
| Filtros | por segmento con las etiquetas del registro (Dominio: Agua; Región: Canadá), nunca en texto libre |
| Empty state | «No hay ningún registro catalogado para NXS-GRX-WAT-CAN» con el motivo tipificado, nunca en blanco |
- NS16-R23 La interfaz de usuario nunca muestra una puntuación, insignia, clasificación o estado «en vivo» para un contexto; muestra registros, sus UNI y sus estados registrados (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 Los tokens, el tipo y ambos temas siguen el kit de interfaz; la línea de identificador usa el token monoespaciado del kit; el chip usa el estilo de identificador, nunca un color de marca.
- NS16-R26 Toda figura, CSV, PDF o imagen exportados desde un panel llevan en sus metadatos y en el pie los UNI de lo que muestran.
- 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 find the same records.
Cita
NS-16, clause 8. NXS-STD-ST-000015@0.1.0. https://nexustandards.com/standards/ns-16/#nx-c-8
8. Ejemplo práctico: el trabajo del sistema de datos sobre el agua en Canadá
| Cosa | UNI | Context name | Where it shows |
|---|
| The data system | NXS-GRX-SV-000001 (servicio) | NXS-GRX | páginas de sistemas, salud |
| Despliegue en producción para servicios de agua de Canadá | NXS-GRX-DP-WAT-WUT-CAN-PRD-000001 | NXS-GRX-WAT-WUT-CAN-PRD | operator room, /ready, registros de incidentes |
| Conjunto de datos de observaciones del agua para Canadá | NXS-GRX-DS-WAT-CAN-000004@2 | NXS-GRX-WAT-CAN | STAC, DCAT, página del conjunto de datos |
| One observation record | NXS-GRX-OB-CAN-000042@3 | NXS-GRX-CAN | API de registros, listas de evidencia |
| Ficha metodológica del riesgo hídrico | NXS-GRX-MD-WAT-000002 | NXS-GRX-WAT | method registry |
| Artículo | NXS-GRX-AR-WAT-CAN-000012@1.0.0 | NXS-GRX-WAT-CAN | nexustandards.com, citation, Zenodo deposit |
| Figura del artículo | NXS-GRX-FG-WAT-CAN-000009@1 | NXS-GRX-WAT-CAN | leyenda, pie de página de exportación |
| Política para los operadores de agua de Canadá | NXS-GOV-PC-WAT-WUT-CAN-000001 | NXS-GOV-WAT-WUT-CAN | Commons, panel de la sala |
| Cláusula: cobertura de observación | NXS-GOV-CL-WAT-CAN-000003 | NXS-GOV-WAT-CAN | Commons, evaluación |
| Atestación de la cláusula en el despliegue | NXS-NSF-AT-000017 | ninguno (el asunto aporta el contexto) | passport policy section, room panel |
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. Conformance (NS-14)
| Nivel | Requisitos |
|---|
| NS-16 Basic | R1, R2, R3, R9, R12, R13, R15, R19, R22, R23 |
| Norma NS-16 | Básico más R4 a R8, R10, R14, R16, R17, R20, R21, R24, R27 |
| NS-16 Full | cada regla |
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. Cuestiones pendientes
- 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). - Jurisdicciones de subdivisión de 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, etiquetas GLOBAL y regionales a alpha-3 o M49; la UE está ausente de forma deliberada), incorporado como copia local por los consumidores, que lo someten a pruebas de deriva.
Historial de cambios
Versions from the catalogue; entries from the changelog that name this document.
| Versión | Fecha | Nota |
|---|
0.1.0 | 16 de octubre de 2026 | current version in the catalogue |
El registro de cambios no contiene ninguna entrada que nombre NS-16.