Документация · версия 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 │
└───────────────────────────────────────────────┘
Взаимодействие клиента и сервера:
- Пользователь проходит вход; сервис выдаёт сеансовый ключ в cookie.
- Файл записи передаётся потоком (
POST /api/upload) либо, в режиме рабочего места, выбирается системным окном (POST /api/pick-file). - Запрос на обработку (
POST /api/transcribe) ставит задачу в очередь и сразу возвращает её номер; HTTP-соединение на время расчёта не удерживается. - Ход обработки доставляется потоком событий (
GET /api/job/events, Server-Sent Events); текущее состояние задачи запрашивается отдельно (GET /api/job), что позволяет восстановить экран после обрыва связи. - Результат доступен через
GET /api/record/{id}, выгрузка — черезGET /api/record/{id}/download?format=txt|docx|srt, звук для проигрывателя — черезGET /api/record/{id}/audio(с поддержкой частичной загрузки). - Перед постановкой задачи (
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 — основные серверные ОС)
- Распаковка архива в каталог пользователя и запуск
bash УСТАНОВИТЬ.shот имени обычного пользователя (без прав администратора). - При наличии в архиве каталога
склад/(офлайн-склад) и архитектуре x86-64 установка выполняется без доступа к сети: интерпретатор Python, все пакеты (PyTorch — сборка для центрального процессора) и модуль чтения звука с собственной LGPL-сборкой FFmpeg берутся из архива; заголовки FFmpeg и компилятор не требуются. - Без склада установщик загружает Python и пакеты из сети и собирает модуль чтения звука против системного FFmpeg.
- Регистрируется пользовательская служба systemd: автозапуск, перезапуск при сбое (не более 5 попыток в минуту), время на корректную остановку — 2 минуты.
- С правами администратора однократно выполняется только
loginctl enable-linger <пользователь>(запуск службы без входа пользователя в систему); для ускорения на видеокарте — установка заказчиком драйвера NVIDIA и последующая установка сборки PyTorch с поддержкой CUDA. - Результаты проверки установки на 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) — см. письмо о технических средствах активации.