KNOWLEDGE SPACE · ДОКУМЕНТАЦИЯ

Глоссарий терминов

Списки и справочники

Термин	Определение
Справочник	Сортированный, одноуровневый список строковых значений (Элементов справочника). Используется для формирования допустимых значений для Показателей типа «Справочник» или как основание для Пользовательского измерения. Является частью метамодели проекта, изменение справочника влияет на все использующие его модели.
Элемент справочника	Конкретное значение в справочнике, имеющее полное и короткое название, а также уникальный код (UUID). Не имеет собственных атрибутов. Для создания атрибутивной структуры необходимо использовать Класс.
Таблица мэппинга (мэппинг справочников)	Специальная таблица, определяющая правила соответствия (преобразования) между элементами двух разных справочников. Используется в Показателях с опцией «Использовать таблицу мэппинга».

Классы и показатели

Термин	Определение
Класс	Базовая сущность метамодели, определяющая структуру Объектов: перечень их Показателей (атрибутов) и возможные Связи с другими классами. В KS класс описывает только структуру данных; поведение задается отдельно (Формулами, Бизнес-процессами).
Показатель	Атрибут (поле) Класса, определяющий тип хранимых данных и их характеристики. Показатель — это определение поля, а не конкретное значение. Основные типы: Число, Строка, Дата, Логический, Файл, Медиа, Справочник, Объект, Пользователь, Интерфейс, Модель, Набор данных. Может иметь Измерения. Может иметь опцию «Общий для всех наборов данных» — при включении значение показателя синхронизируется во всех НД модели, включая заблокированные.
Формула	Алгебраическое или логическое выражение, определяющее правило расчета значения для Показателя. Прикрепляется к показателю на уровне метамодели. Имеет Область действия, позволяющую ограничить ее применение конкретными Наборами данных, элементами Измерений или временными периодами. Может содержать ссылки на другие показатели как в рамках одного объекта, так и по Связям.
Класс-связь	Специальный тип Класса, описывающий возможный вид связи между двумя другими классами. На уровне данных экземпляром класса-связи является Связь — самостоятельный объект, который может иметь собственные Показатели.
Лёгкий класс (Light Class)	Специальный тип Класса, данные объектов которого хранятся не в основной объектной модели KS, а в оптимизированных реляционных таблицах (по одной таблице на каждое уникальное сочетание Измерений). Предназначен для работы с большими массивами данных и прямого подключения внешних SQL-сервисов. Не поддерживает Связи и показатели типа «Объект». Создание объектов происходит через интеграции или бизнес-процессы.
Измерение (в контексте класса или показателя)	Признак, обеспечивающий детализацию (разделение) данных Показателя. Бывает двух видов: Пользовательское измерение: Всегда строится на основе Справочника. Элементы выбранного справочника становятся «срезами» для данных показателя. Временное измерение (ВИ): Специальный тип измерения, привязываемый к Модели. Позволяет распределять данные показателя по временным интервалам (День, Неделя, Техническая неделя, Декада, Месяц, Квартал, Год, Час, Произвольный).
Иерархическая структура (через сильные связи)	Способ организации объектов в древовидную структуру через специальный тип связи с опцией «Сильная связь». Позволяет создавать отношения родитель-потомок с каскадными операциями копирования и удаления.

Модели и данные

