Спроектировать структуру знаний

Четыре вещи, которые часто смешивают§

Один документ может содержать несколько правил и фактов. Одно правило может опираться на несколько источников. Различение этих объектов помогает обновлять знания без потери связи с основаниями.

Название не равно идентичности§

«К-2», «K2» и «контроллер второй серии» могут обозначать одну модель или разные объекты. Для базы нужен способ установить, о чём идёт речь. Назначьте устойчивый идентификатор, сохраните допустимые названия и опишите, какие признаки разрешают объединить две записи.

Категория «Контроллер» и конкретное устройство K2-104 находятся на разных уровнях модели. Класс объединяет объекты с выбранными свойствами, экземпляр обозначает конкретный объект. Не переносите свойство одного экземпляра на все устройства этого класса.

У связи есть смысл§

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

Учебный пример. «Процедура P-17 относится к К-2» слишком неопределённо. «Процедура P-17 применима к модели К-2 при прошивке 4.0» задаёт проверяемое отношение и условие. Для прошивки 4.1 эта запись не даёт автоматического разрешения.

Постройте модель от вопросов§

• Возьмите вопросы паспорта. Выпишите встречающиеся объекты и действия.
• Сведите синонимы, сохранив исходные названия; отдельно отметьте совпадения, которые ещё не подтверждены.
• Для каждого понятия напишите короткое определение, пример и пограничный случай.
• Назовите отношения глаголами: «имеет версию», «применяется при», «заменяет», «утверждён кем». Определите их направление и условия.
• Создайте несколько экземпляров, в том числе исключение и неоднозначный случай. Попробуйте ответить на исходные вопросы.

Минимальная карточка знания§

Это учебный пример, а не готовая инструкция по ремонту. Состав полей определяется вашим сценарием. Например, доступ и период действия могут быть отдельными обязательными полями, а фактический владелец — ссылкой на роль или участника в принятом справочнике.

id: procedure-p17
type: procedure
title: Проверка соединения К-2
status: approved
applies_to:
  equipment_model: model-k2
  firmware: '4.0'
source:
  document_id: manual-k2
  revision: '2'
  section: '3.2'
owner_role: procedure-owner
review_trigger: Изменение инструкции или области применения

Статьи тоже требуют структуры§

Для читателя полезно различать пошаговую инструкцию, справку, обучение и объяснение. Внутри статьи с процедурой сохраняйте цель, условия начала, шаги, исключения и способ проверить результат. Объяснение причин можно связать отдельной ссылкой, чтобы оно не мешало выполнению шагов.

Шаблон не должен заставлять автора заполнять выдуманные поля. Если значение неизвестно, укажите это явно и определите, можно ли использовать запись в таком состоянии. Пустое поле, «не применимо» и «не известно» могут иметь разный смысл.

Модель и технология хранения§

Наличие отношений в предметной области само по себе не требует графовой СУБД. Сравнивайте варианты на запросах и операциях обновления. Важно также, кто сможет поддерживать модель после внедрения.

Примите правила идентичности§

Определите, когда две записи обозначают один объект, когда одна заменяет другую и когда похожие названия должны оставаться раздельными. Слияние должно сохранять прежние ссылки или явную историю соответствий. Ошибочное объединение моделей оборудования способно сделать корректное правило неприменимым к найденному объекту.

Для меняющихся сведений различайте время действия факта и время записи в системе. Восстановление ответа «что было известно на дату решения?» может потребовать обоих измерений. Если такая задача не нужна, не вводите сложную временную модель заранее.

Схема — проверяемый контракт§

Задайте обязательные поля, типы значений, допустимые связи и ограничения. Например, опубликованная процедура должна иметь основание и область действия, а заменённая версия — ссылку на преемника либо понятное объяснение снятия. Проверка структуры не устанавливает истинность содержания, но ловит часть дефектов раньше использования.

Изменение схемы проверьте на существующих записях: какие станут недопустимыми, кто заполнит новые поля, как обновятся индексы и шаблоны? Запишите правило миграции и способ отката. Для RDF можно изучить SHACL; для других представлений используйте подходящие средства проверки.