# Приложение Г: Словарь — корпоративная база знаний (KB)

*Каноническая страница базы знаний (KB). Приложение Г к РГ-СМК-Zulip-01.*

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

**Стек одним предложением:** сущности — в CRM/ERP, документы — в KB (BookStack), обсуждение — в Zulip, поиск поверх всех — Onyx.

---

## Слои и системы

* **KB (knowledge base) / корпоративная база знаний** — канонический слой документированного знания: регламенты, стандарты, методики. Источник истины по документам. Четыре раздела (контура): СМК/ISO 9001, инженерный, производственный, коммерческий.
* **BookStack** — вики-платформа, на которой ведётся KB: полки → книги → главы → страницы; версии, поиск, перелинковка.
* **Zulip** — корпоративный мессенджер; слой обсуждения и координации. Источник «что происходит и как мы к этому пришли».
* **CRM / ERP** — слой сущностей и транзакций. Источник истины по контрагентам, объектам, проектам.
* **ERP** — внедряемая система управления ресурсами; целевой носитель сущностной модели (текущая внутренняя инициатива).
* **Onyx** — слой RAG-поиска поверх трёх источников (Zulip, KB/BookStack, CRM/ERP); даёт цитируемые ответы.
* **GRACE** — собственное приложение АйТека (разрабатывает отдел цифровизации АйТека); интеграция со смежными системами — на стороне LeanTech.

---

## Коммуникация (Zulip)

* **Канал (stream)** — устойчивая единица: кто участвует и кто видит; граница доступа и индексации.
* **Тема (topic)** — единица работы/знания внутри канала; единица поиска в Onyx.
* **Сквозной канал** — следует за объектом потока (заказом) через все стадии (`#проекты`).
* **Стадийный канал** — закреплён за стадией потока; ведёт повторяющуюся работу стадии.
* **Префикс темы** — метка типа темы из закрытого списка: `Проект:`, `Инициатива:`, `Клиент:`, `Сделка:`, `Проблемный кейс`, `Регламент:`, `Аудит:`, `Несоответствие:`, `CAPA:`, `Анализ рук-ва:`, `Решение:`, `Рекламация:`. Правила применения — приложение А.

---

## Сущности

* **Контрагент** — заказчик, генподрядчик, проектировщик, поставщик или субподрядчик.
* **Объект** — площадка/сооружение, для которого изготавливается оборудование (ПС, завод, ЖК, цех). Живёт долго, может собрать несколько проектов.
* **Проект** (= заказ) — поставка оборудования на конкретный объект со своим жизненным циклом (G0–G8). В бизнес-языке АйТека «проект» = заказ.
* **Изделие** — единица продукции в составе проекта: НКУ, РУСН, подстанция.
* **Инициатива** — внутреннее изменение/улучшение (цифровизация, интеграция, изменения СМК). Не путать с проектом-заказом.

---

## Поток и процесс

* **Поток создания ценности** — сквозной маршрут заказа от запроса до сдачи; основа архитектуры каналов.
* **Стадия потока** — этап маршрута: продажи → проектирование → снабжение → производство → качество → отгрузка → сервис.
* **Шлюз (G0–G8)** — контрольная точка перехода проекта между стадиями: G0 запрос, G1 расчёт+КП, G2 договор, G3 КД, G4 снабжение, G5 сборка, G6 ОТК/ПСИ, G7 отгрузка, G8 ПНР/сдача.
* **Карточка проекта** — первое сообщение темы `Проект:` с контрагентом, объектом, составом, сроком, статусом и ссылками в CRM/ERP и KB.
* **Площадка** — производственная локация (Подольск / Кострома). Измерение темы (`Площадка:`), а не отдельная ветка каналов.

---

## Доменные термины (НКУ-производство)

* **НКУ** — низковольтное комплектное устройство.
* **РУСН** — распределительное устройство собственных нужд. *[Уточнить каноническую расшифровку — в оргструктуре фигурирует и «РУСН», и «распределительные устройства среднего напряжения».]*
* **ПС** — подстанция.
* **КД** — конструкторская документация.
* **КП** — коммерческое предложение.
* **ПНР** — пусконаладочные работы.
* **ПСИ** — приёмо-сдаточные испытания.
* **ОТК** — отдел технического контроля.
* **ЭТЛ** — электротехническая лаборатория.
* **СМК** — система менеджмента качества.
* **ISO 9001** — международный стандарт системы менеджмента качества.
* **CAPA** — корректирующие и предупреждающие действия (corrective and preventive actions).

---

## Как пользоваться

* Это единственный источник истины по терминам. Любое расхождение в значении решается правкой здесь, а не локальной трактовкой.
* Изменение термина проводится как `Инициатива:` в `#развитие`; утверждённая формулировка обновляется на этой странице.
* На словарь ссылаются стандарт (РГ-СМК-Zulip-01), приложения А–В, описания каналов и Onyx-ассистенты.
* Владелец — руководитель СМК; ведение — совместно с LeanTech.