Термин	Определение
Модель	Изолированный контейнер для данных, связей и вычислений. Служит рабочей областью, где Объекты «присутствуют», Связи устанавливаются, а значения Показателей (Данные) хранятся и пересчитываются. Модель определяет Временное измерение и содержит Наборы данных. Является границей для построения графа зависимостей при пересчете сервисом MDC.
Набор данных (НД)	Сценарий или версия данных внутри Модели (например, «Факт», «План», «Прогноз»). Все объекты и показатели модели существуют во всех её НД, но с разными значениями. Формулы могут содержать ссылки на данные в разных НД, создавая перекрестные зависимости. НД можно копировать, после копирования они становятся независимыми.
Производный набор данных	НД, значения показателей в котором рассчитываются на основе данных из другого (базового) НД по формулам, содержащим межнаборные ссылки (например, [Прогноз] = [Факт] * 1.1). Изменения в базовом НД автоматически влияют на производный.
Временное измерение (ВИ)	Особая временная шкала, определяемая для Модели (тип периода, начальная точка, горизонт). Позволяет распределять значения Показателей, для которых включена опция «Может содержать временное измерение», по временным интервалам (День, Неделя, Техническая неделя, Декада, Месяц, Квартал, Год, Час, Произвольный).
Объект	Конкретный экземпляр Класса. Имеет глобальный уникальный идентификатор (UUID) в рамках Проекта. Для участия в расчетах Модели должен быть в неё добавлен («присутствовать»). Удаление объекта из последней модели, где он присутствовал, приводит к его полному удалению из системы. Значения его показателей (Данные) хранятся отдельно для каждой Модели и НД.
Глобальный объект	Объект с единым UUID в рамках проекта, который может присутствовать в нескольких моделях. Физически объект удаляется только после удаления его последнего назначения на модель.
Внешний идентификатор объекта	Пользовательское строковое поле объекта, используемое для его однозначной идентификации при интеграции с внешними системами. Позволяет внешней системе обращаться к смэппленным объектам KS по известному ей ключу.
Связь	Конкретный экземпляр Класса-связи, соединяющий два Объекта. Является самостоятельным объектом, может иметь собственные значения Показателей. Удаление одного из связанных объектов ведет к удалению связи.
Овеществлённая связь	Связь, которая представлена самостоятельным объектом — экземпляром класса-связи. Она может иметь собственные показатели, например статус, дату начала или долю участия.
Сильная связь	Тип связи, обеспечивающий каскадное копирование или удаление дочерних объектов вместе с родительским. Используется для построения иерархий и гроздей объектов.
Ссылка	Паттерн использования. В отличие от Связи (объекта), простым способом указания на другой Объект может служить Показатель типа «Объект» (хранящий UUID). Однако для такого указания не создается отдельного объекта-связи, и платформа не предоставляет специальных инструментов для навигации по таким ссылкам.
Данные	Конкретное значение Показателя для Объекта в строго определенном контексте: Модель x Набор данных x [Временное измерение] x [Пользовательские измерения].
Надмодельные свойства	Свойства объекта, общие для всех моделей проекта: UUID, имя, автор и дата создания. Они не зависят от модели, в которой присутствует объект.
Модельные свойства	Свойства объекта, зависящие от конкретной модели: связи с другими объектами и значения показателей. Значения показателей дополнительно различаются по наборам данных и измерениям.
Информационный контур (ИК)	Совокупность объектов, связей и значений показателей, образующая устойчивый сценарий организации данных. Информационный контур имеет управляемый жизненный цикл, версии и состояния.
Состояние информационного контура	Этап жизненного цикла информационного контура, например «новый», «на согласовании», «утверждён» или «архив». Состояние может определять доступные действия и видимость данных.
Гроздь объектов	Иерархическая структура, в которой объекты нижнего уровня связаны сильными связями с общим родительским объектом. Применяется для представления составных сущностей и версий информационного контура.
Песочница	Изолированное рабочее пространство для экспериментов или работы отдельной группы пользователей. Может быть реализовано как самостоятельная модель или отдельный набор данных.
Таблица данных	Сущность внутри Модели, определяющая конкретный разрез для представления данных: структуру строк, столбцов, фильтров и настроек консолидации. Не является интерфейсным элементом, но используется им (Интерфейсный элемент «Таблица» ссылается на Таблицу данных).
Мультимодельная таблица	Разновидность таблицы данных, которая отображает и агрегирует информацию из нескольких моделей одновременно. Используется, когда пользователю нужен единый разрез по данным разных моделей.
Диаграмма Ганта (Гант)	Сущность внутри Модели для планирования и визуализации работ. Основана на Объектах специального класса (Мероприятия), имеющих показатели «Дата начала», «Дата окончания», «Длительность». Настраивается отдельно, используется Интерфейсным элементом «Диаграмма Ганта».
Диаграмма (draw.io)	Сущность внутри Модели, представляющая собой векторную схему для визуализации структур, процессов или архитектуры. Настраивается отдельно, используется Интерфейсным элементом «Диаграмма».
Шаблон импорта/экспорта	Конфигурация для загрузки данных в модель или выгрузки из нее через файлы Excel. Определяет сопоставление полей файла с сущностями KS (Объекты, Показатели, Связи). Имеет типы: Стандартный (для объектов и значений), Плоская таблица (для данных в разрезах измерений), Импорт связей.
Файловое хранилище	Механизм хранения файлов через объектную модель KS. Обычно включает класс-хранилище, объекты-файлы, показатель типа «Файл» и связи с объектами предметной области.

