Активация, выпуск и распространение
Документ описывает технические средства, с помощью которых предоставляется доступ к программе «Парсвайс», управляются права её использования, выпускаются и распространяются версии программы. Правообладатель программы — индивидуальный предприниматель Крылов Руслан Хуважиевич.
1. Лицензионные ключи и активация
Программа не использует лицензионные ключи, коды активации, файлы лицензий и привязку к оборудованию. Технических средств генерации, выпуска и проверки лицензионных ключей в программе нет, отдельной процедуры активации не требуется.
Доступ к программе предоставляется через учётные записи пользователей и участие в проектах. Проект — рабочее пространство организации в панели управления: база знаний, ассистент, команда, настройки и подписка.
Учётные записи и способы входа
Учётная запись создаётся при регистрации на странице https://admin.parsewise.ru/register. Адрес электронной почты подтверждается кодом из письма; до подтверждения работа с программой недоступна.
| Способ входа | Описание |
|---|---|
| Электронная почта и пароль | вход по адресу, подтверждённому при регистрации; восстановление пароля по ссылке из письма |
| Яндекс ID | вход через учётную запись Яндекса |
| VK ID | вход через учётную запись VK ID |
| Корпоративный вход (SSO) | вход через систему учётных записей организации по протоколу OpenID Connect, например Keycloak или ADFS. Подключение настраивает владелец или администратор проекта; при входе подключение определяется по адресу проекта или по домену адреса электронной почты пользователя. При первом входе учётная запись создаётся автоматически |
Роли в проекте
Создатель проекта становится его владельцем. Остальные пользователи получают доступ к проекту по приглашению на адрес электронной почты или по ссылке-приглашению с назначенной ролью.
| Роль | Права |
|---|---|
| Владелец | права администратора, передача владения проектом другому участнику, удаление проекта |
| Администратор | управление участниками и приглашениями, подпиской, API-токенами и общими настройками проекта |
| Редактор | работа с базой знаний и чатами: создание, импорт и изменение товаров, профилей и файлов; настройка ассистента — персона, скилы, коннекторы, виджет |
| Наблюдатель | главная, база знаний и чаты; база знаний доступна только для просмотра |
| Гость | только собственные чаты с ассистентом; приглашается по ссылке или QR-коду для гостей |
Предоставление и прекращение доступа
| Действие | Кто выполняет | Как |
|---|---|---|
| Предоставить доступ сотруднику | владелец или администратор проекта | приглашение на адрес электронной почты или ссылка-приглашение с ролью |
| Изменить права | владелец или администратор проекта | смена роли участника |
| Прекратить доступ | владелец или администратор проекта | удаление участника из проекта, отмена неиспользованного приглашения или ссылки |
| Предоставить доступ внешней системе | владелец или администратор проекта | выпуск API-токена с ролью «Наблюдатель» (чат и поиск) или «Редактор» (дополнительно управление товарами). Токен показывается один раз при создании, программа хранит только его хеш SHA-256 |
| Прекратить доступ внешней системы | владелец или администратор проекта | удаление API-токена |
| Прекратить доступ через корпоративный вход | организация заказчика | блокировка учётной записи в системе учётных записей организации; без неё вход через SSO невозможен |
Виджет на сайте заказчика
Виджет подключается к странице сайта или личного кабинета кодом встраивания, который панель управления формирует на странице «Установка» проекта. Код содержит идентификатор проекта и адрес файла виджета:
<script>
window.ParsewiseConfig = { shopId: "ИДЕНТИФИКАТОР_ПРОЕКТА" };
</script>
<script async src="https://releases.parsewise.ru/widget/latest/widget.iife.js"></script>
Идентификатор проекта не является ключом: настройки виджета загружаются с сервера программы, и доступ к виджету регулируется в настройках проекта.
| Настройка | Действие |
|---|---|
| Доверенные домены | виджет работает только на страницах перечисленных доменов; проверку выполняет сервер программы |
| Доступ к чату | «всем посетителям» или «только авторизованным пользователям»; во втором случае запросы без подтверждённой личности отклоняются сервером |
| Подтверждение личности | токеном, подписанным секретом проекта на стороне сайта заказчика, либо через корпоративный вход (SSO) организации заказчика |
2. Управление правами использования
Вместо лицензионных ключей объём прав использования задаётся параметрами подписки проекта или договора с организацией и контролируется сервером программы.
Подписка проекта
| Тариф | Единица | Как задаётся объём |
|---|---|---|
| «Команда» | место — участник проекта любой роли | количество мест выбирается при оформлении подписки, не меньше минимального пакета; при продлении оплачивается фактическое число участников проекта |
| «Треды» | тред — завершённая ветка диалога с ответом ассистента | объём тредов в месяц выбирается при оформлении подписки, не меньше минимального объёма |
Подписка оформляется владельцем или администратором проекта в панели управления. Оплата принимается через платёжный сервис Robokassa; после подтверждения оплаты сервер программы применяет оплаченный объём к подписке проекта. Продление выполняется повторяющимся платежом. Если подписка не продлена после исчерпания попыток списания, проект переводится на бесплатный тариф.
Без подписки проект работает на бесплатном тарифе: до 3 участников и до 50 тредов в месяц.
Ограничения использования
| Ограничение | Назначение | Как действует |
|---|---|---|
| Лимит участников бесплатного тарифа | предел для проекта без подписки | приглашение участника сверх лимита отклоняется сервером |
| Месячный лимит тредов | предел расходов на треды сверх оплаченного объёма; по умолчанию 10 000 тредов в месяц, изменяется владельцем или администратором | после достижения лимита новый тред не начинается и ассистент не отвечает на сообщение, открывающее тред; начатые треды завершаются. Обращения участников проекта не тарифицируются и не ограничиваются |
| Лимит мест | предел, до которого проект может расти по числу оплачиваемых мест; по умолчанию 200, изменяется владельцем или администратором | задаётся в настройках подписки тарифа «Команда» |
Счётчики тредов ведутся по календарным месяцам и обнуляются в начале месяца.
Договор с организацией
Для организаций, объединяющих несколько проектов, условия фиксируются договором и заносятся правообладателем в программу как договор организации. Договор содержит:
| Параметр | Содержание |
|---|---|
| Пул мест | общее число мест на все проекты организации; человек, состоящий в нескольких проектах, занимает одно место |
| Пул тредов | общий месячный объём тредов на все проекты организации |
| Проекты | проекты, подключённые к договору; новые проекты указанных учётных записей подключаются автоматически |
| Индивидуальные условия | цены и реквизиты договора |
| Срок действия | дата окончания и льготный период после неё, по умолчанию 14 дней |
| Статус | действует или приостановлен |
Сервер программы не допускает добавления участников сверх пула мест. По окончании срока действия и льготного периода, а также при приостановке договора пул перестаёт распространяться на проекты организации.
3. Выпуск версий
| Компонент | Как выпускается | Где размещается |
|---|---|---|
| Сервер программного интерфейса, обработчик очередей и планировщик задач | сборка образа контейнера скриптом деплоя из репозитория, загрузка образа в реестр, перезапуск развёртываний и ожидание готовности новых экземпляров | реестр образов правообладателя в Yandex Container Registry; кластер Yandex Managed Service for Kubernetes |
| Панель управления | сборка скриптом деплоя, упаковка в образ контейнера, загрузка в реестр, перезапуск развёртывания | то же |
| Сервис векторизации | образ с моделью векторизации внутри; замена образа изменением манифеста Kubernetes по контрольной сумме образа | то же |
| Виджет | команда npm version: установка пакетов строго по файлу блокировки версий, сборка бандла, фиксация номера версии тегом в системе контроля версий, размещение файлов | Yandex Object Storage, раздаётся по адресу releases.parsewise.ru |
Сервер программного интерфейса и панель управления выкатываются из основной ветки; выкатка определяется коммитом, из которого собран образ, и контрольной суммой образа в реестре. Виджет выпускается версиями по семантической нумерации, текущая версия — 3.12.5.
Каждая версия виджета размещается по собственному адресу, содержащему номер версии, например https://releases.parsewise.ru/widget/3.12.5/widget.iife.js; содержимое по этому адресу не меняется и кешируется как неизменяемое. Адрес https://releases.parsewise.ru/widget/latest/widget.iife.js указывает на последнюю выпущенную версию и кешируется на 5 минут. Вместе с файлами публикуется манифест выпуска с номером версии, датой и адресами файлов.
Порядок разработки, тестирования и отката описан в документе Жизненный цикл.
4. Распространение
Облачный доступ
Основная форма распространения — доступ к облачной установке правообладателя, размещённой в Яндекс Облаке на территории Российской Федерации. Программа не устанавливается на компьютеры пользователей:
- сотрудники и администраторы работают в панели управления через браузер по адресу https://admin.parsewise.ru;
- посетители сайта заказчика работают с ассистентом через виджет, подключённый кодом встраивания;
- внешние системы обращаются к программному интерфейсу по API-токену проекта.
Обновления облачной установки выкатывает правообладатель; действий со стороны заказчика не требуется.
Установка в инфраструктуре заказчика
Для установки в инфраструктуре заказчика предназначен отдельный реестр поставки правообладателя в Yandex Container Registry — cr.yandex/crpvecc8bq5a2db1a5r3. Он не совпадает с реестром облачной установки.
| Правило | Содержание |
|---|---|
| Состав | в реестр поставки помещаются только образы, входящие в комплект поставки: сервер программного интерфейса, панель управления, сервис векторизации |
| Версии | образы размещаются с номерами версий; теги выпущенных версий не перезаписываются |
| Предоставление доступа | для каждого заказчика создаётся отдельный сервисный аккаунт с ролью container-registry.images.puller, назначенной на репозитории образов его поставки, а не на реестр целиком. Роль даёт право только на загрузку образов |
| Прекращение доступа | отзыв роли или удаление сервисного аккаунта заказчика; доступ других заказчиков и облачная установка при этом не затрагиваются |
| Передача без доступа к реестру | образы могут быть переданы архивом OCI для загрузки в реестр заказчика |
Установленная в инфраструктуре заказчика программа не обращается к правообладателю за проверкой прав и не получает обновлений автоматически: новую версию образов устанавливает заказчик по своему решению. Порядок установки описан в документе Установка и эксплуатация.
Виджет
Файлы виджета распространяются публично по адресу releases.parsewise.ru и загружаются браузером посетителя при открытии страницы с кодом встраивания. Сайт может подключить адрес latest и получать новые версии автоматически в течение 5 минут после выпуска либо адрес конкретной версии и оставаться на ней до смены адреса. При установке в инфраструктуре заказчика файлы виджета размещаются на его статическом сервере или в его объектном хранилище.
5. Контакты
- Правообладатель: индивидуальный предприниматель Крылов Руслан Хуважиевич
- ИНН: 772373909220
- ОГРНИП: 322774600593457
- Приобретение и лицензирование: sales@parsewise.ru
- Техническая поддержка: help@parsewise.ru
Проверьте на своих данных
Загрузите свои документы и каталог — и задайте ассистенту те вопросы, которые задают вам. Это единственная проверка, которая что-то значит.
