Пульс компании

Пульс компании

Четыре сигнала для начала рабочего дня: просроченные задачи, незакрытые инциденты с нарушенным SLA, задачи со сроком в ближайшие 24 часа и инциденты без исполнителя. Виджет показывает общий объём открытых задач и график выбранных показателей за 24 часа или 7 дней, когда накоплена история.

Пакет: виджет дашборда + автоматизация сбора. Цена — 2 500 ₽ за активацию в одной компании. Оплата согласуется с продавцом вне Synchra24, после оплаты выдаётся ключ активации. Подписка на нужные возможности Synchra24 приобретается отдельно. У продукта нет собственной ежемесячной платы, AI-запросов или отправки в сторонние чаты.

Для кого

Для владельца компании, операционного руководителя и администратора, который ведёт задачи и инциденты в Synchra24 и хочет видеть короткую сводку до открытия отдельных разделов.

Что входит

• Виджет Пульс компании для веба и мобильного приложения. Цвета следуют теме платформы; одна плашка, автоматическая высота, без внутренней прокрутки страницы.
• Автоматизация Пульс компании — сбор показателей. Получает данные через публичный Open API раз в 30 минут и сохраняет сводку внутри текущей компании.
• История снимков за последние 8 суток, до 385 точек. Сравнение появляется при наличии снимка давностью 24–25 часов. Пропуски не превращаются в нули. При одновременных запусках история может потерять промежуточную точку: параллельный сбор не рекомендуется.
• Исходный код обоих компонентов для внутренней адаптации в пределах лицензии.

Требования и доступ

Нужны действующие возможности Приложения, API, Задачи и Инциденты, интернет и роль администратора компании. Автоматизации нужны права на управление интеграциями; читателю виджета тоже требуется admin_edit_provider_integrations, поскольку сводка хранится как артефакт. Это сводка для руководителя или администратора, а не виджет для любого сотрудника. Не выдавайте управление интеграциями только ради просмотра сводки.

Для полного охвата компании используйте Open API токен администратора этой же компании. Токен пользователя с ограниченным доступом может дать неполный набор задач. Продукт не обходит права доступа. Токены покупателя не входят в пакет и не передаются продавцу.

Установка и первый запуск

1. Активируйте и установите пакет, чтобы появились оба компонента. Автоматизация после установки выключена.
2. В Администратор → Сервисы откройте Пульс компании. Проверьте назначение Виджет дашборда, доступ в вебе и переключатели Автоматическая высота, Без заголовка и отступов. Предоставьте доступ только нужным администраторам. На мобильном приложении требуется версия с поддержкой автоматической высоты.
3. В параметрах своей компании создайте Open API токен администратора. У администратора интеграции получите соответствующий токен компании публичным методом параметров Open API — руководство, каталог методов. Не используйте пароль или токен входа в приложение.
4. В Администратор → Автоматизации → Переменные добавьте секреты PULSE_OPENAPI_TOKEN и PULSE_PROVIDER_TOKEN с этими двумя значениями. Не вставляйте значения в код, описание или артефакт.
5. В Автоматизации → Артефакты создайте один раз артефакт sync24.company-pulse.v1 со значением {}. Это начальная пустая история. Не заменяйте существующий артефакт: в нём уже могут храниться данные.
6. Откройте сборщик Пульс компании — сбор показателей, выполните Проверочный запуск. Он должен показать шесть числовых показателей, но ничего не записывает. При ошибке проверьте секреты, компанию, подписку и права.
7. Сохраните настройки, выполните обычный Запустить и убедитесь, что создана сводка. Затем включите автоматизацию для сбора каждые 30 минут.
8. На дашборде включите Пульс компании в настройках виджетов, если он скрыт. Перечитайте сводку кнопкой со стрелкой. Сравнение за сутки в первый день отсутствует — это ожидаемо.

При обновлении или повторной установке используйте один сборщик и одно имя артефакта на компанию: не включайте дубликаты.

Как читать показатели

