Модель документа и видимая функция¶

Навигация отвечает на вопрос «к какой системе относится знание?». Metadata отвечает на вопросы «что это за документ, насколько он обязателен, кому виден и кто за него отвечает?». Поэтому функция документа не должна определять верхний уровень меню.

Два независимых измерения¶

Принадлежность: system, domain, layer и связи с объектами.

Функция: philosophy, principle, guide, explanation, standard, policy, reference, register, decision record или иной допустимый тип.

Философский текст может находиться внутри Governance; standard — внутри U.L.I.; guide — внутри Product–Market. Пользователь сначала выбирает предмет, а затем видит функцию.

Документ и описываемый объект¶

Жизненный цикл документа и состояние описываемой сущности также независимы. Действующий документ может описывать гипотезу, прототип или approved target. Для этого используется многомерная модель статуса объекта.

Видимая карточка документа¶

На странице должны отображаться как минимум:

функция;
canonicality;
status и version;
visibility;
owner role;
дата обновления или следующего review;
принадлежность к system / domain.
при наличии object_state: архитектурный, реализационный, доказательный и visibility-статусы объекта.

Это представление генерируется из front matter и не требует дублировать служебные поля вручную в тексте.

Каноничность¶

canonical — обязательный источник определения или правила;
working — используемая рабочая модель, открытая для изменения;
reference — справочный материал или проекция другого источника;
historical — сохранённый контекст, не выражающий текущую позицию.

status: active не означает автоматически canonicality: canonical.

Межкорпусные document relations¶

links.document_links может связывать Knowledge Substrate document не только с другим schema: ecosystem document, но и с устойчивым first-party объектом другого owning corpus.

В таком relation:

schema определяет namespace / resolver объекта;
link_type выражает смысл связи;
linked_document_id хранит stable identity, а не locale URL.

Для опубликованного Site post используется:

schema: site-publication
linked_document_id: site:<detai|personal>:id:<postId>

Эта identity разрешается через owning Site blog index. Она не делает публикацию частью Knowledge Substrate и не требует копировать её Markdown сюда.

Автоматическая projection publication-originated relations описана в «Связи публикаций с Knowledge Substrate».

Обязательное поведение при изменении¶

Если меняются статус, версия, связи, владелец или следующий шаг, обновляются front matter и связанные реестры. Если документ заменяет прежний, связь supersedes / superseded-by должна быть явной.