Интерфейсы

Термин	Определение
Интерфейс (страница)	Экран (дашборд) для пользователя, состоящий из Ячеек. Может быть корневым (отображается в меню Приложения) или вложенным (используется как компонент внутри другого интерфейса через соответствующий элемент).
Ячейка	Базовый структурный блок Интерфейса. Контейнер произвольного размера и позиции, который может накладываться на другие ячейки (управляется через Z-index). Содержит ровно один Интерфейсный элемент.
Интерфейсный элемент (связанная сущность)	Функциональный компонент, помещаемый в Ячейку. Настраивается в её контексте. Основные типы: – Таблица — отображает данные на основе Таблицы данных или структуры, заданной непосредственно в элементе. Мультимодельная таблица — особый тип Таблицы данных, способный отображать и агрегировать информацию из нескольких Моделей одновременно. – График (Chart) — визуализирует числовые данные (гистограмма, линии, круговая и т.д.). Может строиться на основе структуры Таблицы. – Фильтр — элемент управления для отбора данных (объектов, элементов справочника) и генерации соответствующего События. – Кнопка — триггер для выполнения цепочки Действий. – Виртуальная кнопка — кнопка, не отображаемая в интерфейсе, срабатывающая автоматически по Событию (например, при загрузке интерфейса). – Навигатор, Карточка объекта, Виджет, Доска (Канбан) — элементы для навигации, отображения и управления объектами. – Диаграмма (draw.io) — элемент для отображения Диаграммы (draw.io) из модели. – Интерфейс (вложенный) — элемент для встраивания другого Интерфейса в текущую страницу. – Диаграмма Ганта — элемент для отображения и взаимодействия с сущностью «Диаграмма Ганта» из модели. – Таблица интеграции — элемент для отображения данных из внешнего источника через интеграционную таблицу. – Описание сущности — элемент для отображения документации, прикрепленной к сущности.
Действие (в контексте интерфейса)	Атомарная операция, выполняемая платформой при активации интерфейсного элемента (например, нажатии кнопки, клике по виджету). Формирует линейную последовательность операций (блок «Действия»). Типы действий включают: создание/изменение объектов, запуск бизнес-процессов, экспорт данных, сохранение в глобальные переменные. Отличается от «Действия (Операции)» в Интеграциях.
Описание сущности (как интерфейсный элемент)	Элемент, отображающий настраиваемый текстовый или мультимедийный блок документации, прикреплённый к сущности проекта (классу, модели, объекту и др.). Может содержать поля различных типов (строка, число, дата, файл, изображение). Также является свойством многих сущностей на уровне метаданных.
Плоский список виджетов	Разновидность элемента «Виджет», автоматически тиражирующая заданную структуру виджета для каждого элемента в коллекции сущностей (объектов, моделей, элементов справочника и др.). Каждый экземпляр в списке может генерировать события с соответствующей сущностью.
Событие	Основной механизм интерактивности. Представляет собой строго типизированный пакет данных (с полезной нагрузкой — Сущностью), передаваемый от одного Интерфейсного элемента (источника) другому (приемнику). Содержит тип, данные и Тег. Отличается от События (BPMN).
Глобальная переменная	Механизм сохранения События (сущности с тегом) для передачи между разными Интерфейсами или сессиями. Типы: переменная сессии (хранится во вкладке браузера) и переменная пользователя (сохраняется в профиле).
Тег	Идентификатор, используемый для фильтрации Событий (например, при настройке Входящего события на ячейке) и для именования Глобальных переменных. Также используется как метка для Моделей и Наборов данных.
Условное форматирование	Правило, изменяющее визуальный стиль (цвет, шрифт, видимость) Интерфейсного элемента, Ячейки или их частей на основе заданных условий или выражений.

Приложения

