Описание процессов, обеспечивающих поддержание жизненного цикла программного обеспечения «Голосовой ИИ-тренажёр»

1. Общие сведения

Настоящий документ описывает процессы, обеспечивающие поддержание жизненного цикла программного обеспечения «Голосовой ИИ-тренажёр», включая устранение неисправностей, выявленных в ходе эксплуатации программы, совершенствование программы, а также информацию о персонале, необходимом для обеспечения такой поддержки.

Все работы по разработке, модификации и сопровождению программы выполняются силами ООО «Аспирити» на территории Российской Федерации. Программа предоставляется пользователям по модели облачного сервиса по адресу app.pichi.ai; по отдельному соглашению возможно развёртывание продуктового экземпляра в инфраструктуре заказчика.

2. Процессы разработки и выпуска версий

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

Программа реализована как веб-приложение. Клиентская часть — одностраничное приложение на TypeScript и React; серверная часть — приложение на TypeScript (Node.js) с REST API и веб-сокетным каналом реального времени; хранилище данных — СУБД PostgreSQL. Публичный сайт продукта реализован отдельным приложением. Компоненты поставляются в виде контейнеров Docker и разворачиваются средствами Docker Compose.

2.2. Управление исходным кодом

• Исходный код ведётся в системе контроля версий Git в закрытом репозитории правообладателя.
• Прямая запись в основную ветку запрещена: изменения вносятся в отдельных ветках и попадают в основную ветку только через запрос на слияние (pull request).
• Каждый запрос на слияние проходит обязательное код-ревью силами разработчиков команды.
• История изменений сохраняется бессрочно и позволяет восстановить любое предыдущее состояние кода.

2.3. Контроль качества перед выпуском

Перед выпуском версии выполняются следующие проверки:

• Статический анализ кода (линтер) и проверка единообразия форматирования.
• Проверка типов на всей кодовой базе (npm run check) — сборка не выпускается при наличии ошибок типизации.
• Сборка контейнерных образов приложения и публичного сайта.
• Функциональная проверка изменений: ручная проверка по чек-листу, которую выполняют специалисты по обеспечению качества. Проверка проводится перед каждым выпуском; выпуск не выкладывается в продуктив до её завершения.
• Проверка выполняется на отдельном тестовом контуре, развёрнутом независимо от продуктивного и повторяющем его состав сервисов.

2.4. Выпуск версий

• Применяется трёхкомпонентная нумерация версий вида МАЖОРНАЯ.МИНОРНАЯ.ПАТЧ. Номер текущей версии отображается в интерфейсе программы в боковом меню.
• Плановые выпуски выходят по еженедельному релизному окну: патч-версии (исправления и мелкие улучшения) — еженедельно, минорные версии (новая функциональность) — раз в две недели. Исправления критических дефектов выпускаются вне графика.
• Выкладка выполняется заменой тега контейнерного образа с последующим перезапуском сервиса. Миграции схемы базы данных применяются автоматически при старте приложения.
• Миграции проектируются по принципу обратной совместимости (расширение схемы → перевод данных → удаление устаревших структур), что позволяет откатить версию приложения без потери данных.
• Откат версии выполняется возвратом к предыдущему тегу образа и перезапуском сервиса.
• Состав каждого выпуска доводится до пользователей через встроенный раздел «Журнал обновлений»: новые релизы отмечаются значком в боковом меню.

3. Техническая поддержка пользователей

3.1. Каналы обращений

3.2. Режим работы и сроки реакции

Приём обращений по электронной почте и через форму обратной связи осуществляется круглосуточно, обработка обращений выполняется в рабочее время. Стандартный канал поддержки — электронная почта: ответ менеджера предоставляется в течение 2 часов рабочего времени.

Для заказчиков уровня Enterprise и заказчиков с большим объёмом лицензий условия поддержки закрепляются в договоре в виде расширенного соглашения об уровне обслуживания (SLA) с сокращёнными сроками реакции.

4. Устранение неисправностей в ходе эксплуатации

4.1. Источники сведений о неисправностях

• Обращения пользователей и администраторов организаций-заказчиков.
• Системы наблюдаемости: централизованный сбор журналов работы сервисов и метрик, автоматические оповещения об ошибках.
• Результаты внутреннего контроля качества и проверок при выпуске версий.

4.2. Порядок обработки

1. Регистрация. Обращение или автоматическое оповещение фиксируется во внутренней системе учёта задач с присвоением уникального идентификатора.
2. Классификация. Определяется класс обращения (критический, высокий, обычный) и ответственный исполнитель.
3. Диагностика. Выполняется анализ журналов и воспроизведение проблемы; определяется, относится ли неисправность к программе или к внешним сервисам и оборудованию пользователя.
4. Устранение. Разрабатывается исправление, проходит код-ревью и проверку, после чего включается в очередной выпуск. Для критических дефектов выпускается внеплановое обновление.
5. Проверка и закрытие. Работоспособность подтверждается на продуктивном контуре; заявителю направляется уведомление об устранении.

5. Совершенствование программного обеспечения

Развитие программы ведётся непрерывно и планируется на основе следующих источников:

• Предложения и замечания пользователей, поступающие через форму обратной связи и каналы поддержки.
• Обобщённые показатели фактического использования функций программы.
• Запросы организаций-заказчиков в рамках проектов внедрения и пилотных проектов.
• Собственная продуктовая стратегия правообладателя, включая развитие моделей анализа диалогов и голосового стека.

Поступившие предложения проходят оценку по значимости и трудоёмкости, включаются в план развития и реализуются в составе очередных выпусков. Информация о реализованных изменениях публикуется в разделе «Журнал обновлений» внутри программы и отражается в настоящей документации при её периодическом обновлении.

6. Сведения о персонале

Общая численность штата ООО «Аспирити» составляет 35 человек. Разработку, модификацию и сопровождение программы «Голосовой ИИ-тренажёр» обеспечивает выделенная продуктовая команда численностью 8 человек. Сотрудники являются гражданами Российской Федерации и осуществляют трудовую деятельность на территории Российской Федерации.

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

7. Инфраструктура и защита данных

• Серверная инфраструктура программы размещена на территории Российской Федерации в дата-центрах облачной платформы Yandex Cloud (регион ru-central1). Трансграничная передача данных при работе программы не осуществляется.
• Обработка персональных данных пользователей осуществляется в соответствии с Федеральным законом от 27.07.2006 № 152-ФЗ «О персональных данных». Условия обработки изложены в политике конфиденциальности и публичной оферте правообладателя.
• Доступ к продуктивной инфраструктуре предоставляется ограниченному кругу сотрудников по принципу минимально необходимых прав. Учётные данные и ключи доступа хранятся в защищённом хранилище секретов и не попадают в систему контроля версий.
• Резервное копирование базы данных и пользовательских файлов выполняется автоматически ежедневно; срок хранения резервных копий — 90 дней.
• Взаимодействие пользователя с программой осуществляется по защищённому протоколу HTTPS.

8. Контактная информация