• Просроченные задачи — незавершённые и неотменённые задачи, у которых срок уже прошёл. Используется серверный фильтр просрочки; берётся общее число результатов, а не размер первой страницы.
• Инциденты с нарушенным SLA — незакрытые инциденты, в которых просрочен срок решения либо срок реакции ещё не принятого инцидента. SLA без настроенных сроков не даёт сигнала. Закрытые с опозданием инциденты сюда не попадают.
• Срок в ближайшие 24 ч — открытые задачи с будущим сроком в ближайшие сутки. Текущая просрочка не входит в это число.
• Без исполнителя — незакрытые инциденты с группой обслуживания, но без назначенного специалиста. Это не все записи, у которых в карточке не заполнен список участников.
• Открытых задач / Высокий приоритет — текущие незавершённые задачи и среди них задачи с весом приоритета выше 2.

Один инцидент может входить в два показателя. Виджет не складывает их в общий «балл здоровья». Статус отмечает наличие просрочек, ближайших сроков или инцидентов без исполнителя.

Разница за сутки — изменение числа, а не число выполненных задач: например, −3 просрочки может включать закрытия, переносы срока и изменения статуса. При отсутствии подходящего снимка сравнение скрыто.

График показателей

В блоке Динамика выберите Тип динамики и период 24 часа или 7 дней:

• Просрочки — просроченные задачи и незакрытые инциденты с нарушенным SLA.
• Нагрузка по задачам — все открытые задачи и среди них задачи высокого приоритета.
• Ближайшие сроки — открытые задачи со сроком в следующие 24 часа на момент каждого сбора, без текущей просрочки.
• Инциденты без исполнителя — незакрытые инциденты в группах обслуживания без назначенного специалиста.

В основном виде оставлены плитки с числами, короткие подписи, время обновления и график. Подробные определения показателей приведены в этой инструкции. Подписи линий и шкала меняются с выбранным типом. Первая линия сплошная, вторая, когда она есть, пунктирная; показатели не суммируются. Коснитесь точки графика или выберите снимок стрелками клавиатуры, чтобы прочитать время и оба значения. Даты показаны в часовом поясе устройства.

График использует только сохранённые снимки. В первый запуск видна одна точка, история появится после следующих сборов. Пустые периоды не заполняются нулями; разрывы больше 90 минут не соединяются. Линия показывает изменение количества на моменты сбора, а не каждое отдельное событие между ними. При устаревании или ошибке чтения график остаётся как последняя известная история с явной отметкой.

Обновление и ошибки

Сборщик обращается к Synchra24 раз в 30 минут. Видимый виджет перечитывает сохранённый результат раз в минуту и при возвращении на экран. Кнопка со стрелкой не запускает сборщик, а перечитывает сохранённую сводку. Для нового сбора вне расписания используйте Запустить в редакторе автоматизации.

Если сбор не состоялся, прежний снимок сохраняется. Через 60 минут без успешного сбора появляется Данные устарели, положительный статус скрывается. Ошибка чтения тоже не превращается в нулевые показатели: последняя загруженная сводка помечается как неподтверждённая.

Если токен истёк или отозван, обновите его в секретных переменных и повторите проверочный и обычный запуск. При удалении начального артефакта сбор остановится: восстановление {} начнёт новую историю. Данные и токены другой компании использовать нельзя.

Границы и данные

Это оперативная сводка по задачам и инцидентам, а не финансовая аналитика, оценка работников или гарантия отсутствия проблем во всей компании. Чек-листы, визиты, выезды, продажи и рабочее время не входят в версию 1.0.0. Счётчики отражают момент сбора; разные источники читаются параллельно, общей транзакции между разделами нет. Если счётчики задач противоречат друг другу, снимок не сохраняется — повторите сбор.

В артефакте хранятся только ID компании, время и агрегированные счётчики; названия задач, персональные данные сотрудников и токены не сохраняются. HTTP-источник просрочек запрашивает одну запись для получения общего количества, но не переносит её содержание в сводку. Источник SLA использует всю историю создания инцидентов, чтобы учитывать открытые записи прошлых месяцев; на очень больших базах проверьте время работы сборщика перед включением расписания.

Установка и выключение виджета не изменяют задачи и инциденты, не уведомляют сотрудников и не удаляют историю. Для остановки сбора выключите автоматизацию. Данные остаются в артефакте до явного удаления администратором; общая история версий артефактов не ведётся.

Поддержка

По подключению и ключу активации обратитесь к продавцу @sync24 через контакты карточки. Не отправляйте ему токены. В обращении достаточно версии продукта, времени ошибки и текста ошибки без секретов.

Сторонние компоненты

Иконки Lucide распространяются по лицензии ISC; уведомление и условия включены в исходный код виджета и файл LICENSE-LUCIDE.txt.