Термин	Определение
Приложение (публикация)	Конечный продукт для бизнес-пользователей, представляющий собой иерархическую структуру из Интерфейсов (сгруппированных в папки), объединенных общими настройками доступа, макета и цветовой схемы. Запускается в отдельной веб-вкладке.
Макет	Настройки общих визуальных элементов Приложения: шапка, боковое меню, фон, логотип, расположение блоков.
Цветовая схема	Набор пользовательских стилей (цветов), применяемых к элементам Приложения (шапка, блоки, меню, фон, модальные окна).
Доступ	Механизм управления правами на просмотр и использование Приложения. Может предоставляться по ссылке, отдельным Пользователям или Ролям.

Интеграции

Термин	Определение
Интеграция (интегратор)	Настраиваемый артефакт для обмена данными с внешними системами или выполнения сложных внутренних операций (например, массовый импорт). Два типа: Последовательная интеграция: Выполняет строгую цепочку Действий (операций) заранее определенного типа (Получение данных, Передача данных, Запуск процедуры). Модульная интеграция (Модульный интегратор): Позволяет гибко выстраивать граф Действий с ветвлением, параллельным выполнением, циклами и переменными.
Источник данных	Конфигурация подключения к внешней системе, а не само хранилище. Типы: Источник БД (например, PostgreSQL), Шина данных (например, RabbitMQ), Источник API, Публикация API (объявление входящего API платформы).
Публикация API	Тип источника в интеграторе, представляющий собой объявление входящего API платформы для приёма данных или команд из внешних систем. Настраивается как конечная точка (endpoint) с определённым форматом запросов и правилами обработки.
Действие (операция)	Элементарный шаг в Интеграции (например, «Получение данных», «Создать объект», «Отправить сообщение в шину»). В модульной интеграции действия связываются через логику выполнения и поток данных.
Переменная интеграции	Сущность в Модульной интеграции для передачи данных между Действиями, в Бизнес-процессы и обратно. Имеет тип (Число, Строка, Файл, Объект и др.).
Интеграционная таблица	Конфигурация запроса (например, SQL SELECT) для получения данных из внешнего источника, настроенного в Интеграции. Используется Интерфейсным элементом «Таблица интеграции» для прямого отображения и редактирования внешних данных.

Бизнес-процессы

Термин	Определение
Бизнес-процесс (БП, шаблон)	Описание логики процесса в нотации BPMN, являющееся исполняемой сущностью платформы. Состоит из элементов: События (BPMN), Шлюзы, Задачи.
Экземпляр бизнес-процесса	Конкретный запущенный и выполняемый экземпляр Бизнес-процесса. Имеет статус, историю и собственные Переменные.
Задача	Элементарное действие в Бизнес-процессе. Определяется Критерием завершения задачи, который задаёт её логику (например, «Отправка уведомления», «Запуск интеграции», «Операции с сущностями»). Может иметь Исполнителей (пользователей/роли).
Критерий завершения задачи	Конфигурируемая логика, определяющая, что должно быть выполнено для завершения задачи в бизнес-процессе. Примеры: «Отправка уведомления», «Запуск интеграции», «Ручное завершение пользователем». Связь: задача имеет ровно один критерий завершения.
Диаграмма бизнес-процесса	Визуальное представление (flowchart) шаблона бизнес-процесса, синхронизируемое с его элементами (событиями, шлюзами, задачами). Может использоваться для документации и навигации по процессу.
История запусков	Журнал всех экземпляров бизнес-процесса, содержащий для каждого дату и время запуска, инициатора, статус, а также детальную пошаговую историю выполнения с временными метками и исполнителями.
Переменная бизнес-процесса	Сущность для хранения и передачи данных между шагами БП. Может иметь различные типы, включая Сущность (ссылку на любой объект платформы: Объект, Модель, Пользователь и т.д.) и Коллекцию (одномерный массив значений).
Коллекция (в контексте БП)	Особый тип Переменной бизнес-процесса или промежуточный набор сущностей (обычно объектов), используемый для передачи массива данных между Действиями.
Шлюз (BPMN)	Логический оператор (И/ИЛИ) для контроля ветвления и слияния потоков управления в Бизнес-процессе (параллельный, исключающий, включающий).
Событие (BPMN)	Элемент потока управления, отражающий состояние, влияющее на ход Бизнес-процесса (начальное, промежуточное, завершающее). Отличается от События интерфейса.

