Документация · версия 1.0.0
ОПИСАНИЕ ПРОЦЕССОВ, ОБЕСПЕЧИВАЮЩИХ ПОДДЕРЖАНИЕ ЖИЗНЕННОГО ЦИКЛА ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ
| Наименование программы | «Тембр» |
| Версия | 1.0.0 |
| Правообладатель | Общество с ограниченной ответственностью «Веб 3.0» (ООО «Веб 3.0»), ИНН 5027321593, ОГРН 1235000127218 |
| Дата документа | 17.10.2026 |
1. Общие положения
1.1. Документ описывает процессы разработки, сборки, выпуска версий, технической поддержки, устранения неисправностей и модернизации программы «Тембр» (далее — Программа), а также сведения о персонале, обеспечивающем эти процессы.
1.2. Все процессы жизненного цикла Программы выполняются силами ООО «Веб 3.0» на территории Российской Федерации. Привлечение иностранных лиц к разработке, сопровождению и модернизации Программы не осуществляется.
2. Процесс разработки
2.1. Контроль версий
2.1.1. Исходный код Программы, средства сборки и установки, автоматические тесты и проектная документация ведутся в системе контроля версий Git. Изменения вносятся отдельными правками с описанием причины изменения. Рабочая проектная документация (устройство Программы, принятые технические решения и их обоснование, известные ограничения) обновляется по завершении каждого этапа работ.
2.1.2. Сторонние двоичные файлы (веса моделей, инструменты установки,
собранные пакеты) в репозиторий не помещаются: они подготавливаются
сценариями packaging/принести-модели.py, packaging/принести-инструменты.py,
packaging/linux/собрать-склад.sh с фиксацией состава и контрольных сумм
(SHA-256) и включаются только в дистрибутив.
2.2. Автоматическое тестирование
2.2.1. Программа покрыта автоматическими тестами на стандартной библиотеке
unittest языка Python. По состоянию на 07.10.2026 в репозитории
556 автоматических тестов в девяти модулях (подсчёт по числу тестовых
функций def test_ в tests/*.py):
| модуль тестов | число тестов | что проверяется |
|---|---|---|
test_core.py | 217 | ядро обработки: чтение звука, обработка, устранение артефактов, сборка реплик, выбор движка и устройства, автономный режим, отключение телеметрии |
test_frontend.py | 70 | клиентская часть: разбор каждого файла JavaScript, отсутствие внешних ресурсов, разметка, поведение кода интерфейса (исполняется в Node.js) |
test_jobs.py | 64 | очередь задач, четыре исхода обработки, освобождение ресурсов |
test_web.py | 63 | HTTP API, разграничение доступа (проверка всех адресов на отсутствие чужих данных), первый запуск, HTTPS и переадресация |
test_users.py | 62 | учётные записи, пароли, сеансы, роли |
test_packaging.py | 42 | установщики и сборка, в том числе запуск сценариев установки |
test_migration.py | 15 | миграция формата хранения и обратная совместимость |
test_docs.py | 12 | соответствие документации администратора коду |
test_export.py | 11 | выгрузка DOCX и SRT |
2.2.2. Тестами закрепляются также найденные и устранённые дефекты, чтобы исключить их повторное появление.
2.2.3. Выпуск версии допускается только при успешном прохождении всех автоматических тестов. Результат прогона тестов для версии 1.0.0 — 602 теста пройдены, 4 пропущены (проверки, требующие весов малых моделей или библиотеки cryptography на машине разработчика), 0 ошибок; 14.10.2026.
2.3. Сборка
2.3.1. Дистрибутивы собираются только сборщиком packaging/build.py;
ручная сборка архивов не допускается.
2.3.2. Перед сборкой выполняются обязательные проверки (при неудаче любой из них дистрибутив не собирается): наличие всех файлов приложения; совпадение номера версии в ядре и в мастере установки Windows; отсутствие в ядре зависимостей интерфейса; состав пакетов установщика; кодировки командных файлов; диапазон версий Python; синтаксический разбор каждого файла JavaScript; согласованность оформления. После сборки архив перечитывается и проверяется (состав, права на исполнение, целостность). Сборка не формирует архив без текстов лицензий и сведений об авторстве каждой модели; сборка приложения macOS прерывается при обнаружении в составе компонентов под лицензией GPL.
2.3.2а. Корпоративная поставка (тариф «Enterprise») собирается тем же
сборщиком с указанием наименования заказчика (build.py --enterprise "…"): в дистрибутив включается файл поставка.json с наименованием
заказчика, лицензионный ключ и проверка лицензии через интернет в такой
поставке не применяются. Корпоративная поставка выпускается только по
договору Enterprise и передаётся только этому заказчику.
2.3.3. Перед передачей дистрибутива заказчикам выполняется проверка установки из собранного архива на машине без ранее установленной Программы.
3. Хранение исходного кода и сборка на территории РФ
3.1. Исходный код Программы хранится, а сборка дистрибутивов выполняется на территории Российской Федерации.
3.2. Репозиторий исходного кода: закрытый репозиторий на российском
сервисе GitFlic (gitflic.ru, проект veb3/tembr, аккаунт ООО «Веб 3.0»),
серверы сервиса в Российской Федерации (по данным оператора — ООО «Ресолют», г. Москва). Рабочая копия —
на компьютере генерального директора в РФ. Резервные копии репозитория —
сам GitFlic и рабочая копия у генерального директора.
3.3. Место выполнения сборки дистрибутивов (всё — на территории РФ):
- дистрибутивы macOS и Linux — на компьютере генерального директора;
- офлайн-склад пакетов для Linux и FFmpeg для Linux — на облачном сервере Рег.облака (РЕД ОС 7.3, 13.10.2026);
- FFmpeg для macOS — на компьютере генерального директора;
- установщик Windows — на компьютере с Windows.
В комплект подачи входит дистрибутив Linux.
3.4. Доступ к репозиторию имеет только персонал ООО «Веб 3.0», указанный в разделе 9.
4. Выпуск версий и нумерация
4.1. Версии Программы нумеруются по схеме семантического версионирования
MAJOR.MINOR.PATCH:
MAJOR— изменения, нарушающие совместимость (формат данных без автоматической миграции, требования к окружению);MINOR— новые функции с сохранением совместимости;PATCH— исправление ошибок и уязвимостей.
4.2. Номер версии определяется в одном месте — константой VERSION в
модуле transcriber_core.py (текущее значение 1.0.0); там же —
наименование правообладателя (RIGHTS_HOLDER). Из этого места номер
получают: страница «О программе», вывод ключа --version, имена архивов
дистрибутива (tembr-<версия>-<платформа>.zip), мастер установки Windows
(совпадение проверяется сборщиком).
4.3. Каждая выпущенная версия сопровождается перечнем изменений. Перечень публикуется на сайте https://tembr.web3-0.ru/docs/ и ведётся в репозитории.
4.4. Обновление Программы выполняется заказчиком вручную установкой дистрибутива новой версии поверх установленной. Автоматические и принудительные обновления, а также удалённое управление Программой не применяются. Данные пользователей и активированная лицензия при обновлении сохраняются; формат хранения мигрируется автоматически с резервным копированием. Проверка лицензии на сервере правообладателя (п. 5.7) обновлений не доставляет и Программой не управляет.
5. Техническая поддержка
5.1. Техническая поддержка оказывается ООО «Веб 3.0» на русском языке.
5.2. Каналы обращения:
| канал | реквизиты |
|---|---|
| электронная почта | veb3.0@yandex.ru |
| сайт | https://tembr.web3-0.ru (справочные сведения) |
Обращения принимаются только по электронной почте; телефонной линии нет. Для тарифа «Enterprise» каналы и сроки устанавливаются SLA договора.
5.3. Время работы: рабочие дни, 10:00–19:00 по московскому времени.
5.4. Сроки:
| вид обращения | срок |
|---|---|
| первый ответ на обращение | «Личный» — в течение 2 рабочих дней; «Команда» — в течение 1 рабочего дня; «Enterprise» — по SLA договора |
| критическая неисправность (Программа не запускается, обработка невозможна, нарушено разграничение доступа, угроза сохранности данных) | устранение выпуском внеочередного дистрибутива исправления; срок — до 10 рабочих дней |
| некритическая неисправность | устранение в очередной версии |
| консультации по установке и эксплуатации | в рабочем порядке |
5.5. Состав поддержки: консультирование по установке, настройке и эксплуатации; диагностика и устранение неисправностей; предоставление исправлений и новых версий в период действия лицензии; актуализация документации.
5.6. Поддержка и обновления входят в цену лицензии и предоставляются в течение всего её срока (один год; по ключу — продление тем же ключом) по тарифам: «Личный» — 2 900 ₽ за место в год, 1–2 места; «Команда» — 2 500 ₽ за место в год, от 3 мест; «Enterprise» — по отдельному согласованию и договору, не менее 10 устройств, от 25 000 ₽ в год (корпоративная поставка без ключа и без обращений в интернет). Место — компьютер либо учётная запись на серверной установке. Условия — на сайте https://tembr.web3-0.ru и в тарифной политике.
5.7. Выпуск и сопровождение лицензий. Лицензионные ключи, активация,
ежедневная проверка и отвязка компьютеров обеспечиваются ООО «Веб 3.0» на
сервере лицензий https://tembr.web3-0.ru/api/lic (виртуальный сервер
104.128.134.108 в дата-центре DataPro, г. Москва, Российская Федерация;
провайдер VPS — FirstByte (First Server S.L.) — предоставляет только
аренду сервера, сервер и его программное обеспечение контролирует
ООО «Веб 3.0»). Закрытый ключ подписи
жетонов лицензии хранится у ООО «Веб 3.0» на этом сервере и у
генерального директора (копия на компьютере руководителя в РФ). По
вопросам лицензий (перенос мест, заявка на Enterprise) — тот же канал
поддержки, veb3.0@yandex.ru. При недоступности сервера лицензий Программа
продолжает работать 14 дней по последнему жетону. Корпоративная поставка
(Enterprise) от сервера лицензий не зависит.
Резервная копия базы ключей и активаций создаётся ежедневно на сервере
(/var/backups/tembr-pay, хранятся 14 последних копий); копия ключа
подписи — у генерального директора. Восстановление — развёртыванием
сервиса скриптом на новом сервере, срок — до 1 рабочего дня.
6. Устранение неисправностей
6.1. Порядок:
- Регистрация обращения и присвоение номера: обращения учитываются в почтовом ящике поддержки и задачами в закрытом репозитории на GitFlic.
- Сбор диагностических сведений у заказчика: версия Программы
(
--versionили страница «О программе»), ОС, вычислительное устройство, журнал службы (journalctl --user -u transcriber), выводпроверка-видеокарты.py, текст сообщения об ошибке. Записи и расшифровки заказчика для диагностики не запрашиваются; при необходимости заказчику предлагается воспроизвести неисправность на тестовой записи. - Воспроизведение неисправности в среде разработки на территории РФ.
- Исправление, добавление автоматического теста, закрепляющего исправление, прогон всех тестов.
- Сборка дистрибутива исправления (раздел 2.3) с увеличением номера
версии (
PATCH). - Передача дистрибутива заказчику и подтверждение устранения.
6.2. Программа содержит встроенные средства диагностики: вывод вычислительного устройства и свободной видеопамяти при каждом расчёте, сведения о месте хранения моделей, понятные пользователю сообщения об ошибках вместо технических трассировок, раздел «Если не заводится» в руководстве администратора.
7. Модернизация
7.1. Модернизация Программы выполняется ООО «Веб 3.0» на основании обращений заказчиков, результатов эксплуатации и изменения требований (в том числе требований к совместимости с российскими операционными системами).
7.2. Изменения, влияющие на качество распознавания, принимаются только по результатам измерений не менее чем на двух записях.
7.3. Замена или обновление сторонних компонентов (моделей, библиотек) выполняется с проверкой их лицензий и с сохранением принципа работы без обращений к внешним сервисам (единственное исключение — сервер лицензий правообладателя в РФ); модели заменяемы без изменения остальной архитектуры.
7.4. Модернизация сопровождается обновлением документации; соответствие документации администратора коду проверяется автоматическими тестами.
8. Совместимость с операционными системами
8.1. Поддерживаемые серверные ОС: Astra Linux Special Edition 1.8, РЕД ОС
7.3/8. Результаты проверки совместимости (протокол от 13.10.2026,
40-протоколы/): на РЕД ОС 7.3.6 и Astra Linux SE 1.8.2 «Орёл»
(облачные серверы Рег.облака, 4 vCPU, 4 ГБ ОЗУ + 4 ГБ подкачки) установка
из архива и расшифровка с разметкой ролей выполнены без сети, результат на
обеих ОС совпал слово в слово; служба systemd ставится, веб-интерфейс
работает. РЕД ОС 8 отдельно не проверялась.
Дополнительные ОС: Windows 10/11, macOS 13+ (Apple Silicon).
8.2. При выходе новых версий поддерживаемых ОС совместимость проверяется и при необходимости обеспечивается выпуском новой версии Программы.
9. Сведения о персонале
9.1. Разработка, сопровождение, техническая поддержка и модернизация Программы выполняются силами ООО «Веб 3.0». Программа создана Торпаном Н. Д. (разработка начата 01.07.2026); исключительное право принадлежит ООО «Веб 3.0» по договору об отчуждении № ОИП-1 от 16.10.2026.
| ФИО | должность | гражданство | роль в жизненном цикле |
|---|---|---|---|
| Торпан Никита Денисович | генеральный директор ООО «Веб 3.0» | Российская Федерация | разработка, сборка и выпуск версий, сопровождение, техническая поддержка, модернизация |
9.2. Иных лиц, участвующих в разработке и сопровождении Программы, нет. При привлечении дополнительных работников к ним применяется требование о гражданстве Российской Федерации, сведения о них вносятся в настоящий документ.
10. Место разработки и поддержки
| юридический адрес ООО «Веб 3.0» | 140055, Московская область, г. о. Котельники, г. Котельники, 2-й Покровский проезд, д. 6, кв. 195 |
| фактический адрес разработки | 140055, Московская область, г. о. Котельники, г. Котельники, 2-й Покровский проезд, д. 6, кв. 195 |
| фактический адрес технической поддержки | 140055, Московская область, г. о. Котельники, г. Котельники, 2-й Покровский проезд, д. 6, кв. 195 |
| сервер лицензий (активация, выпуск и управление лицензионными ключами) | виртуальный сервер (VPS) 104.128.134.108, дата-центр DataPro: г. Москва, ул. Авиамоторная, д. 69, Российская Федерация (провайдер VPS — FirstByte, First Server S.L.; сервер контролирует ООО «Веб 3.0»); https://tembr.web3-0.ru/api/lic |
11. Гарантийные обязательства
11.1. Правообладатель гарантирует соответствие Программы описанию функциональных характеристик при её установке и эксплуатации в соответствии с документацией на поддерживаемых ОС и оборудовании, отвечающем системным требованиям.
11.2. В период действия лицензии правообладатель устраняет выявленные неисправности в сроки, указанные в разделе 5, и предоставляет новые версии Программы.
11.3. Гарантия не распространяется на: точность распознавания речи (результат Программы — черновик для вычитки, показатели точности приведены в описании функциональных характеристик); неисправности, вызванные оборудованием, драйверами и библиотеками, установленными заказчиком (в том числе драйвером NVIDIA и CUDA); изменение кода Программы заказчиком; эксплуатацию с нарушением документации.
11.4. Гарантия действует в течение всего срока лицензии. Иные условия — по оферте, для «Enterprise» — по договору.