Нотация Гативус (GNOT)
2. Нотация Гативус (GNOT)
Правила именования · Визуализация NDDI · Формы и цвета · Диаграммы · Нумерация документов
2. 1. Назначение GNOT
GNOT (Gativus NOTation) — единый набор правил именования, визуализации и документирования, обеспечивающий единообразие во всех документах, диаграммах и инструментах проекта Гативус. GNOT распространяется на все три книги (GTOM, GNET, GATE) и на все производные документы.
Необходимость нотации определяется масштабом проекта: архитектура содержит десятки сущностей, сотни типов компонентов и отношений, тысячи возможных конфигураций. Без единообразной нотации разработчики, читающие спецификацию, неизбежно начнут использовать собственные обозначения, что приведёт к несовместимости документации и ошибкам реализации.
GNOT не является декоративным элементом. Это инженерный стандарт, аналогичный стандартам электрических схем (IEEE), архитектурных чертежей (ISO) или сетевых диаграмм (RFC). Каждое правило имеет техническое обоснование.
2. 2. Правила именования
Правило 1: четыре символа. Все аббревиатуры в проекте Гативус содержат ровно четыре символа. Допустимые символы: латинские буквы (A–Z) и цифры (0–9). Без исключений.
Обоснование: четырёхсимвольный формат обеспечивает компактность (помещается в 32-битное слово при ASCII-кодировке), единообразие (все термины одинаковой длины в таблицах и коде), узнаваемость (читатель немедленно идентифицирует четырёхсимвольное слово как термин Гативус).
Примеры правильного именования: 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).
Базовое имя |
Суффиксы |
Примеры |
1, 2, 3, 4, 5, 6, 8, 9, A, B, C, D |
||
1, 2, 3, 6, 7, 8, B |
||
3, 8, B |
||
CNN |
1, 2, 3 |
|
0, 1, 2, 3, 4, 5, 6, 8, 9, A, B, C, D |
||
Отсутствующие номера (MAP7, DOM7) не являются пропуском — они отсутствуют в архитектуре. MAP7 не существует. DOM7 — это OPN7 (Внимание), не имеющий собственной MAP.
Правило 3: без составных имён. Составные имена через подчёркивание, дефис или camelCase не используются. Каждый термин — одно четырёхсимвольное слово.
Примеры: вместо REL_TYPE — RTYP. Вместо PAYLOAD_LEN — PLEN. Вместо SRC_ADDR — используется контекст (UNON в поле src заголовка).
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: уникальная форма. Каждый тип компонента имеет уникальную геометрическую форму, позволяющую мгновенно идентифицировать тип без чтения подписи.
Тип |
Форма |
Цвет |
Обоснование формы |
V |
Квадрат |
Зелёный |
Значение — базовый элемент, стабильная форма |
A (APAK) |
Прямоугольник |
Розовый |
Пакет активности — блок последовательного кода |
A (AIOT) |
Шестигранник |
Голубой |
Йота активности — точка ветвления, множество выходов |
D |
Ромб |
Серый |
Структура узла — структурный элемент, отличающийся от данных |
T |
Треугольник |
Оранжевый |
Цель — направленность, указатель |
L |
Круг |
Белый |
Позиция — точка в пространстве |
R |
Овал |
Жёлтый |
Распознавание — мягкая форма, Feature Vector |
B |
Стрелка |
Красный |
Поведение — вектор, направление движения |
S |
Пятиугольник |
Синий |
Символ — абстракция, нефизическая форма |
N |
Прямоугольник со скруглёнными углами |
Фиолетовый |
Нарратив — последовательность, поток |
P |
Двойная стрелка |
Тёмно-синий |
Предикат — связь между двумя символами |
C |
Звезда |
Золотой |
Понятие — высший элемент, сложность |
W |
Молния |
Тёмно-красный |
Противоречие — напряжение, разрыв |
G |
Щит |
Тёмно-зелёный |
Безопасность — защита, полномочия |
Правило 10: цвет обязателен. При цветной печати или экранном отображении цвет является обязательным элементом идентификации. При монохромной печати — используется только форма. Формы выбраны так, чтобы быть различимыми без цвета.
2. 5. Формы соединителей
Правило 11: штырёк и розетка. Соединитель визуализируется как штырёк (исходящий) или розетка (входящий), расположенный на теле компонента и выступающий за поверхность грани.
Правило 12: типизация формой. Тип соединителя определяется типом отношения. Форма штырька совпадает с формой розетки — но штырёк выпуклый, розетка вогнутая. Штырёк одного типа физически не может быть вставлен в розетку другого типа — визуальное выражение строгой типизации.
Тип соединителя |
Сечение штырька/розетки |
Цвет |
v-соединитель |
Круглое |
Зелёный |
d-соединитель |
Квадратное |
Серый |
l-соединитель |
Коническое |
Белый |
r-соединитель |
Овальное |
Жёлтый |
b-соединитель |
Стреловидное |
Красный |
t-соединитель |
Треугольное |
Оранжевый |
s-соединитель |
Пятиугольное |
Синий |
n-соединитель |
Скруглённо-прямоугольное |
Фиолетовый |
p-соединитель |
Двойное |
Тёмно-синий |
c-соединитель |
Звёздчатое |
Золотой |
w-соединитель |
Зигзагообразное |
Тёмно-красный |
g-соединитель |
Щитовидное |
Тёмно-зелёный |
2. 6. Визуализация отношений
Правило 13: линия. Отношение между двумя NDDI визуализируется как линия (провод), соединяющая штырёк одного узла с розеткой другого. Цвет линии соответствует типу отношения (совпадает с цветом соединителя).
Правило 14: направленность. Линия имеет стрелку на принимающем конце (от штырька к розетке). Двунаправленное отношение — две параллельные линии с двумя стрелками в противоположных направлениях.
Правило 15: толщина. Толщина линии может отражать интенсивность отношения (частоту передачи дейтаграмм). Тонкая линия — редкие события. Толстая — высокочастотный поток. Если информация об интенсивности недоступна — все линии одинаковой толщины.
Правило 16: режим доставки. Отношение с подтверждением (reliable) — сплошная линия. Отношение без подтверждения (unreliable) — пунктирная линия.
2. 7. Визуализация уровней DOM
Правило 17: горизонтальные слои. Уровни DOM визуализируются как горизонтальные слои, расположенные снизу вверх. Нижний слой — физический, верхний — аксиологический.
Слой |
Уровни |
Цвет фона |
Содержание |
Нижний |
Светло-зелёный |
SERN, физические карты |
|
Средний |
Светло-синий |
Символьные карты, язык, нарративы |
|
Верхний |
Светло-золотой |
Аксиологические карты, Понятия, воля |
|
Правило 18: виртуальные уровни. Социальные (виртуальные) уровни (MAP4, MAP5, MAP9, MAPC, MAPD) визуализируются пунктирной границей — они не имеют единственного физического носителя и собственных OPN/TRL.
Правило 19: вертикальные связи. Связи между уровнями (CNN1/CNN2/CNN3 — свёртка вверх, компиляция — вниз) визуализируются вертикальными стрелками. Свёртка (inference) — стрелка вверх. Компиляция — стрелка вниз. Обучение — двусторонняя стрелка внутри целевого уровня.
2. 8. Визуализация TRL
Правило 20: лента. TRL визуализируется как горизонтальная лента, на которой слева направо размещаются записи. Левый конец — прошлое, правый — будущее. Текущая позиция OPN отмечается вертикальным маркером.
Правило 21: состояния записей. Записи TRL визуализируются по-разному в зависимости от состояния:
Состояние |
Контур |
Заливка |
Рамка |
Запланированные |
Пунктирный |
Без заливки |
— |
Строящиеся |
Сплошной |
Частичная заливка (штриховка) |
— |
Завершённые (+) |
Сплошной |
Полная заливка |
Зелёная рамка |
Завершённые (0) |
Сплошной |
Полная заливка |
Серая рамка |
Завершённые (−) |
Сплошной |
Полная заливка |
Красная рамка |
2. 9. Визуализация векторов
Правило 22: стрелка. Векторы (b, P, W) визуализируются как стрелки. Цвет стрелки соответствует типу вектора. Толщина пропорциональна модулю (расстоянию).
Вектор |
Цвет |
Линия |
Красный |
Сплошная |
|
Тёмно-синий |
Сплошная |
|
Тёмно-красный |
Сплошная |
|
Правило 23: общий и частный вектор. Общий вектор (направление без модуля) — пунктирная стрелка без указания длины. Частный вектор (с координатами и модулем) — сплошная стрелка, длина пропорциональна модулю.
2. 10. Визуализация маршрутизации
Правило 24: уровни G1/G2/G3. Три уровня маршрутизации визуализируются различной обводкой линии отношения:
Уровень |
Обводка |
Обоснование |
G1 (внутри GATE) |
Тонкая сплошная |
Локальная связь, быстрая |
G2 (локальная сеть) |
Средняя сплошная |
Ethernet, средняя латентность |
G3 (глобальная сеть) |
Толстая сплошная или двойная |
IPv6, высокая латентность |
Правило 25: GATE. Устройство GATE визуализируется как прямоугольник с толстой рамкой, содержащий множество NDDI (многогранников). Имя GATN отображается в заголовке прямоугольника.
2. 11. Нумерация документов
Правило 26: префикс SPC. Документы проекта Гативус имеют префикс SPC (SPeCification) и код подсистемы:
Префикс |
Подсистема |
Описание |
SPC-GTOM |
Теория сознания |
Книга 1 |
SPC-MOGE |
Морфогенез |
Книга 2 |
SPC-GNET |
Спецификация сети |
Книга 3 |
SPC-GATE |
Спецификация платформы |
Книга 4 |
SPC-GNOT |
Нотация и визуализация |
Настоящая глава |
Правило 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: обязательные элементы диаграммы группы. Диаграмма функциональной группы содержит: NDDI с G-компонентом (ANOD), дочерние NDDI, отношения между ними, границу группы (штрихпунктирная линия), межгрупповые отношения (если есть).
Правило 32: масштаб. При визуализации системы из множества NDDI допускается упрощение: NDDI отображается как точка (без граней), отношения — как линии между точками. Формы и цвета соединителей при этом не показываются. Этот режим используется для обзорных диаграмм больших сетей.
2. 13. Выводы
GNOT определяет 32 правила именования, визуализации и документирования. Правила обеспечивают:
Единообразие: любой элемент архитектуры Гативус однозначно идентифицируется по форме, цвету и четырёхсимвольному имени.
Строгую типизацию: форма соединителя гарантирует визуальную несовместимость разнотипных отношений.
Масштабируемость: от детальной диаграммы одного NDDI до обзорной диаграммы сети из миллионов узлов.
Совместимость: нотация применяется одинаково в GTOM (теория), GNET (сеть) и GATE (платформа).
Соблюдение GNOT обязательно для всех документов проекта Гативус.
Содержание