Общие и административные понятия

Термин	Определение
Knowledge Space (KS)	Платформа для создания исполняемых бизнес-моделей и прикладных решений. Декларативное описание структуры данных, расчётов, процессов и интерфейсов объединяется в единый проект, который можно запустить и пересчитать на актуальных данных.
Решение	Законченный программный продукт, созданный на платформе KS для реализации определённых бизнес-задач. Решение включает данные, расчёты, процессы, интерфейсы и настройки доступа.
Проект	Максимальный контейнер, включающий в себя все сущности (метамодель, данные, логику, интерфейсы, приложения) одного законченного Решение. Является основной рабочей единицей в KS.
Категория сущности (dev/prod/ext)	Атрибут, присваиваемый сущностям (Классам, Моделям, Интерфейсам и др.) внутри Проекта. Определяет назначение сущности в жизненном цикле разработки и её поведение при миграции между проектами-средами: dev (development) — сущность, являющаяся неотъемлемой частью решения (структура, основные интерфейсы). prod (production) — эксплуатационные, наполняемые пользователем данные. ext (external) — сущность, предназначенная для внешнего обновления (например, библиотечные компоненты). Категория влияет на обработку сущностей при резервном копировании и восстановлении между средами.
Dev-Prod жизненный цикл	Методология разделения разработки и эксплуатации решений на платформе через категории сущностей (dev/prod/ext) и механизмы миграции между проектными средами. Обеспечивает контролируемый процесс обновления бизнес-решений.
Трансляция	Контролируемый перенос сущностей решения между средами DEV, TEST и PROD. При переносе учитываются категории dev/prod/ext и выполняется сопоставление UUID сущностей.
Резервное копирование и восстановление	Механизм создания переносимых копий проектов с возможностью выборочного включения сущностей и файлов. Используется для миграции между средами (dev/prod) и аварийного восстановления.
Правило доступа	Настраиваемая политика разграничения прав на операции с данными и сущностями платформы. Определяет комбинацию условий (по тегам, значениям показателей, пользователям) и разрешённых действий (чтение, редактирование, удаление) для сущностей: Модель, Объект, Данные, Набор данных. Является механизмом более детального управления доступом, дополняющим роли.
Проектная роль	Роль, определённая в рамках конкретного проекта, в отличие от системной роли на уровне инстанса. Назначается пользователям через политики доступа внутри проекта и может включать кастомные наборы разрешений.
Пользователь	Учетная запись в системе, имеющая профиль (ФИО, фото, кастомные поля) и набор Ролей.
Роль	Набор Политик (элементарных разрешений), определяющий доступ к разделам и функциям платформы.
Политика	Элементарное разрешение на доступ к конкретному разделу или действию в системе.
Назначение (технический термин)	Служебный механизм, отражающий факт присутствия Объекта в Модели или участия сущности в другой сущности. Является основой для каскадных операций удаления: удаление родительской сущности (например, Модели или Набора данных) влечет удаление связанных с ней «назначений», а при удалении последнего «назначения» удаляется и сама сущность (например, Объект).
Календари и рабочие недели	Глобальные сущности уровня инстанса, используемые для учёта рабочего времени в расчётах моделей и планировании. Включают шаблоны рабочих недель и исключения (праздники, особые дни).
Политика безопасности и аутентификации	Набор правил на уровне инстанса, управляющих безопасностью доступа: парольная политика, блокировка учётных записей, настройки времени жизни токенов, интеграция с внешними провайдерами (Keycloak, Active Directory).
Реестр событий (журнал событий)	Системный журнал значимых действий и изменений: входов пользователей, операций с объектами и изменений прав. Используется для аудита, расследования инцидентов и восстановления истории.
Инстанс (стенд)	Экземпляр развернутой платформы KS, содержащий один или несколько Проектов и общие настройки (глобальные Источники данных, шрифты, иконки).
Контекст (в вычислениях)	Совокупность условий, определяющих конкретное состояние данных при расчётах: текущий период Временного измерения, значения Пользовательских измерений, активный Набор данных, права доступа пользователя. Все вычисления в KS выполняются в определённом контексте.