Документация · версия 1.0.0

ОПИСАНИЕ АРХИТЕКТУРЫ ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ

Наименование программы«Тембр»
Версия1.0.0
ПравообладательОбщество с ограниченной ответственностью «Веб 3.0» (ООО «Веб 3.0»), ИНН 5027321593, ОГРН 1235000127218
Дата документа17.10.2026

1. Общая архитектура

1.1. Программа построена как локальный веб-сервис: серверная часть на языке Python выполняет приём записей, обработку, хранение и разграничение доступа; клиентская часть — веб-интерфейс (HTML, CSS, JavaScript), отдаваемый тем же сервисом и работающий в браузере пользователя или в отдельном окне программы.

1.2. Архитектура разделена на слои по правилу: ядро обработки не содержит интерфейса, интерфейс не содержит обработки. Ядро не зависит от протокола HTTP и может вызываться из сервиса, из командной строки и из автоматических тестов.

1.3. Все компоненты, включая нейросетевые модели, выполняются на оборудовании заказчика. Облачных сервисов и сетей доставки контента архитектура не предусматривает. Единственный внешний сервер — сервер лицензий правообладателя в Российской Федерации, к которому Программа обращается только для активации и проверки лицензии и которому не передаются записи и тексты (раздел 11); корпоративная поставка (тариф «Enterprise», для устройств без интернета) работает без ключа, и обращений к нему нет.

2. Состав компонентов и модулей

2.1. Серверная часть (Python)

модульназначение
transcriber_core.pyЯдро обработки. Чтение звука из файла любого поддерживаемого формата, предварительная обработка звука, вызов модели распознавания, вызов модели разметки говорящих, сопоставление текста и говорящих, сборка реплик, устранение артефактов, словарь замен, хранение и поиск расшифровок, миграция формата хранения, управление видеопамятью, выбор вычислительного движка и устройства, автономный режим. Содержит номер версии (VERSION) и наименование правообладателя (RIGHTS_HOLDER) — единственное место их определения для всей поставки.
transcriber_web.pyВеб-сервис (FastAPI, uvicorn). Программный интерфейс (HTTP API) и страницы интерфейса, потоковый приём файлов, единая проверка входа и прав доступа, работа по HTTPS и переадресация, выгрузка результатов, ключи командной строки (--version, --host, --port, --cert, --key, --redirect-from, --reset-admin, --no-browser). Обработки не содержит.
transcriber_jobs.pyОчередь задач. Постановка задачи, очередь с оценкой ожидания, выполнение в фоновом потоке по одной задаче, отмена, «сохранить только текст», рассылка событий о ходе обработки подписчикам, привязка задачи к автору.
transcriber_users.pyУчётные записи. Пользователи, роли, хранение паролей (PBKDF2), проверка пароля, выдача и закрытие сеансов, восстановление доступа администратора.
transcriber_schedule.pyРасписание работы. Рабочие дни и часы приёма задач (единственная точка проверки — can_start()), журнал нагрузки и сводная статистика.
transcriber_platform.pyПлатформенная прослойка. Различия между Linux, Windows и macOS: системное окно выбора файла, описание вычислительного устройства, удержание машины от перехода в сон на время расчёта, сохранение файла в папку «Загрузки».
transcriber_export.pyВыгрузка. Формирование документов DOCX и субтитров SRT собственным кодом на стандартной библиотеке Python, без сторонних библиотек.
transcriber_window.pyНастольное окно (macOS): запуск того же веб-сервиса во внутреннем потоке и показ интерфейса в отдельном окне вместо вкладки браузера.
transcriber_license.pyЛицензирование. Приведение ключа к виду TMBR-XXXX-XXXX-XXXX-XXXX, отпечаток устройства (хэш), запросы к серверу лицензий (активация, проверка, отвязка), хранение и проверка жетона лицензии, распознавание корпоративной поставки (файл поставка.json, ключ и проверка через сеть не требуются), приём файла лицензии по коду устройства (запасной путь), единственная точка проверки права запуска расшифровки (разрешён_расчёт()), предел числа учётных записей на серверной установке (раздел 11).
transcriber_ed25519.pyЭлектронная подпись Ed25519 (проверка подписи жетона) собственным кодом на стандартной библиотеке Python, без сторонних криптографических библиотек.

