Граф Wiki

Лицензирование Smit Billing

Лицензирование СмИТ Биллинг
Содержание раздела

Система лицензирования СмИТ Биллинг состоит из двух компонентов: центрального сервера лицензий и раздела «Лицензия» в каждой инсталляции биллинга. Лицензия привязана к домену инсталляции и проверяется онлайн.

Архитектура: биллинг пингует https://license.billing.smit34.ru/api/verify/, передавая ключ и домен. Сервер возвращает данные лицензиата. Ответ кешируется на 1 час — кратковременная недоступность сервера не влияет на работу системы.
Раздел только для сотрудников

Для доступа введите пароль.

1. Сервер лицензий

Как лицензия попадает в биллинг

Лицензия не «зашита» в код: биллинг спрашивает у сервера лицензий, что клиенту разрешено, и включает ровно эти модули. Связь односторонняя — сервер лицензий сам в биллинг не ходит.

flowchart LR
    subgraph LS["Сервер лицензий"]
        CL["Клиент
и договор"] PL["Тариф:
состав модулей"] KEY["Лицензионный
ключ"] end subgraph B["Биллинг клиента"] CHK["Проверка ключа
раз в сутки"] CAT["Каталог модулей
кеш 6 часов"] GATE["Гейт модуля
is_enabled(код)"] UI["Разделы, вкладки,
задачи по расписанию"] end CL --> PL --> KEY KEY -->|"X-License-Key"| CHK CHK --> CAT --> GATE --> UI GATE -->|"не оплачен
или выключен"| OFF["Раздел скрыт"]
Две независимые причины, почему модуля нет на экране: он не входит в оплаченный тариф либо выключен оператором на странице «Модули». В карточке модуля видно и то, и другое.

Страница «Лицензия и расширения»: слева лицензия, расширения, документы и расход, справа ключ, поддержка, организации и персонал

Раздел «Настройки → Лицензия и расширения»: слева — что оплачено и чем занята инсталляция, справа — ключ, поддержка и доступ.

24модуля в каталоге
4входят во все тарифы
22виджета-плагина
6 чкеш каталога
ПараметрЗначение
URLhttps://license.billing.smit34.ru
Админкаhttps://license.billing.smit34.ru/admin/
Логинadmin / admin
Хостингсервер приложения — Docker (PostgreSQL + gunicorn:8878), Nginx + SSL
API info/api/info/
Список лицензий в Django admin

2. Выдача новой лицензии

Каталог модулей: карточки с обложкой, версией и тарифами, кнопка «Подробнее»

Каталог модулей в биллинге. «Подробнее» открывает карточку с возможностями, порядком работы, скриншотами и историей версий.

  1. Открыть Добавить лицензию
  2. Заполнить поля:
ПолеОписаниеПример
ДоменFQDN инсталляции (без https://)billing.клиент.ru
ОрганизацияПолное юридическое наименованиеООО СМИТ
ИНН10 или 12 цифр3461009378
КПП9 цифр346101001
Юридический адресПолный почтовый адрес400080, г. Волгоград, ул. 40 лет ВЛКСМ, д. 80, оф.1
Контактное лицоДолжность и ФИОГенеральный директор П.Е. Письменный
Действует доДата окончания или пустопусто = бессрочно
Макс. клиентовЛимит или 00 = без ограничений

После сохранения ключ генерируется автоматически в формате SMIT-XXXXXXXX-XXXXXXXX-XXXXXXXX и отображается в карточке с кнопкой «Копировать».

Карточка лицензии — лицензионный ключ

3. Активация лицензии в биллинге

Клиент открывает Настройки → Лицензия (/admin/settings/license/):

  1. Ввести полученный ключ в поле «Лицензионный ключ» (кнопка 👁 показывает введённое значение)
  2. URL сервера лицензий уже заполнен: https://license.billing.smit34.ru
  3. Нажать «Сохранить и проверить»
  4. Страница обновится — статус изменится на ✅ Лицензия действующая
Страница лицензии в настройках биллинга Активированная лицензия — данные лицензиата

4. Управление лицензиями

ДействиеКак выполнить
ДеактивироватьСнять галочку «Активна» в карточке или выбрать действие «Деактивировать» в списке
ПродлитьИзменить поле «Действует до» в карточке
Сменить ключДействие «Сгенерировать новый ключ» в списке (старый немедленно перестаёт работать)
Просмотр статистикиПоля «Последняя проверка» и «Проверок» — показывают активность инсталляции
Смена ключа через действие «Сгенерировать новый ключ» немедленно инвалидирует старый. Клиент не сможет войти в раздел «Лицензия» до ввода нового ключа. Заранее уведомите клиента.

4А. Каталог модулей: версии, changelog, зависимости

Сервер лицензий ведёт каталог из 20 модулей с версиями и историей изменений. У каждого модуля: категория, иконка, текущая версия, changelog по версиям и зависимости (например, «AI-ассистент» требует модуль «Поддержка», «Автообзвон» — «IP-телефонию»). Версия модуля показывается бейджем на карточках при настройке тарифа.

4Б. Виджеты-плагины

Каталог загружаемых виджетов для инсталляций: zip-пакет (widget.json + widget.js), точка монтирования (дашборд CRM, карточка сделки, дашборд биллинга, карточка клиента), категория (CRM, аналитика, финансы и др.), обложка и доступность по тарифам (пусто = всем). Пакет валидируется при загрузке: манифест, совпадение slug и версии, наличие entry-файла; целостность — SHA-256. Инсталляции получают каталог по лицензионному ключу: GET /api/gw/widgets/ (в ответе есть category/category_name для группировки).

5. API проверки лицензии

Лицензию можно проверить напрямую через браузер или curl:

GET https://license.billing.smit34.ru/api/verify/?key=SMIT-XXXX-XXXX-XXXX&domain=клиент.ru

Ответ при действующей лицензии:

{
  "valid": true,
  "status": "Действующая",
  "product": "Smit Billing",
  "company": "ООО СМИТ",
  "inn": "3461009378",
  "kpp": "346101001",
  "domain": "адрес вашей установки",
  "issued_at": "2026-04-08",
  "expires_at": null,
  "max_abonents": 0
}
API ответ сервера лицензий

expires_at: null означает бессрочную лицензию. При valid: false поле error содержит причину отказа.

6. Порядок поставки и учёта программного обеспечения

Процедура приобретения СмИТ Биллинг:

  1. Заявка — отправьте запрос на sales@smit34.ru с указанием домена инсталляции, планируемого числа клиентов и необходимых модулей.
  2. Коммерческое предложение — менеджер подготовит КП со стоимостью лицензии и ежегодной платой за поддержку.
  3. Договор и оплата — заключается договор поставки ПО. Оплата по безналичному расчёту.
  4. Поставка — после оплаты предоставляется: лицензионный ключ, Docker-образы, документация, доступ к обновлениям.
  5. Активация — клиент вводит ключ в Настройки → Лицензия. Система онлайн проверяет ключ на сервере лицензий.
  6. Учёт — лицензия регистрируется в реестре ПО. Поставляется акт приёма-передачи неисключительных прав.

7. Не проходит оплата