Документация · версия 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.py217ядро обработки: чтение звука, обработка, устранение артефактов, сборка реплик, выбор движка и устройства, автономный режим, отключение телеметрии
test_frontend.py70клиентская часть: разбор каждого файла JavaScript, отсутствие внешних ресурсов, разметка, поведение кода интерфейса (исполняется в Node.js)
test_jobs.py64очередь задач, четыре исхода обработки, освобождение ресурсов
test_web.py63HTTP API, разграничение доступа (проверка всех адресов на отсутствие чужих данных), первый запуск, HTTPS и переадресация
test_users.py62учётные записи, пароли, сеансы, роли
test_packaging.py42установщики и сборка, в том числе запуск сценариев установки
test_migration.py15миграция формата хранения и обратная совместимость
test_docs.py12соответствие документации администратора коду
test_export.py11выгрузка 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. Порядок:

  1. Регистрация обращения и присвоение номера: обращения учитываются в почтовом ящике поддержки и задачами в закрытом репозитории на GitFlic.
  2. Сбор диагностических сведений у заказчика: версия Программы (--version или страница «О программе»), ОС, вычислительное устройство, журнал службы (journalctl --user -u transcriber), вывод проверка-видеокарты.py, текст сообщения об ошибке. Записи и расшифровки заказчика для диагностики не запрашиваются; при необходимости заказчику предлагается воспроизвести неисправность на тестовой записи.
  3. Воспроизведение неисправности в среде разработки на территории РФ.
  4. Исправление, добавление автоматического теста, закрепляющего исправление, прогон всех тестов.
  5. Сборка дистрибутива исправления (раздел 2.3) с увеличением номера версии (PATCH).
  6. Передача дистрибутива заказчику и подтверждение устранения.

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» — по договору.