> Перевод даётся для удобства чтения. Нормативным является английский оригинал. # Эталонные диаграммы **Спецификация Мета-Вселенной** **Идентификатор документа:** MU-V2-REFARCH-009 **Название:** Канонические диаграммы **Класс документа:** информативный **Версия:** 2.0 (черновик) **Статус:** рабочий черновик **Нормативные ссылки:** Конституция Мета-Вселенной (MUC), MMAS, MUFP **Информативные ссылки:** Architecture, Meta-Universe Stack, Interaction Patterns, Federation Patterns **Копирайт:** © Orkestron.AI **Лицензия:** Apache-2.0 --- # 1. Назначение Этот документ определяет канонические эталонные диаграммы, рекомендуемые для спецификаций, соответствующих Мета-Вселенной. Эталонные диаграммы дают стандартизованные визуальные представления архитектурных понятий. Они повышают единообразие между репозиториями и позволяют как людям, так и системам ИИ предсказуемо истолковывать архитектурный замысел. --- # 2. Принципы проектирования Эталонным диаграммам СЛЕДУЕТ быть: - семантически точными; - независимыми от технологии; - простыми; - переиспользуемыми; - учитывающими версии; - прослеживаемыми. Диаграммы ОБЯЗАНЫ показывать семантическую архитектуру, а не детали реализации. --- # 3. Канонический набор диаграмм Полной спецификации Мета-Вселенной СЛЕДУЕТ включать диаграммы для: - Общей архитектуры - Стека Мета-Вселенной - Базовых понятий - Обзора федерации - Привязки идентичностей - Модели проекций - Потока событий - Жизненного цикла - Паттернов взаимодействия - Паттернов федерации - Доменной мета-модели (когда применимо) --- # 4. Диаграмма архитектуры Назначение Показывает отношение между: - Основаниями - Архитектурными стандартами - Федерацией - Базовыми понятиями - Доменными мета-моделями - Реализациями Рекомендуемая раскладка: Основания ↓ Архитектура ↓ Федерация ↓ Базовые понятия ↓ Доменные мета-модели ↓ Реализации --- # 5. Диаграмма стека Показывает архитектурные слои и направление зависимостей. Зависимости ОБЯЗАНЫ всегда указывать в сторону нижних слоёв. Реализации ↓ Профили федерации ↓ Доменные мета-модели ↓ Базовые понятия ↓ Федерация ↓ Архитектура ↓ Основания --- # 6. Диаграмма федерации Показывает сотрудничество между суверенными Вселенными. Рекомендуемые элементы: - Вселенная A - Вселенная B - Доверие - Контракт федерации - Привязка идентичностей - Семантическое отображение - Обмен проекциями - События Владение ОБЯЗАНО оставаться внутри каждой Вселенной. --- # 7. Диаграмма проекций Рекомендуемая структура: Мета-объект │ ├── Публичная проекция ├── Внутренняя проекция ├── Проекция для ИИ └── Партнёрская проекция Каждая проекция ОБЯЗАНА ссылаться на одну и ту же каноническую идентичность. --- # 8. Диаграмма привязки идентичностей Показывает каноническую идентичность, связанную с несколькими локальными. Каноническая идентичность │ ┌──────┼──────┐ │ │ │ Локальная A Локальная B Локальная C Привязки ОБЯЗАНЫ сохранять семантическую власть. --- # 9. Диаграмма потока событий Показывает неизменяемое семантическое развитие. Мета-объект │ Событие создания │ Событие обновления │ Событие утверждения │ Событие архивирования Состояние ОБЯЗАНО быть объяснимым через события. --- # 10. Диаграмма жизненного цикла Рекомендуемый жизненный цикл: Создан ↓ Черновик ↓ Предложен ↓ Действует ↓ Устарел ↓ В архиве ↓ Выведен из обращения Необязательные состояния МОГУТ вставляться, не меняя семантики жизненного цикла. --- # 11. Диаграмма взаимодействия Показывает каноническое взаимодействие: Обнаружение ↓ Доверие ↓ Контракт ↓ Проекция ↓ Обработка ↓ События ↓ Синхронизация --- # 12. Диаграмма доменной мета-модели Доменным диаграммам СЛЕДУЕТ включать: - пространства имён; - объекты; - связи; - события; - контракты; - проекции. Детали реализации СЛЕДУЕТ опускать. --- # 13. Соглашения о диаграммах Рекомендуемые соглашения: - Прямоугольники для семантических артефактов. - Прямоугольники со скруглёнными углами для процессов. - Сплошные стрелки для семантических связей. - Пунктирные стрелки для ссылок. - Двойные рамки для полномочных элементов. Визуальному стилю СЛЕДУЕТ оставаться единообразным по всему репозиторию. --- # 14. Валидация Эталонные диаграммы СЛЕДУЕТ рецензировать на предмет: - семантической правильности; - согласия с нормативными документами; - единообразия терминологии; - архитектурной полноты; - совместимости версий. Диаграммы ОБЯЗАНЫ дополнять текстовые спецификации. --- # 15. Архитектурные инварианты Эталонные диаграммы ОБЯЗАНЫ: - сохранять конституционные принципы; - сохранять семантическую власть; - оставаться независимыми от реализации; - избегать нотации, привязанной к технологии, если она не требуется явно. --- # 16. Язык диаграмм Мета-Вселенной (MUDL) Полная спецификация MUDL лежит в документе [MUDL](MUDL.md), а канонические диаграммы, отрисованные исходниками Mermaid, - в [`assets/`](../assets/). Приведённые выше диаграммы стандартизуют *смысл* картинок Мета-Вселенной, но пока не их *машиночитаемую форму*: сегодня замысел диаграммы каноничен, а её отрисовка делается вручную. **Язык диаграмм Мета-Вселенной (MUDL)** закрывает этот разрыв, стандартизуя машиночитаемое представление диаграмм, так что диаграмма становится просто ещё одной проекцией мета-модели, а не отдельным, поддерживаемым вручную артефактом. MUDL определяет: - **Типы узлов** - семантические элементы, которые может содержать диаграмма: - Universe - Namespace - Object - Projection - Contract - Event - **Типы рёбер** - семантические связи между узлами: - `owns` - `projects` - `binds` - `governs` - `mapsTo` - `synchronizes` - `federatesWith` - **Визуальную нотацию** - канонические фигуры, рамки и стили стрелок (согласованные с соглашениями о диаграммах из раздела 13), в которые отрисовывается каждый тип узла и ребра. - **Сериализацию** - кодирование в YAML/JSON, чтобы диаграмму можно было писать, версионировать, проверять и сравнивать как структурированные данные. - **Генерацию** - детерминированную отрисовку этой сериализации в SVG, Mermaid или PlantUML, чтобы один и тот же источник давал одну и ту же картинку в разных инструментах. Минимальный пример MUDL: ```yaml mudl: 1.0 nodes: - id: u_acme type: Universe label: "Acme Corp" - id: emp_employee type: Object label: "Employee" - id: emp_public type: Projection label: "EmployeePublicProjection" edges: - from: u_acme to: emp_employee type: owns - from: emp_employee to: emp_public type: projects ``` Поскольку документ MUDL порождается из лежащей в основе модели и проверяется по ней, диаграмма оказывается настоящей проекцией: она не может отклониться от семантики, которую изображает. MUDL играет для Мета-Вселенной роль, схожую с BPMN для процессов, UML для программ или ArchiMate для архитектуры предприятия, - это отдельный стандартизованный визуальный язык, но такой, чьим источником истины служит сама семантическая мета-модель. --- # Направления развития Ожидается, что **MUDL** дозреет до самостоятельной информативной спецификации, охватывающей полный словарь узлов и рёбер, каноническую визуальную нотацию, схему YAML/JSON и соответствующие генераторы в SVG, Mermaid и PlantUML. Его определяющее свойство в том, что диаграмма становится ещё одной проекцией мета-модели - написанной как данные, проверенной на соответствие и отрисованной детерминированно, - так что визуальная документация в тысячах репозиториев остаётся единообразной и всегда идёт в ногу с моделями, которые иллюстрирует. --- # Заключение Эталонные диаграммы дают Мета-Вселенной общий визуальный язык. Стандартизуя изображение архитектурных понятий, механизмов федерации и семантических структур, эти диаграммы улучшают понимание, совместимость и долгосрочную поддерживаемость, добиваясь того, чтобы визуальная документация развивалась согласованно с нормативными спецификациями.