Приложение E: Структура базы знаний (BookStack)

Приложение Е к РГ-СМК-Zulip-01.

Раскладка KB в трёх ярусах: содержание (что знаем) → управление (как организуем) → инфраструктура (на чём работает). Полки внутри ярусов — ниже. Это рабочий чертёж для наполнения BookStack.

Три яруса

СОДЕРЖАНИЕ (что знаем)        → 4 контурные полки, книги = блоки БЗ-1…11
УПРАВЛЕНИЕ (как организуем)   → полка «Стандарты и управление знаниями»
                                (стандарт · ведение · зрелость)
ИНФРАСТРУКТУРА (на чём)       → полка «Цифровая инфраструктура»
                                (Zulip · BookStack · Onyx · n8n · GRACE · CRM/ERP)

Разрез повторяет принцип «порядок → инструменты»: содержание и управление тул-независимы; инфраструктура — конкретные системы, реализующие порядок. Сменится инструмент — правится только инфра-книга, мета-полка не дрогнет.

Дерево

KB (BookStack)
│
│ ── СОДЕРЖАНИЕ (книги = блоки знаний БЗ) ──
│
├─ Полка: СМК / ISO 9001
│   ├─ Книга: БЗ-1 Бизнес-процессы и СМК
│   └─ Книга: БЗ-2 Записи качества
│
├─ Полка: Инженерный
│   ├─ Книга: БЗ-3 Продукты и конфигурации     ⇄ Коммерческий
│   └─ Книга: БЗ-4 Нормативная база
│
├─ Полка: Производственный
│   ├─ Книга: БЗ-5 Технологические стандарты
│   └─ Книга: БЗ-6 База дефектов и решений      ⇄ СМК
│
├─ Полка: Коммерческий
│   ├─ Книга: БЗ-7 Клиентская база
│   ├─ Книга: БЗ-8 Конкурентная среда
│   ├─ Книга: БЗ-9 Коммуникации и скрипты
│   ├─ Книга: БЗ-10 Прецеденты проектов         ⇄ все контуры
│   └─ Книга: БЗ-11 История сделок
│
│ ── УПРАВЛЕНИЕ (как организуем) ──
│
├─ Полка: Стандарты и управление знаниями
│   ├─ Книга: Рабочее пространство и знания — стандарт   ◄── НАШ КОМПЛЕКТ
│   │     ├─ Глава: Стандарт
│   │     │     └─ Стр.: РГ-СМК-Zulip-01 — Регламент
│   │     └─ Глава: Приложения
│   │           ├─ Стр.: А — Грамматика тем и индексация Onyx
│   │           ├─ Стр.: Б — Карта каналов (поток создания ценности)
│   │           ├─ Стр.: В — Сущностная модель и жизненный цикл
│   │           ├─ Стр.: Г — Словарь
│   │           ├─ Стр.: Д — Архитектура и связи
│   │           └─ Стр.: Е — Структура базы знаний
│   ├─ Книга: Ведение базы знаний (как работаем в BookStack)
│   └─ Книга: Модель зрелости управления знаниями
│         ├─ Глава: Модель  (инструмент LeanLab, переиспользуемый)
│         │     ├─ Стр.: Шкала уровней 0–5
│         │     ├─ Стр.: Организационная ось (зрелость контура)
│         │     ├─ Стр.: Объектная ось (зрелость блока)
│         │     └─ Стр.: Анкета Э0 (методика замера)
│         └─ Глава: Применение — Этап 0 (АйТек)
│               ├─ Стр.: Карта замера — 11 блоков (до / цель)
│               ├─ Стр.: Оценка контуров (до)
│               └─ Стр.: Уровень → эффект (язык питча)
│
│ ── ИНФРАСТРУКТУРА (на чём работает) ──
│
└─ Полка: Цифровая инфраструктура
    ├─ Книга: Zulip       (развёртывание, боты, интеграции)
    ├─ Книга: BookStack   (настройка, бэкап, вебхуки)
    ├─ Книга: Onyx        (коннекторы, ассистенты, доступы)
    ├─ Книга: n8n         (сценарии)
    ├─ Книга: GRACE       (приложение АйТека, стыковка)
    └─ Книга: CRM / ERP   (внедрение, интеграции)

⇄ — книга стоит на нескольких полках (BookStack это позволяет). Многополочные: БЗ-3 (Инженерный + Коммерческий), БЗ-6 (Производственный + СМК), БЗ-10 (все контуры).

Содержание: книги = блоки знаний

Книги контурных полок — это 11 блоков знаний (БЗ-1…11), а не произвольный набор. Каждый блок — самостоятельный актив; его зрелость измеряется моделью зрелости (см. полку «Управление»). Поэтому на контурную книгу вешаем теги блок: и зрелость: — и карта замера становится живым срезом по структуре, а не отдельной таблицей.

Управление: наш комплект = 1 книга

