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

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

Объектная основа. Книги яруса «Содержание» — не папки отделов, а проекции бизнес-объектов (CoreStream A1–A11). Данные Grace = зёрна (экземпляры записей); объектная модель = контекст, из которого разворачиваются и процесс (методы объекта), и метрики (эконометрика по фазам жизненного цикла). BookStack фиксирует контекст-знание, Grace держит данные, агент соединяет их через теги объект-cs: и фаза:.

---

Три яруса

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

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

---

Дерево

KB (BookStack)
│
│ ── СОДЕРЖАНИЕ (книги = блоки знаний БЗ = проекции объектов A1–A11) ──
│
├─ Полка: СМК / ISO 9001                         · объект A2 Бизнес-система
│   ├─ Книга: БЗ-1 Бизнес-процессы и СМК
│   └─ Книга: БЗ-2 Записи качества
│
├─ Полка: Инженерный                             · объект A3 Продукт
│   ├─ Книга: БЗ-3 Продукты и конфигурации     ⇄ Коммерческий
│   └─ Книга: БЗ-4 Нормативная база
│
├─ Полка: Производственный                       · объект A8 Товар
│   ├─ Книга: БЗ-5 Технологические стандарты
│   └─ Книга: БЗ-6 База дефектов и решений      ⇄ СМК
│
├─ Полка: Коммерческий                           · объект A7 Потребитель (компания)
│   ├─ Книга: БЗ-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 (все контуры).

Полки — адаптируемы: по мере наполнения добавляем дома для остальных объектов (A5 Трудовые ресурсы → HR, A10 Капитал → Финансовый, A4 Активы → АХО, A6/A9 Снабжение и логистика).

---

Содержание: книги = блоки знаний = проекции объектов

Книги контурных полок — это 11 блоков знаний (БЗ-1…11), а не произвольный набор. Каждый блок — проекция бизнес-объекта CoreStream: он представляет один объект в контуре знаний, со своими атрибутами, фазами жизненного цикла и связями.

Полка (контур)	Книги	Объект CoreStream
СМК / ISO	БЗ-1 · БЗ-2	A2 Бизнес-система
Инженерный	БЗ-3 · БЗ-4	A3 Продукт
Производственный	БЗ-5 · БЗ-6	A8 Товар
Коммерческий	БЗ-7 · БЗ-8 · БЗ-9 · БЗ-11	A7 Потребитель (компания)
(сквозная)	БЗ-10 Прецеденты проектов	Здание (объектный контур)

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

«Здание» ≠ «Потребитель» (важный развод)

«Потребитель» в данных бывает трёх разных сущностей — их нельзя смешивать:

• Компания (accounts) = объект A7 Потребитель: у неё свой жизненный цикл продаж (потенциальный → горячий → покупатель → спящий), её квалифицируют, обслуживают, удерживают.
• Здание (properties) = отдельный объект (объектный контур): место, где стоит наше оборудование, — точка потребления, не покупатель. Знание о нём = прецеденты (БЗ-10).
• Представитель (contacts) = часть A7 (контактное лицо, интерфейс к компании), не самостоятельный объект.

Связывает их Проект (projects) — это связь, а не объект: несёт account_id (компания) + property_id (здание) + фазы. Прямого ребра «Здание → Компания» нет — только через Проект. Поэтому один объект-здание может быть связан со многими компаниями (проектировщик, генподрядчик, заказчик). Подробные карточки объектов — слой corestream (напр. A7_potrebitel.md).

---

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

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

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

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

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

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

---

Жизненный цикл знания (как ведём KB)

Как знание живёт в KB — это цикл объекта A11 «Знания»: A11.1 Сбор → A11.2 Интеграция в процесс → A11.3 Применение → A11.4 Оценка → A11.5 Обновление → A11.6 Архивация. Этот цикл = операционная модель базы знаний и он же ложится на уровни зрелости (1→5): от «в головах» до «живой контекст AI-агента». Тег статус: (проект · действует · архив) отмечает положение страницы в этом цикле.

---

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

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

---

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

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

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

Различать: объект-cs: = тип объекта в модели (A7, здание); объект: / контрагент: = конкретный экземпляр (ПС-Северная, Ромашка). Первое связывает с моделью и эконометрикой, второе — с записью в Grace.

---

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

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

раздел: управление-знаниями
тип: стандарт
система: 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, объект-cs: aN, зрелость: N; контентные страницы дополнительно — фаза:, объект: / контрагент:. Инфра-книги — раздел: инфраструктура, тип: ранбук, система: <своя>.

---

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

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

---

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

• 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 (отдельная книга на мета-полке).
• Карточки объектов (слой corestream): 00_object_map.md, A7_potrebitel.md — объектная модель, питающая структуру и теги.