Документация Enums

Стартовый экран рабочего пространства: строка чата о бизнесе, лента сохранённых отчётов и настраиваемая сетка KPI-виджетов по выбранному подключению

Что это и зачем

«Главное» — это стартовый экран, который открывается сразу после входа и выбора подключения. Раздел собирает на одной странице три блока: строку чата «Спросите о вашем бизнесе», ленту сохранённых отчётов и сетку KPI-виджетов (заголовок секции — Ключевые показатели). Виджеты показывают ключевые финансовые и операционные показатели по данным выбранной системы и обновляются автоматически.

Экран кроссистемный: один и тот же интерфейс работает и для подключений 1С, и для подключений iiko (компонент AnalyticsWidgets используется для обеих систем). Набор и содержимое виджетов при этом разные — система подбирает их по типу подключения через каталог пресетов, отфильтрованный по erp_type (см. блоки «Возможности для 1С» и «Возможности для iiko» ниже).

Где находится и как открыть

Пункт Главное — первый в меню слева, в группе «Рабочее пространство». Он доступен всегда (не требует отдельного права) и является разделом по умолчанию. При смене подключения интерфейс автоматически возвращается на «Главное»: экран предыдущего подключения (например, «Пользователи» или «ЕГАИС») обычно не относится к новому, поэтому система сбрасывается на безопасную стартовую страницу.

Какие блоки появятся на «Главном», зависит от ваших прав и возможностей подключения:

Строка чата — при наличии права на чат (chat).
Сохранённые отчёты — при праве и возможности просмотра отчётов (report_viewer). Подробнее в разделе Просмотр отчётов.
KPI-виджеты — при праве и возможности аналитики (analytics) или загрузки документов (upload). Право и возможность проверяются вместе.

Если у пользователя нет ни одного из этих блоков (например, лицензия только на ЕГАИС), на «Главном» показывается приветственный экран «Добро пожаловать в enumslab» с предложением выбрать раздел в меню. Пользователя с правом ЕГАИС (egais_viewer или egais_builder) система при этом один раз за сессию автоматически переводит на панель ЕГАИС.

Строка чата «Спросите о вашем бизнесе»

В верхней части «Главного» расположено поле ввода вопроса с подсказкой-примером (для 1С: «Задолженности, поступления, счета, карточки счетов»; для iiko: «Меню, поступления, продажи»). Можно:

Ввести вопрос и отправить его клавишей Enter или кнопкой отправки — откроется всплывающее окно чата с ассистентом (Shift+Enter переносит строку, не отправляя).
Прикрепить файл кнопкой со скрепкой (Прикрепить): изображение, PDF, Excel или Word, размер до 10 МБ.
Отметить нужные сохранённые отчёты «фишками» под строкой — отмеченные отчёты попадут в контекст диалога.

Сама беседа ведётся в отдельном окне; подробное описание ассистента — в разделе Ассистент (чат).

Как пользоваться сеткой виджетов

Виджеты выводятся плиткой, которую можно настраивать. В правом верхнем углу секции «Ключевые показатели» есть панель действий:

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

В режиме правки изменения расположения подтверждаются кнопкой Сохранить или отменяются кнопкой Отмена (отмена возвращает прежнюю раскладку). У каждого виджета в этом режиме есть кнопка-крестик Убрать, скрывающая его с дашборда. Расположение и размеры сохраняются за подключением и пользователем на сервере.

Многие виджеты — кликабельные (у них в углу есть стрелка-подсказка): нажатие открывает окно детализации (drill-down) с разбивкой по контрагентам, документам, складам или позициям. Если у пользователя ещё нет ни одного виджета, показывается пустое состояние «Нет настроенных показателей» с кнопкой Добавить.

Данные виджетов кэшируются в браузере на 2 часа, поэтому при повторном входе дашборд открывается мгновенно. Загрузка показателей продолжается в фоне, даже если уйти со страницы, — результаты досчитываются по одному виджету и попадают в кэш (поэтому частично загруженный дашборд при возврате дочитывается, а не запрашивается заново). Для свежих цифр используйте кнопку «Обновить данные».

Возможности для 1С

Для подключений 1С виджеты строит финансовая аналитика на стороне сервиса (analytics_service.py + financial_analytics.py): она обращается к данным 1С через защищённый туннель, опираясь на бухгалтерский регистр Хозрасчетный и план счетов (Минфин 94н). Расчёт ведётся в коде сервиса, без BSL-функций на стороне 1С. Доступны, в частности, следующие показатели:

