ShariX Open Docs

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
<sharix-knowledge-meta>
{
    "id": "ShariXKnowledgeClassification",
    "page": "sharixopen:knowledge:classification:start",
    "area": "open",
    "type": "reference",
    "title": "Рубрикатор базы знаний",
    "status": "review",
    "schema_version": 1,
    "relations": {
        "related_to": [
            "ShariXKnowledgeClassificationAudiences",
            "ShariXKnowledgeClassificationProducts",
            "ShariXKnowledgeClassificationMaterials",
            "ShariXKnowledgeClassificationTopics",
            "ShariXKnowledgeClassificationMaintenance"
        ]
    },
    "extensions": {
        "taxonomy": {
            "domain": "standards",
            "lifecycle": "not_applicable",
            "component": "ShariX Knowledge documentation",
            "parents": [
                "ShariXKnowledgeHub"
            ],
            "terms": [
                "product_sharix_open",
                "audience_developer",
                "audience_integrator",
                "audience_reviewer",
                "audience_ai",
                "material_index",
                "topic_knowledge_navigation"
            ]
        },
        "glossary": [],
        "classification": {
            "schema": "sharix.knowledge.classification.v1",
            "products": [
                "sharix_open"
            ],
            "audiences": [
                "developer",
                "integrator",
                "reviewer",
                "ai"
            ],
            "material": "index",
            "topics": [
                "knowledge/navigation"
            ],
            "tag_terms": [
                "product_sharix_open",
                "audience_developer",
                "audience_integrator",
                "audience_reviewer",
                "audience_ai",
                "material_index",
                "topic_knowledge_navigation"
            ]
        },
        "classification_review": {
            "date": "2026-10-31",
            "scope": "Реестр используемых терминов и навигационные указатели; роли не выдают ACL."
        }
    },
    "content_sha256": "bbe2ccd2b344496bbc41baecc8ccfb5d1edc7cb17bcfffb3f0594a9eae411a4d",
    "schema": 1
}
</sharix-knowledge-meta>
====== Рубрикатор базы знаний ======
~~NOCACHE~~

**Навигация:** [[sharixopen:knowledge:start|База знаний]] → Рубрикатор.

Рубрикатор позволяет выбрать материал по нескольким независимым признакам. Одна статья может быть одновременно контрактом API, материалом для интегратора и частью темы заказов. Это не повод помещать её в несколько конкурирующих копий.

===== Четыре измерения =====
  * [[sharixopen:knowledge:classification:products|Продукт и применимость]] — про какой продукт или общий компонент написано.
  * [[sharixopen:knowledge:classification:audiences|Аудитория]] — кому материал помогает в работе.
  * [[sharixopen:knowledge:classification:materials|Назначение материала]] — правила, архитектура, контракт, руководство, проверка, сценарий или указатель.
  * [[sharixopen:knowledge:classification:topics|Темы и термины]] — предметная область с путями вида orders/lifecycle.

===== Поддержка рубрикатора =====

[[sharixopen:knowledge:classification:maintenance|Как поддерживать классификацию и рубрикатор]] — обязательный порядок для человека и нейросети: выбор признаков, добавление определений, обновление указателей и проверка публикации.

===== Как устроены связи =====
  * taxonomy.parents задаёт существующий родительский раздел и ребро contains.
  * depends_on обозначает содержательную зависимость, applies_to — область применения, verified_by — документ критериев проверки. Наличие verified_by не означает, что проверки уже запущены.
  * taxonomy.terms содержит идентификаторы определённых меток и понятий. extensions.glossary определяет их; граф создаёт uses_term и defines_term.
  * extensions.classification хранит те же признаки раздельно: products, audiences, material и иерархические paths тем. Это структура для API, а не набор исполняемых инструкций.

Основная иерархия остаётся «раздел → документ». Дополнительные метки связывают документы поперёк разделов. Вложенность темы записывается путём: например, orders/payments означает «Заказы → Финализация оплаты»; её значение раскрыто в словаре темы.

===== Почему раньше было reference · unspecified =====
Каталог этой версии показывает domain и lifecycle, а не полный набор признаков статьи. Ранее domain часто оставался общим reference, а lifecycle — unspecified. Это скрывало различия между правилами, архитектурой и описанием кода.

Теперь:

  * type уточняется по допустимым типам API: policy, architecture, contract, component, procedure, requirement, verification, reference и decision;
  * semantic material в классификации различает, например, указатель, концепцию, подход к разработке и практическое руководство;
  * implemented означает, что описывается существующая реализация исходного кода. Оно не обещает отсутствия ошибок и не подтверждает установленный сервер;
  * not_applicable означает, что стадия реализации функции неприменима: это правило, концепция, словарь, требования или указатель;
  * status остаётся редакционным состоянием текста. Исправление рубрики не делает review автоматически approved.

Reference сохраняется для настоящих указателей, словарей и концептуальных справок: API не имеет отдельного native type для каждого такого подтипа. Их назначение уточняет материал и тема. Учебный курс или упражнение сюда не переносится; они относятся к Moodle.

===== Как пользоваться =====
  - Начать с нужного раздела либо одного из четырёх указателей выше.
  - Выбрать аудиторию, назначение или тему и открыть связанную статью.
  - В графе по умолчанию читать иерархию разделов. Для смысловых связей включить нужный тип отношения.
  - В режиме «Все документы» включить «Использует термин», чтобы видеть общие метки; при большой карте сначала сузить разделы. В текущем viewer более 160 одновременно выбранных узлов не рисуются, текстовый каталог остаётся доступен.
  - Для точного машинного выбора читать classification и исходные связи через Wiki API. Отдельных полей-фильтров аудитории и продукта в текущем viewer нет; обычные указатели и API-классификация доступны сейчас.

Метки аудитории и продукта не выдают права. Публичная Wiki содержит ShariX Open и разрешённые границы общих компонентов; внутренние детали Platform и закрытых модулей находятся в intrawiki.

~~SHARIX_KNOWLEDGE_GRAPH~~

~~SHARIX_KNOWLEDGE_CATALOG~~

~~SHARIX_KNOWLEDGE_RELATED~~