盖蒂乌斯符号系统 (GNOT)

2. 加蒂武斯记号法（GNOT）

命名规则 · NDDI 可视化 · 形状与颜色 · 图表 · 文档编号

2. 1. GNOT 的目的

GNOT（加蒂武斯记号法）是一套统一的命名、可视化和文档编写规则，确保加蒂武斯项目的所有文档、图表和工具的一致性。GNOT 适用于全部三本书（GTOM、GNET、GATE）以及所有衍生文档。

该记号法的必要性由项目规模决定：架构包含数十个实体、数百种组件类型和关系、数千种可能的配置。如果没有统一的记号法，阅读规范文档的开发人员将不可避免地开始使用自己的表示法，导致文档不兼容和实现错误。

GNOT 不是装饰性元素。它是一个工程标准，类似于电气原理图标准（IEEE）、建筑图纸标准（ISO）或网络拓扑图标准（RFC）。每条规则都有其技术依据。

2. 2. 命名规则

规则 1：四个字符。 加蒂武斯项目中的所有缩写恰好包含四个字符。允许的字符：拉丁字母（A–Z）和数字（0–9）。无例外。

理由：四字符格式确保了紧凑性（在 ASCII 编码下可放入 32 位字）、统一性（表格和代码中所有术语长度相同）和可识别性（读者能立即将四字符词识别为加蒂武斯术语）。

正确命名示例：NDDI、UNON、LOCN、OPRN、KLEN、MOTV、BLOM、KLOM、WLOM、SERN、SRNT、GATE、GNET、GNOT、APAK、AIOT、RTYP、PLEN、SYGN、NRGN、ANOD、AGMT、GLNS、POCN。

不正确命名示例：REL_TYPE（超过 4 个字符，包含下划线）、PID（3 个字符）、MAP（3 个字符 —— 仅与层级后缀一起使用：MAP1、MAP3、MAP8、MAPA）。

规则 2：层级后缀。 存在于多个层级的实体，命名为基名（3 个字符）+ 层级后缀（1 个字符）。后缀：数字（1–9）或字母（A–D）。

基名

后缀

示例

MAP

1, 2, 3, 4, 5, 6, 8, 9, A, B, C, D

MAP1、MAP3、MAP8、MAPA、MAPB、MAPC、MAPD

OPN

1, 2, 3, 6, 7, 8, B

OPN1、OPN3、OPN6、OPN7、OPN8、OPNB

TRL

3, 8, B

TRL3、TRL8、TRLB

CNN

1, 2, 3

CNN1、CNN2、CNN3

DOM

0, 1, 2, 3, 4, 5, 6, 8, 9, A, B, C, D

DOM0、DOM3、DOM8、DOMA、DOMB

缺失的编号（MAP7、DOM7）不是遗漏 —— 它们在架构中不存在。MAP7 不存在。DOM7 是 OPN7（注意力），它没有自己的 MAP。

规则 3：禁止复合名。 不使用带下划线、连字符或驼峰式的复合名。每个术语都是一个单独的四字符词。

示例：用 RTYP 代替 REL_TYPE。用 PLEN 代替 PAYLOAD_LEN。用上下文代替 SRC_ADDR（报头 src 字段中的 UNON）。

2. 3. NDDI 的可视化

规则 4：多面体。 NDDI 可视化为多面体。基本形状是立方体。每个面包含一种类型的组件。

对于立方体，同时可见三个面 —— 顶面、正面和右面。在大多数情况下，三个可见面足以显示主要的组件类型。当需要显示更多类型时，可以旋转多面体（显示其他面）或使用具有更多面的多面体。

规则 5：面的命名。 面根据其上放置的组件类型命名：V 面、A 面、D 面、T 面、L 面、R 面、B 面、S 面、N 面、P 面、C 面、W 面、G 面。

规则 6：网格。 组件放置在面的规则矩形网格上。每个网格单元可包含一个组件。允许空单元格 —— 表示该位置没有组件。网格大小由特定 NDDI 中给定类型的组件数量决定。

规则 7：最小 NDDI。 最小节点（D + V + A）可视化为一个立方体，具有三个可见面：D 面（代码）、V 面（值）、A 面（活动）。

规则 8：UNON。 UNON 名称显示在立方体（多面体）的边框上，从任何角度都可见。名称格式为 GATN:GANN（例如 0001:0042）。使用等宽字体。

2. 4. 组件的形状

规则 9：唯一形状。 每种组件类型具有唯一的几何形状，无需阅读标签即可立即识别类型。

规则 10：颜色是强制的。 在彩色打印或屏幕显示时，颜色是强制性的识别元素。在单色打印时 —— 仅使用形状。形状的选择使得无颜色时也能区分。

2. 5. 连接器的形状