Дебиторская и кредиторская задолженность — остатки по счетам расчётов. Сервис обходит иерархию плана счетов от родительских счетов 60, 62, 68, 69, 70, 71, 73, 75, 76 и подбирает все субсчета автоматически. Виджет кликабельный: открывается окно с вкладками Дебиторская / Кредиторская, разбивкой по счетам и детализацией по контрагентам.
Денежный поток — приход и расход по расчётным и кассовым счетам (51 и 50.01) за последние месяцы в виде столбчатой диаграммы. Клик по месяцу раскрывает поступления и списания с вкладками доходов и расходов по контрагентам.
Топ должников — крупнейшие контрагенты по сумме непогашенного долга; для расчёта просрочки используется дата запрета изменения из регистра ДатыЗапретаИзменения. Детализация — полный список должников.
Предстоящие платежи — неоплаченные счета и документы поставщиков на ближайший период; детализация — список платежей.
Розничные продажи — выручка по документам ОтчетОРозничныхПродажах и РозничнаяПродажа: сводка за период, сравнение «сегодня/вчера» (с процентом изменения), разбивка по складам, топ и аутсайдеры товаров. Детализация спускается до конкретных документов и их позиций.

Часть виджетов 1С поддерживает фильтр по организации — это виджеты, чей серверный эндпоинт принимает параметр организации: задолженность (receivables-payables), денежный поток (cash-flow) и предстоящие платежи (upcoming-payments). В шапке такого виджета есть серая надпись Все организации — по клику открывается список организаций из справочника 1С с поиском, выбор сохраняется для каждого виджета отдельно.

Помимо финансовых показателей, в галерею «Добавить» для 1С входят служебные виджеты, которые загружают данные самостоятельно: Бизнес-тренды (Радар), Аномалии документов и Библиотека документов. Радар сейчас активно выполняет две проверки по периодам — Выручка (тренд оптовых и розничных продаж) и Ключевые клиенты (концентрация / зависимость от крупных контрагентов); остальные проверки (маржинальность, неактивные клиенты, структура расходов, старение дебиторки, задержки оплаты, темп операций) присутствуют в интерфейсе как «Скоро» и пока не выполняются.

Возможности для iiko

Для подключений iiko «Главное» использует ту же сетку виджетов, но с набором показателей, рассчитываемых по OLAP-отчётам продаж iiko (через сервер iiko-MCP). Это рабочие, а не демонстрационные данные. Виджеты добавляются из той же галереи «Добавить»; их пресеты привязаны к типу системы iiko и не предлагаются на 1С-подключениях.

Пульс дня — выручка, гости, число заказов и средний чек за сегодня; при наличии данных за вчера показывается изменение относительно вчера.
Топ блюд — лучшие позиции по выручке за период (по умолчанию неделя).
Фудкост (себестоимость) — выручка, себестоимость и доля фудкоста в процентах (с ориентиром «≤ 35%»), с разбивкой по категориям и трендом за 7 дней.
Удаления (voids) и Скидки — суммы и разбивка по причинам/типам и официантам.
Загрузка по часам — распределение выручки по часам открытия чека за день, с отметкой пика.
Здоровье меню — превентивная диагностика блюд с тонкой маржой и чрезмерными скидками. При отсутствии проблем виджет показывает «Меню в порядке». Пороговые значения подставляются из политики по подключению (если она задана), иначе используются значения по умолчанию.

Фильтр по организации для iiko недоступен — в iiko нет справочника «Организации», поэтому виджеты iiko показываются без этой надписи, а соответствующие серверные запросы для iiko-подключений не выполняются. В коде сохранился ранний экран-заглушка «KPI-виджеты для iiko» (IikoKpiPlaceholder, текст про «появится в ближайшее время»), но он больше не используется: в реестре KPI_PAGE_BY_SYSTEM для iiko указан тот же компонент сетки, что и для 1С, с реальными показателями.

Ограничения и права доступа

Раздел «Главное» в меню виден всем (право не требуется), но его содержимое наполняется только при наличии прав и возможностей на чат, отчёты, аналитику или загрузку документов.
Финансовые виджеты 1С зависят от живого подключения к 1С через туннель: при сбое связи виджет показывает «Ошибка подключения к системе» с подсказкой проверить соединение и нагрузку. Виджеты iiko зависят от доступности данных iiko.
Кэш данных хранится в браузере 2 часа; для гарантированно актуальных цифр нажимайте «Обновить данные».
Настройки расположения и видимости виджетов, а также фильтры по организации, сохраняются отдельно для каждого подключения и каждого пользователя.

Главное (Дашборд)