2.2. Клиентская часть (каталог web/)

файлназначение
index.html, app.jsсписок расшифровок, поиск, фильтры
new.html, new.jsновая расшифровка: выбор или отправка файла, параметры, экран хода обработки, очередь
record.html, record.jsстраница расшифровки: реплики, переименование говорящих, проигрыватель, пометка чисел, выгрузка
login.html, login.jsвход; заведение первого администратора
users.html, users.jsуправление учётными записями и расписанием, сводка нагрузки (администратор)
about.html, about.js«О программе»: версия, правообладатель, модели, лицензии
license.html, license.js«Лицензия»: состояние и срок лицензии, ввод ключа, проверка, отвязка компьютера, код устройства и загрузка файла лицензии; в корпоративной поставке — наименование заказчика
extract.jsизвлечение звуковой дорожки из видео в браузере: собственный разбор контейнера MP4/MOV, декодирование средствами браузера (WebCodecs), пересчёт частоты дискретизации, формирование WAV 16 кГц моно
shell.jsобщий каркас страниц: боковая панель, мобильная вёрстка, сведения о месте расчёта
util.jsобщие функции: склонения, экранирование, подсветка, пометка чисел, поиск звучащей реплики
app.css, shell.cssстили интерфейса (светлая и тёмная темы, узкий экран)
brand/тембр/оформление программы: цветовые токены, логотипы, значок
fonts/шрифты интерфейса (Unbounded, Golos Text, JetBrains Mono, лицензия SIL OFL 1.1) с текстами лицензий

Клиентская часть не использует внешних библиотек, менеджеров пакетов, сборщиков, внешних шрифтов и сетей доставки контента; все файлы отдаются самим сервисом.

2.3. Средства установки и сборки (каталог packaging/)

компонентназначение
build.pyсборка дистрибутивов с предварительными проверками (п. 10.7)
linux/УСТАНОВИТЬ.sh, linux/служба.shустановка на Linux и регистрация пользовательской службы systemd
linux/собрать-склад.shсборка офлайн-склада для Linux: интерпретатор Python, пакеты, модуль чтения звука с собственной LGPL-сборкой FFmpeg
windows/setup.bat, windows/setup_windows.py, windows/Тембр.iss, windows/подготовить-состав.pyустановка на Windows
mac/собрать-приложение.py, mac/собрать-ffmpeg.sh, mac/УСТАНОВИТЬ.commandсборка приложения macOS и собственной LGPL-сборки FFmpeg
принести-модели.py, принести-инструменты.pyподготовка весов моделей и инструмента установки Python к включению в дистрибутив
проверка-видеокарты.pyдиагностика вычислительного устройства на сервере
сертификат.pyподготовка сертификата для работы по HTTPS
СЕРВЕР.mdруководство администратора по развёртыванию сервера
лицензии/тексты лицензий сторонних компонентов, включаемые в дистрибутив

3. Схема взаимодействия

 Рабочие места пользователей                Сервер организации (или рабочая станция)