Рабочее пространство и знания — стандарт — одна книга на полке «Стандарты и управление знаниями»: глава «Стандарт» (регламент) + глава «Приложения» (А–Е). Название — про порядок организации работы и знаний; конкретные системы (Zulip, BookStack, Onyx) — лишь инструменты, поэтому их в названии нет. Реальный охват несут описание и теги система:.

Описание книги (поле description):

Стандарт организации работы, коммуникации и знаний вокруг потока создания ценности и сущностей (контрагент / объект / проект): что является каноном, что — обсуждением, где живут сущности и как это находится. Конкретные системы — лишь элементы, реализующие этот порядок: Zulip (обсуждение и координация), BookStack (канон и база знаний), Onyx (поиск), CRM/ERP (сущности), n8n (склейка событий). Владелец — СМК, ведение — LeanTech. Код: РГ-СМК-Zulip-01.

Рядом на полке — ещё две книги: Ведение базы знаний (как именуем страницы, ведём теги, кто за какую полку отвечает) и Модель зрелости (диагностика «до/после»; глава «Модель» — переиспользуемый инструмент LeanLab, глава «Применение» — замер АйТека).

Словарь (приложение Г) — сквозной для всей KB; пока живёт страницей в книге стандарта. Если лексика станет общекорпоративной — выносим в отдельную книгу Словарь / Справочник на нескольких полках.

Граница «архитектура vs ранбуки»

Чтобы не задвоить: архитектура (приложение Д) — это карта и дизайн связей, она остаётся в книге стандарта («что с чем связано и почему»). Пошаговые ранбуки («как настроить вебхук, где бэкап, какие коннекторы») идут в инфра-книги соответствующих систем. Д — обзор, инфра-книги — глубина под ним; в стандарте — ссылка на них.

Схема тегов (контролируемые ключи)

Теги — сквозная метадата всей KB; ключи закрытые, как и префиксы тем.

Ключ	Значения	Назначение
`раздел:`	смк · инженерный · производство · коммерческий · управление-знаниями · инфраструктура	полка / ярус
`блок:`	бз-1 … бз-11	блок знаний (для контурных книг)
`зрелость:`	0 · 1 · 2 · 3 · 4 · 5	уровень зрелости (из модели зрелости)
`тип:`	стандарт · регламент · приложение · методика · шаблон · запись · словарь · ранбук	тип документа
`система:`	zulip · bookstack · onyx · crm-erp · n8n · grace	затрагиваемые системы (многозначный)
`статус:`	проект · действует · архив	жизненный цикл
`владелец:`	смк · leantech · продажи · …	ответственный
`код:`	напр. РГ-СМК-Zulip-01	код документа
`объект:` · `контрагент:`	напр. ПС-Северная · Ромашка	якоря сущностей (мостик в CRM/ERP)

Теги книги стандарта и страниц

Книга «Рабочее пространство и знания — стандарт»:

раздел: управление-знаниями
тип: стандарт
система: zulip · bookstack · onyx · crm-erp
статус: проект
владелец: смк   ·   ведение: leantech
код: РГ-СМК-Zulip-01

Страницы (стандарт + приложения):

Страница	`тип:`	`система:`
РГ-СМК-Zulip-01 — Регламент	регламент	zulip
А — Грамматика тем	приложение	zulip · onyx
Б — Карта потока	приложение	zulip
В — Сущностная модель	приложение	crm-erp · zulip
Г — Словарь	словарь	— (сквозной)
Д — Архитектура и связи	приложение	zulip · bookstack · onyx · crm-erp · n8n
Е — Структура базы знаний	приложение	bookstack

Контурные книги (БЗ) получают раздел:, блок: бз-N, зрелость: N; контентные страницы дополнительно — объект: / контрагент:. Инфра-книги — раздел: инфраструктура, тип: ранбук, система: <своя>.

Связи (из приложений А, Д)

Zulip ↔ страница. Канон-документ = страница KB. В Zulip под Регламент: идёт обсуждение со ссылкой на страницу; страница ссылается назад на тред-обоснование.
Вебхук по полке → канал. Изменение страницы → n8n → уведомление в профильный канал (полка «СМК» → #качество). Детали — приложение Д.
Onyx по полке/тегам. Полка = document set; теги (блок:, зрелость:, система:) = фильтры. На них строятся ассистенты и срезы («что ≤2 по зрелости»). Чувствительные полки — ограниченный доступ или не индексировать.

Связанные документы

itech-zulip-reglament-start.md — ядро (стандарт).
itech-zulip-ontology.md — приложение А: грамматика тем.
itech-zulip-channels-valuestream.md — приложение Б: карта потока.
itech-zulip-project-entity-model.md — приложение В: сущностная модель.
itech-glossary.md — приложение Г: словарь.
itech-architecture.md — приложение Д: архитектура и связи.
Модель зрелости — по материалам LeanLab KM Maturity Model (отдельная книга на мета-полке).