> Перевод даётся для удобства чтения. Нормативным является английский оригинал. # Примеры именования **Спецификация Мета-Вселенной** **Идентификатор документа:** MU-V2-REFARCH-008 **Название:** Примеры именования **Класс документа:** информативный **Версия:** 2.0 (черновик) **Статус:** рабочий черновик **Нормативные ссылки:** MMAS (соглашения об именовании) **Информативные ссылки:** Reference Repository, Anti-Patterns **Копирайт:** © Orkestron.AI **Лицензия:** Apache-2.0 --- # 1. Назначение Этот документ даёт показательные примеры именования для репозиториев, мета-моделей и семантических артефактов, соответствующих Мета-Вселенной. Он дополняет нормативную спецификацию соглашений об именовании, показывая рекомендуемые практики на конкретных примерах. --- # 2. Принципы проектирования Именам СЛЕДУЕТ быть: - ясными; - стабильными; - читаемыми человеком; - читаемыми ИИ; - независимыми от технологии; - семантически осмысленными. Именам СЛЕДУЕТ описывать понятия, а не реализации. --- # 3. Имена репозиториев Рекомендуется: - employee-meta-model - product-meta-model - software-meta-model - organization-meta-model - healthcare-meta-model Избегать: - model-v2-final - temp-repository - test123 - new-model --- # 4. Имена папок Рекомендуется: - 00-foundation - 01-constitution - 02-architecture - 03-federation - 04-core-concepts - 05-reference-architecture - 06-domain-models - 07-guides - examples Избегать: - misc - docs2 - stuff - temp --- # 5. Имена документов Рекомендуется: - Employee.md - Organization.md - Projection.md - Semantic-Mapping.md - Federation-Contracts.md Избегать: - employee_final_v3.md - new_file.md - draft2.md Нормативным именам файлов СЛЕДУЕТ оставаться стабильными от выпуска к выпуску. --- # 6. Примеры пространств имён Рекомендуется: - employee - organization - finance - healthcare - ai-agent - software Квалифицированные примеры: - employee:Employee - employee:Skill - organization:Department - product:Product - software:Service --- # 7. Примеры объектов Рекомендуемые имена объектов: - Employee - Department - Product - Customer - Invoice - Contract - Service - AIAgent Именам объектов СЛЕДУЕТ представлять деловые понятия. --- # 8. Примеры связей Рекомендуется: - reportsTo - memberOf - owns - assignedTo - dependsOn - implements - supervises - belongsTo Именам связей СЛЕДУЕТ выражать семантический смысл. --- # 9. Примеры событий Рекомендуется: - EmployeeCreated - ContractApproved - ProjectionPublished - IdentityBound - FederationEstablished - SynchronizationCompleted Событиям СЛЕДУЕТ описывать свершившиеся происшествия. --- # 10. Примеры проекций Рекомендуемые имена проекций: - EmployeePublicProjection - EmployeeHRProjection - EmployeePayrollProjection - ProductCatalogProjection - IncidentSummaryProjection Именам проекций СЛЕДУЕТ указывать на контекст. --- # 11. Примеры контрактов Рекомендуется: - EmployeeDisclosureContract - HRFederationContract - ProductExchangeContract - AIAgentCapabilityContract Именам контрактов СЛЕДУЕТ указывать на цель. --- # 12. Примеры идентичностей Каноническая идентичность: employee:550e8400-e29b-41d4-a716-446655440000 Локальная идентичность: HR-10245 Привязка: employee:550e8400... ↔ HR-10245 Канонической идентичности СЛЕДУЕТ оставаться глобально стабильной. --- # 13. Примеры версий Рекомендуется: - 1.0.0 - 1.2.1 - 2.0.0 Избегать: - final - latest - vNext СЛЕДУЕТ пользоваться семантическим версионированием. --- # 14. Полный пример именования Репозиторий: employee-meta-model Пространство имён: employee Объект: Employee Связь: reportsTo Проекция: EmployeeHRProjection Контракт: EmployeeDisclosureContract Событие: EmployeePromoted Эта цепочка имён показывает последовательное семантическое именование сквозь все архитектурные слои. --- # 15. Архитектурный чеклист Перед публикацией: - Стабильно ли имя? - Независимо ли оно от технологии? - Осмысленно ли оно семантически? - Понятно ли оно без знания реализации? - Согласуется ли оно с соглашениями об именовании MMAS? --- # 16. К семантическому руководству по стилю Примеры этого документа касаются *именования*, но именование - лишь одна грань стилистической слаженности. Подобно тому как *Google Java Style Guide* распоряжается далеко не одними именами идентификаторов - он охватывает раскладку, комментарии, идиомы и единообразие формулировок, чтобы тысячи инженеров писали код, читающийся как написанный одним автором, - Мета-Вселенной пригодится единое **семантическое руководство по стилю**, распоряжающееся тем, как семантические модели *пишутся*, а не только тем, как они названы. Семантическое руководство по стилю стандартизовало бы в одном месте: - **Правила именования** - соглашения, показанные по всему этому документу (репозитории, пространства имён, объекты, связи, события, проекции, контракты, идентичности, версии). - **Правила описания сущностей** - как описывается объект, связь или событие, в каком порядке и с какой степенью подробности. - **Единообразие формулировок** - согласованный голос и строй фразы для определений, чтобы описания читались одинаково в тысячах независимо написанных моделей. - **Соглашения о связях и событиях** - глагольные формы для связей (`reportsTo`, `dependsOn`) и формы совершённого прошедшего для событий (`EmployeePromoted`, `ContractApproved`). - **Стиль заключения** - единая форма завершающего заявления для каждого документа. - **Единообразные разделы назначения, области применения и принципов** - общая начальная структура, чтобы каждый документ представлял своё назначение, охват и принципы проектирования одинаково узнаваемо. - **Рекомендации по доменным мета-моделям** - фирменный стиль сборки полной доменной модели из этих частей. Цель здесь - *единообразие, пригодное для машинного слияния*: когда тысячи организаций публикуют семантические модели в одном последовательном стиле, ИИ-агенты понимают, разбирают, сравнивают и сливают их куда надёжнее, чем если бы каждый издатель выдумывал собственные формулировки. Стилистическая слаженность - не косметика: для экосистемы, родной для ИИ, это предпосылка автоматического рассуждения по многим моделям сразу. --- # Направления развития Ожидается, что описанное выше **семантическое руководство по стилю** вырастет в самостоятельного информативного спутника нормативных соглашений об именовании - аналог языкового руководства по стилю для Мета-Вселенной, охватывающий именование, описание, формулировки, соглашения о связях и событиях, структуру документа и форму заключения. Мерило его успеха просто: две любые организации, следующие ему, произвели бы модели, которые ИИ-агент прочтёт, разберёт и сольёт так, будто они вышли из-под одного пера. --- # Заключение Единообразное именование существенно для долгосрочной семантической совместимости. Прилагая стабильные, осмысленные и независимые от технологии имена, реализации Мета-Вселенной становится легче понимать, проверять, объединять в федерации и развивать - и людям, и ИИ-агентам, - при сохранении семантической ясности во всех репозиториях и предметных областях.