规则 11：插针与插孔。 连接器可视化为位于组件本体上并突出于表面的插针（输出）或插孔（输入）。

规则 12：形状类型化。 连接器类型由关系类型决定。插针的形状与插孔的形状匹配 —— 但插针是凸的，插孔是凹的。一种类型的插针在物理上无法插入另一种类型的插孔 —— 强类型化的视觉表达。

2. 6. 关系的可视化

规则 13：线条。 两个 NDDI 之间的关系可视化为连接一个节点的插针到另一个节点插孔的线条（导线）。线条颜色对应关系类型（与连接器颜色一致）。

规则 14：方向性。 线条在接收端有一个箭头（从插针指向插孔）。双向关系 —— 两条平行线，带有两个相反方向的箭头。

规则 15：粗细。 线条粗细可以反映关系的强度（数据报传输频率）。细线 —— 罕见事件。粗线 —— 高频流。如果没有强度信息 —— 所有线条粗细相同。

规则 16：交付模式。 可靠关系 —— 实线。不可靠关系 —— 虚线。

2. 7. DOM 层级的可视化

规则 17：水平层。 DOM 层级可视化为从下到上排列的水平层。底层 —— 物理层，顶层 —— 价值层。

规则 18：虚拟层级。 社会（虚拟）层级（MAP4、MAP5、MAP9、MAPC、MAPD）以虚线边界可视化 —— 它们没有单一的物理载体，也没有自己的 OPN/TRL。

规则 19：垂直连接。 层级之间的连接（CNN1/CNN2/CNN3 —— 向上卷积，编译 —— 向下）可视化为垂直箭头。推理 —— 向上箭头。编译 —— 向下箭头。学习 —— 目标层级内的双向箭头。

2. 8. TRL 的可视化

规则 20：磁带。 TRL 可视化为一条水平磁带，记录从左到右放置。左端 —— 过去，右端 —— 未来。当前 OPN 位置用一个垂直标记标出。

规则 21：记录状态。 TRL 记录根据状态不同以不同方式可视化：

}状态轮廓填充边框 }已计划虚线无填充— }建设中实线部分填充（阴影线）— }已完成（+）实线完全填充绿色边框 }已完成（0）实线完全填充灰色边框 }已完成（−）实线完全填充红色边框

2. 9. 向量的可视化

规则 22：箭头。 向量（b、P、W）可视化为箭头。箭头颜色对应向量类型。粗细与模（距离）成正比。

规则 23：一般向量与特定向量。 一般向量（有方向无模） —— 虚线箭头，不指示长度。特定向量（有坐标和模） —— 实线箭头，长度与模成正比。

2. 10. 路由的可视化

规则 24：G1/G2/G3 级别。 三个路由级别通过关系线的不同描边来可视化：

规则 25：GATE。 GATE 设备可视化为带有粗边框的矩形，包含多个 NDDI（多面体）。GATN 名称显示在矩形的标题中。

2. 11. 文档编号

规则 26：SPC 前缀。 加蒂武斯项目的文档具有前缀 SPC（规格说明）和子系统代码：

规则 27：文档编号。 前缀后跟三位顺序号。示例：SPC-GATE-814、SPC-GNET-001。

规则 28：图表标题。 每个图表需有标题：图号、名称、文档编号。示例：「Drawing 4: Relation over IP concept. SPC-GATE-814」。

2. 12. 图表格式规则

规则 29：NDDI 图表的必备元素。 每个 NDDI 图表包含：UNON 名称、可见面（至少三个）、面上的组件（使用正确的形状和颜色）、带有反名称的连接器。

规则 30：关系图的必备元素。 每个关系图包含：两个（或更多）NDDI、连接器之间的线条、关系类型（RTYP）、方向性（箭头）、交付模式（实线或虚线）。

规则 31：组图的必备元素。 功能组图包含：带有 G 组件（ANOD）的 NDDI、子 NDDI、它们之间的关系、组边界（点划线）、组间关系（如果有）。

规则 32：缩放。 在可视化包含众多 NDDI 的系统时，允许简化：NDDI 显示为一个点（无面），关系显示为点之间的线条。此模式下不显示连接器的形状和颜色。此模式用于大型网络的概览图。

2. 13. 结论

GNOT 定义了 32 条关于命名、可视化和文档编写的规则。这些规则确保了：

• 统一性：加蒂武斯架构的任何元素都可以通过其形状、颜色和四字符名称唯一识别。

• 强类型化：连接器的形状保证了不同类型关系在视觉上的不兼容性。

• 可伸缩性：从单个 NDDI 的详细图到包含数百万个节点的网络概览图。

• 兼容性：该记号法在 GTOM（理论）、GNET（网络）和 GATE（平台）中应用一致。

加蒂武斯项目的所有文档都必须遵守 GNOT。