Предметная архитектура навигации Knowledge Substrate¶

Решение¶

Knowledge Substrate организуется для навигации человека и агента по предметным системам, доменам ответственности и связям, а не по функциям Markdown-файлов.

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

Почему прежняя навигация потребовала миграции¶

Прежнее меню помещало почти всю русскую базу внутрь одной вкладки Ecosystem, а в Management Layer и U.L.I. повторяло разделение Philosophy / Architecture & Logic / Technical Standards.

Такая модель полезна автору файла, но создаёт четыре проблемы для читателя:

предмет одной системы разрывается между категориями документов;
тип файла начинает выглядеть важнее самой системы;
менеджер, технический лидер или исследователь не видит собственного маршрута;
нормативная сила документа остаётся спрятанной во front matter.

Две независимые координаты¶

Новая архитектура разделяет:

Координата	Вопрос	Где видна
Предметная принадлежность	О какой системе или домене этот документ?	меню, URL, breadcrumbs, карта знаний
Функция и сила документа	Что это за документ и как его использовать?	карточка метаданных, badges, поиск и фильтры

Функция документа больше не должна определять его верхнеуровневое положение в меню.

Текущие верхнеуровневые разделы прототипа¶

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

Начать — главная, путеводитель, карта знаний и маршруты по ролям.
DETai как целое — канон, онтология, сквозные системы и источники истины.
Управление и участие — смысловые основания, Governance, Management Layer, Operating Model, команда и коммуникации.
Onboarding — сквозной маршрут от раннего доступа и tutorials к осмысленному участию; участническое прохождение отделено от management-контура владельцев.
DET и институциональная жизнь — метод, психотерапия, образование и исследование; внутренняя теория синхронизируется отдельным процессом части II.
Технологический слой — Platform DETai как доставка и U.L.I. как Human–AI Development Environment создания.
Продукты и рынок — ценность, продуктовый портфель и Product–Market cycle.
Компания, безопасность и доказательства — Legal–Economic, Trust и Evidence как самостоятельные системы внутри одного читательского контейнера.
Infrastructure — сквозная среда вычисления, хранения, связности и исполнения для всей экосистемы.
Tools — единый горизонтальный маршрут к рабочим инструментам независимо от использующего их домена.
Система знаний — архитектура, публикация, доставка и агентная доступность знания.

Языковые входы остаются отдельными пунктами до проектирования общего language navigation. Верхнеуровневое размещение Infrastructure и Tools делает их сквозную функцию видимой, но не превращает их в центры власти: эксплуатационная ответственность за конкретный узел или инструмент остаётся у соответствующего owning domain.

Ролевые представления¶

Ролевой маршрут — это curated view существующих документов, а не новая копия знаний.

Минимальные представления:

новый участник;
основатель / Anchor;
менеджер или владелец домена;
технический лидер / разработчик U.L.I.;
продуктовая роль;
психотерапевт / супервизор;
преподаватель;
исследователь / методолог;
Trust & Safety / data role.

Каждая ролевая страница отвечает:

за что отвечает роль;
какие решения может принимать;
какие документы обязательны к чтению;
где находится текущая работа;
куда эскалировать вопрос.

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

Front matter остаётся машинным источником, но его значимая часть выводится в начале страницы в человекочитаемом виде.

Минимальный набор:

Поле	Видимое значение
`classification.system`	предметная система
`classification.domain`	домен ответственности
`classification.function`	explanation, standard, policy и т. п.
`descriptive.status`	draft, active, archived
`descriptive.version`	действующая версия
`descriptive.date_update`	последнее содержательное обновление
`governance.canonicality`	canonical, policy, standard, guide, working, historical
`governance.visibility`	public, team, restricted, secret
`governance.owner_role`	владелец содержания
`governance.approver_role`	кто утверждает
`governance.review_date`	дата обязательного пересмотра

Дополнительно могут показываться аудитории и реализуемые downstream-системы.

Правила отображения¶

цвет не является единственным носителем смысла: badge всегда содержит текст;
draft и historical визуально отличаются от действующего канона;
публичная страница не выводит названия закрытых систем, если это раскрывает чувствительную структуру;
отсутствующее поле не заменяется выдуманным значением;
метаданные выводятся одинаково на desktop и mobile;
карточка не дублирует весь YAML.

Целевая URL-модель¶

Новые адреса строятся по предметной принадлежности:

/ru/start/
/ru/architecture/
/ru/method/
/ru/technology/platform/
/ru/technology/uli/
/ru/governance/
/ru/operating-model/
/ru/product-market/
/ru/trust/
/ru/evidence/
/ru/infrastructure/
/ru/onboarding/

Числовые префиксы допустимы внутри файловой системы для порядка, но не должны становиться главным языком публичного URL.

Различие миграции сайта и docs¶

Основной сайт ещё не выходил в публичность, поэтому перенос его U.L.I.-маршрута выполняется напрямую без редиректа.

Knowledge Substrate уже опубликован на GitHub Pages и имеет внешние ссылки. Поэтому изменение URL требует:

реестра old_url → new_url;
проверки входящих ссылок внутри репозитория;
сохранения старых переходов или совместимого слоя публикации;
обновления front matter external_links;
проверки search index, sitemap и языковых входов.

Этапы внедрения¶

Этап 1. Семантика и metadata contract — концептуально выполнен¶

утвердить верхнеуровневые системы;
расширить metadata policy;
определить поля карточки;
создать карту документов и владельцев;
подготовить role views.

Системы, целевой metadata contract, карта знаний и стартовые role routes созданы. Полная миграция metadata старого корпуса продолжается только через содержательный review.

Этап 2. Навигация без физического переноса — на визуальном review¶

перестроить mkdocs.yml вокруг предметных систем;
добавить входные карты;
вывести карточку метаданных;
проверить читаемость и поиск.

mkdocs.yml и входные страницы перестроены. Технически остаётся вывести карточку metadata и проверить прототип в браузере на desktop и mobile.

Этап 3. Семантические URL — отложен до сравнения архитектур¶

утвердить route map;
перенести файлы пакетами;
сохранить переходы со старых публичных адресов;
обновить ссылки и external metadata;
выполнить полный build и link check.

добавить фильтрацию по system, domain, function, status и audience;
связать документы с ролями и downstream-системами;
сформировать agent-readable knowledge map;
не смешивать документацию с runtime-данными Team OS, CRM и Corporate Vault.

Критерий готовности¶

Архитектура считается внедрённой, когда человек может начать не с угадывания типа файла, а с вопроса о собственной системе или роли, и при открытии любого документа сразу видит его статус, функцию, владельца, версию и границы применения.