┌──────────────────────────┐            ┌───────────────────────────────────────────────┐
│ Браузер                  │  HTTP(S)   │ transcriber_web.py  (FastAPI / uvicorn)       │
│  web/*.html, *.js, *.css │◄──────────►│   проверка входа и прав (единая точка)        │
│  extract.js — звук из    │  локальная │   HTTP API, страницы, приём файлов            │
│  видео до отправки       │  сеть      ├───────────────┬───────────────┬───────────────┤
└──────────────────────────┘            │ transcriber_  │ transcriber_  │ transcriber_  │
                                        │ jobs.py       │ users.py      │ schedule.py   │
 (режим рабочего места: тот же          │ очередь       │ учётные записи│ расписание    │
  интерфейс в окне или браузере         ├───────────────┴───────────────┴───────────────┤
  на том же компьютере, 127.0.0.1)      │ transcriber_core.py — ядро обработки          │
                                        │ transcriber_export.py — DOCX, SRT             │
                                        ├───────────────────────────────────────────────┤
                                        │ transcriber_platform.py — ОС-зависимые функции│
                                        ├───────────────────────────────────────────────┤
                                        │ Модель распознавания   │ Модель разметки      │
                                        │ речи (Whisper large-v3)│ говорящих (pyannote) │
                                        │ локально, CPU / GPU    │ локально, CPU / GPU  │
                                        ├───────────────────────────────────────────────┤
                                        │ Локальный диск: ~/Transcriber                 │
                                        └───────────────────────────────────────────────┘

Взаимодействие клиента и сервера:

  1. Пользователь проходит вход; сервис выдаёт сеансовый ключ в cookie.
  2. Файл записи передаётся потоком (POST /api/upload) либо, в режиме рабочего места, выбирается системным окном (POST /api/pick-file).
  3. Запрос на обработку (POST /api/transcribe) ставит задачу в очередь и сразу возвращает её номер; HTTP-соединение на время расчёта не удерживается.
  4. Ход обработки доставляется потоком событий (GET /api/job/events, Server-Sent Events); текущее состояние задачи запрашивается отдельно (GET /api/job), что позволяет восстановить экран после обрыва связи.
  5. Результат доступен через GET /api/record/{id}, выгрузка — через GET /api/record/{id}/download?format=txt|docx|srt, звук для проигрывателя — через GET /api/record/{id}/audio (с поддержкой частичной загрузки).
  6. Перед постановкой задачи (POST /api/transcribe) проверяется лицензия — по сохранённому жетону, без обращения к сети; при недействующей лицензии задача не ставится, а пользователь получает объяснение. Состояние лицензии и действия с ней — GET /api/license, POST /api/license/activate, …/refresh, …/deactivate, …/import.

Связь с сервером лицензий правообладателя (раздел 11):

 Сервер организации / рабочая станция               Сервер лицензий ООО «Веб 3.0»
┌───────────────────────────────────┐   HTTPS     ┌──────────────────────────────────┐
│ transcriber_license.py            │────────────►│ https://tembr.web3-0.ru/api/lic  │
│  ключ, хэш отпечатка, имя         │ activate /  │  VPS 104.128.134.108,            │
│  компьютера, версия               │ check /     │  ЦОД DataPro, Москва, РФ         │
│                                   │ deactivate  │  учёт ключей, мест, активаций    │
│  жетон ◄── подпись Ed25519 ───────│◄────────────│  закрытый ключ подписи Ed25519   │
│  проверка открытым ключом         │             └──────────────────────────────────┘
│  ~/Transcriber/лицензия.json      │   записи, тексты, имена говорящих
└───────────────────────────────────┘   не передаются

4. Конвейер обработки записи

№этапреализация
1Чтение звука из файла любого поддерживаемого формата, приведение к моно 16 кГцядро, библиотека PyAV (FFmpeg)
2Сохранение копии исходного звука для проигрывателя (AAC 64 кбит/с)ядро
3Предварительная обработка: фильтр низких частот 80 Гц, выравнивание громкости; потоковая, блоками по минутеядро, SciPy
4Распознавание речи → сегменты текста с временными меткамимодель Whisper large-v3; движок faster-whisper (Linux, Windows) или mlx-whisper (macOS)
5Промежуточное сохранение распознанного текстаядро
6Выгрузка модели распознавания из памяти видеокартыядро
7Разметка говорящих («кто когда говорил»)модель pyannote speaker-diarization-community-1, библиотека pyannote.audio
8Нормализация сегментов, сопоставление текста и говорящихядро
9Сборка реплик, устранение артефактов распознавания, применение словаря заменядро
10Сохранение расшифровки, освобождение видеопамятиядро

Вычислительный движок распознавания выбирается по платформе в одной точке (select_engine()): faster-whisper — Linux, Windows и прочие платформы; mlx-whisper — macOS. Устройство для разметки говорящих выбирается в порядке: видеокарта NVIDIA (CUDA) → графический процессор Apple → центральный процессор. Штатный режим — центральный процессор; при наличии у заказчика видеокарты NVIDIA с установленными заказчиком драйвером и библиотеками CUDA она используется автоматически. Драйвер NVIDIA и CUDA в поставку не входят. На Linux из офлайн-склада устанавливается сборка PyTorch для центрального процессора.

5. Хранение данных

5.1. Система управления базами данных не используется. Все данные хранятся в файлах в каталоге ~/Transcriber учётной записи, от имени которой работает сервис.

путьсодержимое
history/*.jsonрасшифровки: реплики, имена говорящих, метаданные, автор (одна запись — один файл)
audio/*.m4aкопии звука для проигрывателя; удаляются вместе с расшифровкой
incoming/принятые по сети файлы; удаляются после завершения задачи при любом исходе
uploads/временные файлы выгрузки
users.jsonучётные записи, роли, свёртки паролей
sessions.jsonдействующие сеансы
расписание.jsonрасписание работы
нагрузка.jsonlжурнал нагрузки и приёма файлов
словарь.jsonсловарь замен терминов
лицензия.jsonжетон лицензии и дата последней проверки (права 600)
migration.logжурнал миграций формата и событий восстановления доступа администратора

5.2. Формат записи расшифровки версионирован (текущая версия формата — 2). При обновлении Программы миграция выполняется автоматически по принципу «всё или ничего» с предварительным резервным копированием истории.

5.3. Чтение истории выполняется через единственную функцию с кэшем в памяти; файл перечитывается только при его изменении.

5.4. Веса моделей хранятся в каталоге models/ рядом с программой (поставляются в дистрибутиве).

5.5. Резервное копирование данных сводится к копированию каталога ~/Transcriber.

6. Безопасность и разграничение доступа

мерареализация
хранение паролейPBKDF2-HMAC-SHA256, 240 000 итераций, индивидуальная соль; сравнение за постоянное время (hmac.compare_digest); стандартная библиотека Python
паролиминимум 6 символов; смена пароля закрывает все сеансы пользователя
сеансыслучайный ключ в cookie с атрибутами HttpOnly и SameSite=Lax; срок действия 14 дней
проверка входав одной точке — промежуточном обработчике (middleware) всех запросов
ролидве: пользователь, администратор
изоляция данныхпользователь получает только свои расшифровки и задачи; запрос к чужому объекту отвечает так же, как к несуществующему (404)
остановка чужой задачитолько администратором и с отдельным подтверждением
открытие в сетьпо умолчанию сервис принимает соединения только с 127.0.0.1; сетевой режим включается явно и требует наличия учётных записей; первый администратор при сетевом запуске заводится по одноразовому коду, выводимому в консоль сервера
восстановление доступа--reset-admin с консоли сервера, запись события в журнал
шифрование каналаHTTPS с сертификатом организации (--cert, --key), переадресация с HTTP (--redirect-from)
входные данныепроверка идентификаторов записей (запрет выхода за каталог истории), очистка имён файлов, проверка размера файла по заголовку и по ходу приёма, проверка свободного места до приёма; удаление принятых файлов только из собственного каталога
запись на диск по запросу клиентасохранение файла в «Загрузки» доступно только в режиме настольного окна
лицензияжетон подписан закрытым ключом правообладателя (Ed25519) и проверяется открытым ключом, встроенным в Программу; привязан к отпечатку устройства; защита от перевода часов назад; действия с лицензией на серверной установке — только администратор

Внешние службы аутентификации (SSO, OAuth и т. п.) не используются.

7. Сетевое взаимодействие

7.1. Входящие соединения: HTTP или HTTPS на порт сервиса (по умолчанию 7870, задаётся ключом --port), а также порт переадресации при его включении.

7.2. Исходящие соединения при обработке записей отсутствуют. Единственное исходящее соединение Программы — HTTPS-запрос к серверу лицензий правообладателя https://tembr.web3-0.ru/api/lic (Российская Федерация) при активации, раз в сутки для проверки и при отвязке компьютера; содержание запроса — раздел 11. В корпоративной поставке (Enterprise) и этого соединения нет. Отсутствие прочих соединений обеспечивается:

  • веса моделей поставляются в дистрибутиве; при наличии полного комплекта моделей Программа до загрузки сторонних библиотек устанавливает режим без обращений к сети (HF_HUB_OFFLINE, TRANSFORMERS_OFFLINE);
  • телеметрия сторонней библиотеки разметки говорящих отключена в коде до её загрузки (PYANNOTE_METRICS_ENABLED=false);
  • служба на Linux при наличии весов в дистрибутиве запускается с TRANSCRIBER_OFFLINE=1;
  • в Программе нет проверки обновлений, сбора статистики, отправки отчётов об ошибках, обращений к сервисам аналитики;
  • интерфейс не подключает внешних скриптов, стилей и шрифтов.

7.3. Как проверено.

проверкаспособрезультат
полный цикл обработки записи (чтение, распознавание, разметка говорящих, сохранение)перехват всех исходящих соединений (подмена socket.connect) на реальном расчёте0 обращений во внешнюю сеть
приложение macOSзапуск после переноса в другое место, с пустым домашним каталогом и закрытой сетьюмодели найдены в составе приложения, интерфейс работает, 0 обращений
отключение телеметрииавтоматический тест (НичегоНаружу) при каждом прогоне тестов—
отсутствие внешних ресурсов в интерфейсеавтоматический тест (БезИнтернета) по всем файлам web/—
установка и работа на Astra Linux SE 1.8 и РЕД ОС без сети13.10.2026, РЕД ОС 7.3.6 и Astra Linux SE 1.8.2 на облачных серверах Рег.облака; сеть отключена на уровне ядра (unshare -n — у процесса нет сетевых интерфейсов); установка из архива и расшифровка записи 41,0 с (large-v3, разметка говорящих, процессор)установка — 71 с (РЕД ОС) и 34 с (Astra), расшифровка — 104,3 с и 105,5 с; результат на обеих ОС совпал слово в слово; веса моделей — из дистрибутива
соединения версии с лицензированиемкод и автотесты: единственный адрес в коде — сервер лицензий (тест test_в_коде_нет_чужих_адресов); тест границы данных проверяет состав запроса; расчёт — замер 13.10.2026 на РЕД ОС и Astra при полностью отключённой сети (unshare -n)проверка лицензии обращается только к tembr.web3-0.ru и передаёт только ключ, хэш отпечатка, имя компьютера и версию; при расчёте обращений нет

7.4. Связь сервера с рабочими местами — только по локальной сети организации. Для проверки лицензии серверу (рабочей станции) нужен исходящий доступ по HTTPS к tembr.web3-0.ru хотя бы раз в 14 дней; корпоративной поставке (Enterprise) не нужен.

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

8.1. Сторонние компоненты используются на условиях свободных (открытых) лицензий, допускающих коммерческое использование и распространение; лицензионные платежи иностранным правообладателям отсутствуют. Полный перечень с версиями и лицензиями приведён в отдельном документе комплекта «Перечень сторонних компонентов» (файл «02-состав-и-лицензии», в заявке — «Иные документы»).

8.2. Основные компоненты:

компонентрольлицензия
модель Whisper large-v3 (OpenAI) в конверсиях Systran/faster-whisper-large-v3 и mlx-community/whisper-large-v3-mlxраспознавание речиисходная модель — Apache-2.0, конверсии — MIT
модель pyannote/speaker-diarization-community-1разметка говорящихCC-BY-4.0 (авторство указано в дистрибутиве и на странице «О программе»)
faster-whisper, mlx-whisper, pyannote.audioзапуск моделейMIT
PyTorchсреда выполнения моделейBSD
FastAPI, uvicornвеб-сервисMIT, BSD
NumPy, SciPyвычисления, обработка сигналаBSD
PyAV + FFmpegчтение аудио и видеоBSD-3 (PyAV); FFmpeg — собственная сборка без GPL-компонентов, LGPL-2.1 (macOS, офлайн-склад Linux), системный FFmpeg (Linux без склада), LGPL-сборка (Windows)
шрифты Unbounded, Golos Text, JetBrains MonoинтерфейсSIL OFL 1.1

8.3. Собственная разработка правообладателя — все модули и файлы, перечисленные в разделе 2: ядро обработки и конвейер, веб-сервис, очередь, учётные записи и разграничение доступа, расписание, выгрузка, клиентский интерфейс, извлечение звука в браузере, лицензирование и реализация подписи Ed25519, средства установки и сборки. Модели и перечисленные в п. 8.2 библиотеки собственной разработкой не являются; обучение и дообучение моделей правообладателем не выполнялось.

9. Технологический стек

уровеньтехнология
язык серверной частиPython 3.12 (интерпретатор поставляется в дистрибутиве; поддерживаемый диапазон 3.10–3.13)
веб-сервисFastAPI, uvicorn (ASGI)
клиентская частьHTML, CSS, JavaScript без внешних зависимостей, сборщиков и менеджеров пакетов
нейросетевые вычисленияPyTorch; CTranslate2 (через faster-whisper); MLX (macOS)
хранениефайлы JSON на локальном диске
службаsystemd (пользовательская служба) — Linux
автоматические тестыстандартный unittest Python; поведение клиентского кода — в Node.js (только при разработке, в поставку не входит)

10. Развёртывание

10.1. Состав дистрибутива

Дистрибутив поставляется архивом tembr-<версия>-<платформа>.zip (tembr-1.0.0-linux.zip, tembr-1.0.0-windows-x64.zip, tembr-1.0.0-macos-arm64.zip); внутри — каталог tembr/ с модулями программы, каталогом web/, установщиком, весами моделей (models/), текстами лицензий и файлом с указанием авторства моделей. Для macOS дополнительно собирается приложение Тембр.app (образ Тембр.dmg), для Windows — мастер установки.

10.2. Linux (Astra Linux SE 1.8, РЕД ОС 7.3/8 — основные серверные ОС)

  1. Распаковка архива в каталог пользователя и запуск bash УСТАНОВИТЬ.sh от имени обычного пользователя (без прав администратора).
  2. При наличии в архиве каталога склад/ (офлайн-склад) и архитектуре x86-64 установка выполняется без доступа к сети: интерпретатор Python, все пакеты (PyTorch — сборка для центрального процессора) и модуль чтения звука с собственной LGPL-сборкой FFmpeg берутся из архива; заголовки FFmpeg и компилятор не требуются.
  3. Без склада установщик загружает Python и пакеты из сети и собирает модуль чтения звука против системного FFmpeg.
  4. Регистрируется пользовательская служба systemd: автозапуск, перезапуск при сбое (не более 5 попыток в минуту), время на корректную остановку — 2 минуты.
  5. С правами администратора однократно выполняется только loginctl enable-linger <пользователь> (запуск службы без входа пользователя в систему); для ускорения на видеокарте — установка заказчиком драйвера NVIDIA и последующая установка сборки PyTorch с поддержкой CUDA.
  6. Результаты проверки установки на Astra Linux SE 1.8 и РЕД ОС (13.10.2026): установка из архива со складом без сети от обычного пользователя выполнена на РЕД ОС 7.3.6 за 71 с и на Astra Linux SE 1.8.2 за 34 с; служба systemd ставится и запускается (Astra), веб-интерфейс работает. При 4 ГБ ОЗУ без подкачки расчёт завершается ядром по нехватке памяти — минимум 8 ГБ ОЗУ.

10.3. Windows 10/11 (дополнительная ОС)

Мастер установки в каталог пользователя без прав администратора либо установщик setup.bat. Удаление программы не затрагивает данные пользователя.

10.4. macOS 13+ на Apple Silicon (дополнительная ОС)

Приложение Тембр.app со встроенным интерпретатором Python, библиотеками и весами моделей; установка перетаскиванием в «Программы».

10.5. Режимы запуска

  • рабочее место — сервис слушает 127.0.0.1, интерфейс в окне или браузере;
  • сервер организации — запуск с --host 0.0.0.0 (только после заведения администратора), рекомендуется HTTPS (--cert, --key).

10.6. Обновление

Распаковка архива новой версии поверх каталога tembr/; данные пользователей в ~/Transcriber не затрагиваются; формат истории мигрируется автоматически.

10.7. Проверки при сборке дистрибутива

Сборщик packaging/build.py перед сборкой выполняет проверки и при любой неудаче архив не собирает: наличие всех файлов приложения; совпадение номера версии в ядре и в описании мастера установки Windows; отсутствие в ядре зависимостей интерфейса; состав пакетов установщика macOS; кодировки командных файлов Windows; допустимый диапазон версий Python; проверка ядра установщиками; синтаксический разбор каждого файла JavaScript; согласованность оформления. После сборки архив перечитывается (состав, права на исполнение, целостность). Сборка отказывается формировать архив весов без текстов лицензий и описания каждой модели.

11. Лицензирование и сервер лицензий

11.1. Назначение. Механики две.

  • Обычная поставка (тарифы «Личный» и «Команда»): право использования подтверждается лицензионным ключом вида TMBR-XXXX-XXXX-XXXX-XXXX. Ключ определяет тариф, число мест и срок лицензии (один год, продление тем же ключом). Место — один компьютер либо одна учётная запись на серверной установке; серверная установка занимает все места ключа, и учётных записей на ней можно завести не больше числа мест.
  • Корпоративная поставка (тариф «Enterprise», только по договору): дистрибутив собирается для конкретного заказчика (packaging/build.py --enterprise "…"), в его состав входит файл поставка.json с наименованием заказчика. Функция edition() модуля transcriber_license.py читает этот файл; при его наличии лицензия не требуется (required() — ложь), ключ не запрашивается, к серверу лицензий Программа не обращается. Наименование заказчика показывается на страницах «Лицензия» и «О программе».

11.2. Компоненты.

сторонакомпонентназначение
Программаtranscriber_license.pyключ, отпечаток устройства, запросы к серверу лицензий, хранение и проверка жетона, распознавание корпоративной поставки, приём файла лицензии по коду устройства, проверка права запуска расшифровки
правообладательpackaging/build.py --enterpriseсборка корпоративной поставки с файлом поставка.json
Программаtranscriber_ed25519.pyпроверка подписи Ed25519 собственным кодом
Программаweb/license.html, web/license.js; /api/license… в transcriber_web.pyстраница «Лицензия» и её программный интерфейс
Программаоткрытый ключ подписивстроен в transcriber_license.py
правообладательсервер лицензий https://tembr.web3-0.ru/api/licучёт ключей, мест и активаций; выпуск подписанных жетонов
правообладательзакрытый ключ подписи Ed25519подпись жетонов; хранится у ООО «Веб 3.0» на сервере лицензий в РФ и у генерального директора (копия на компьютере руководителя в РФ)

Состав сервера лицензий: виртуальный сервер (VPS) 104.128.134.108 в дата-центре DataPro (Москва), ОС Debian 13; веб-сервер Caddy (Apache-2.0) с сертификатом HTTPS Let’s Encrypt; сервис лицензий и оплаты — собственная программа ООО «Веб 3.0» на стандартной библиотеке Python 3 без сторонних пакетов; база ключей и активаций — SQLite. Сертификат HTTPS защищает только канал связи; подлинность жетонов обеспечивается подписью Ed25519 и от сертификата не зависит. Ключ после оплаты выпускается сервисом автоматически по уведомлению Робокассы и отправляется покупателю письмом с адреса veb3.0@yandex.ru через почтовый сервис Яндекса (РФ). Резервная копия базы — ежедневно на сервере (/var/backups/tembr-pay, хранятся 14 последних), копия ключа подписи — у генерального директора; восстановление — развёртыванием скриптом на новом сервере, до 1 рабочего дня. Сервер лицензий — служебная программа ООО «Веб 3.0» для продаж; пользователям он не поставляется и в состав Программы не входит.

11.3. Отпечаток устройства — хэш SHA-256 от системного идентификатора компьютера (macOS — идентификатор платформы, Windows — идентификатор машины в реестре, Linux — /etc/machine-id; если идентификатор недоступен — имя компьютера). Сам идентификатор с компьютера не передаётся.

11.4. Протокол. POST https://tembr.web3-0.ru/api/lic/<действие>, тело запроса и ответ — JSON.

действиечто передаёт Программаответ сервера
activate — активацияключ, хэш отпечатка, имя компьютера, вид установки (рабочее место / сервер), версияжетон; отказ, если ключа нет, он не оплачен, срок истёк или нет свободных мест (со списком активаций)
check — ежедневная проверкаключ, хэш отпечатка, версияновый жетон; отказ, если компьютер отвязан
deactivate — отвязкаключ, хэш отпечаткаподтверждение; место освобождается

Записи, тексты расшифровок, имена говорящих, имена и пути файлов, учётные записи пользователей Программы не передаются.

11.5. Жетон лицензии — данные лицензии в JSON и подпись Ed25519 к ним (base64url(данные).base64url(подпись)). В данных: ключ, отпечаток устройства, вид установки, тариф, число мест, владелец, дата окончания лицензии, срок годности жетона без связи, дата выпуска. Программа считает жетон действующим, если подпись верна, отпечаток совпадает с этим компьютером, срок лицензии и срок годности жетона не прошли и часы компьютера не переведены назад более чем на сутки относительно последнего запуска. Жетон хранится в ~/Transcriber/лицензия.json.

11.6. Режимы.

  • Обычный: проверка раз в сутки при наличии сети, в фоне, без задержки интерфейса и расчёта; без сети жетон действует 14 дней. При попытке запустить расшифровку с устаревшим жетоном Программа сразу пробует обновить его.
  • Корпоративная поставка (Enterprise): ключа, жетона и обращений к сети нет; срок и число устройств определяются договором.
  • Запасной путь в рамках договора: для отдельного компьютера обычной поставки без сети правообладатель выпускает по коду устройства жетон на срок договора и передаёт файлом; файл загружается на странице «Лицензия», проверка та же, обращений к сети нет.

11.7. Окончание срока или отсутствие лицензии запрещает только постановку новых расшифровок (единственная точка проверки — разрешён_расчёт() перед POST /api/transcribe). Список расшифровок, страница записи, проигрыватель, копирование и выгрузка остаются доступны.

11.8. Размещение и контроль инфраструктуры. Сервер лицензий (там же сайт https://tembr.web3-0.ru) — виртуальный сервер (VPS) с IP-адресом 104.128.134.108 в дата-центре DataPro: г. Москва, ул. Авиамоторная, д. 69, Российская Федерация; геолокация IP-адреса — Россия, Москва (по данным ipinfo.io и ip-api.com, проверено 15.10.2026). Провайдер VPS — FirstByte (по договору-оферте — First Server S.L., иностранное юридическое лицо); он предоставляет только вычислительный ресурс (аренду виртуального сервера) и доступа к программному обеспечению и данным сервера лицензий не имеет. Root-доступ, операционная система, программа сервера лицензий, база ключей и активаций и закрытый ключ подписи — исключительно у ООО «Веб 3.0» (ИНН 5027321593); копия закрытого ключа — у генерального директора, гражданина РФ, на его компьютере в РФ. Иностранные сервисы, библиотеки и удостоверяющие центры для выпуска, распространения и проверки ключей не используются. Если экспертиза сочтёт размещение у провайдера — иностранного юридического лица недостаточным, ООО «Веб 3.0» переносит сервер лицензий к российскому провайдеру (например, RuVDS — ООО «МТ ФИНАНС», ЦОД в Москве) в течение одного рабочего дня: перенос автоматизирован скриптом, а Программа обращается к доменному имени tembr.web3-0.ru, поэтому изменений в Программе не требуется. Требование подп. «к» п. 5 Правил (ПП РФ № 1236) — см. письмо о технических средствах активации.