ВАЙЛТДокументы ВАЙЛТ

Документация, содержащая описание технических средств хранения исходного текста и объектного кода программного обеспечения, а также технических средств компиляции исходного текста в объектный код программного обеспечения

Экосистема ВАЙЛТ. Сервис В.Чат — chat.whilet.ru
Редакция от 09 июля 2026 г. Действует с момента публикации.


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

Наименование программного обеспечения: В.Чат
Правообладатель: Гуляев Кирилл Иванович
Версия программного обеспечения: 1.0.6 (6)

Настоящий документ содержит описание технических средств хранения исходного текста программного обеспечения «В.Чат», технических средств хранения объектного кода программного обеспечения, а также технических средств компиляции исходного текста в объектный код программного обеспечения.

Документ подготовлен для подтверждения состава и расположения технических средств, используемых при разработке, сборке, хранении и эксплуатации программного обеспечения.

2. Термины и определения

Исходный текст программного обеспечения — совокупность файлов программного кода, конфигурационных файлов, схем базы данных, файлов интерфейса, серверной логики, клиентской логики, сценариев сборки и иных материалов, необходимых для разработки, модификации и сборки программного обеспечения.

Объектный код программного обеспечения — результат сборки исходного текста программного обеспечения, предназначенный для исполнения, размещения или эксплуатации программного обеспечения, включая серверные исполняемые файлы, собранные клиентские файлы, статические ресурсы, пакеты сборки, контейнеры или иные артефакты сборки.

Технические средства хранения — серверное оборудование, дисковые массивы, системы хранения данных, виртуальные серверы, файловые хранилища, репозитории, системы резервного копирования и иные технические средства, используемые для хранения исходного текста и объектного кода программного обеспечения.

Технические средства компиляции — серверное оборудование, виртуальные серверы, операционные системы, среды выполнения, сборочные инструменты, системы непрерывной интеграции и иные средства, используемые для преобразования исходного текста программного обеспечения в объектный код.

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

Программное обеспечение «В.Чат» включает следующие основные компоненты:

  1. Клиентская часть программного обеспечения.
  2. Серверная часть программного обеспечения.
  3. Программный интерфейс API.
  4. Модуль обмена событиями в режиме реального времени.
  5. Модуль авторизации и управления пользователями.
  6. Модуль личных чатов.
  7. Модуль групповых чатов.
  8. Модуль каналов.
  9. Модуль секретных чатов.
  10. Модуль уведомлений.
  11. Модуль загрузки и обработки файлов.
  12. Административный модуль.
  13. Схемы и миграции базы данных.
  14. Конфигурационные файлы.
  15. Сценарии сборки, запуска и обновления программного обеспечения.

4. Хранение исходного текста программного обеспечения

Исходный текст программного обеспечения «В.Чат» хранится в системе контроля версий Git, размещённой на технических средствах, находящихся на территории Российской Федерации.

Основным техническим средством хранения исходного текста является:

  • тип средства хранения: сервер системы контроля версий;
  • система контроля версий: Git;
  • программная платформа репозитория: GitVerse;
  • адрес размещения репозитория: https://gitverse.ru/whilet/chat и https://gitverse.ru/whilet/api;
  • место размещения технических средств: Российская Федерация, инфраструктура платформы GitVerse;
  • владелец или оператор инфраструктуры: оператор платформы GitVerse;
  • операционная система сервера: не администрируется правообладателем программного обеспечения, используется серверная инфраструктура платформы GitVerse;
  • тип хранения данных: серверное хранилище платформы GitVerse;
  • порядок доступа: доступ предоставляется только уполномоченным лицам с использованием индивидуальных учётных записей.

В репозитории исходного текста хранятся:

  1. Исходный код клиентской части.
  2. Исходный код серверной части.
  3. Исходный код API.
  4. Исходный код модулей обмена событиями в режиме реального времени.
  5. Схемы базы данных.
  6. Миграции базы данных.
  7. Конфигурационные шаблоны.
  8. Сценарии сборки.
  9. Сценарии запуска.
  10. Сценарии обновления.
  11. Документация разработчика.
  12. Документация по эксплуатации.
  13. Файлы зависимостей и описания окружения.
  14. Файлы управления версиями и релизами.

Изменения исходного текста фиксируются в системе контроля версий. Для каждого изменения сохраняются сведения о дате, времени, авторе изменения, составе изменённых файлов и описании изменения.

5. Резервное копирование исходного текста

Для обеспечения сохранности исходного текста программного обеспечения применяется резервное копирование.

Резервные копии исходного текста создаются и хранятся на технических средствах, расположенных на территории Российской Федерации.

Параметры резервного копирования:

  • тип резервного копирования: смешанное резервное копирование, включающее полные резервные копии и инкрементальное сохранение изменений;
  • периодичность резервного копирования: ежедневно, а также дополнительно при выпуске значимых релизных версий программного обеспечения;
  • место хранения резервных копий: Российская Федерация, г. Москва, серверное хранилище хостинг-провайдера ООО «ТАЙМВЭБ.КЛАУД»;
  • срок хранения резервных копий: не менее 30 календарных дней;
  • доступ к резервным копиям: предоставляется только уполномоченным техническим администраторам с использованием индивидуальных учётных записей и разграничения прав доступа.

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

6. Хранение объектного кода программного обеспечения

Объектный код программного обеспечения «В.Чат» формируется в результате сборки исходного текста и хранится на технических средствах, находящихся на территории Российской Федерации.

К объектному коду программного обеспечения относятся:

  1. Собранная клиентская часть программного обеспечения.
  2. Собранная серверная часть программного обеспечения.
  3. Статические файлы клиентского интерфейса.
  4. Исполняемые серверные файлы.
  5. Скомпилированные или подготовленные к исполнению файлы приложения.
  6. Артефакты сборки.
  7. Релизные пакеты.
  8. Контейнерные образы, если они используются при эксплуатации.
  9. Файлы конфигурации релизной версии, не содержащие секретных ключей.
  10. Миграции базы данных, применяемые при развёртывании релиза.

Основным техническим средством хранения объектного кода является:

  • тип средства хранения: сервер хранения артефактов сборки и релизных версий программного обеспечения;
  • адрес размещения: внутренний каталог релизных артефактов на серверной инфраструктуре правообладателя, доступный только уполномоченным техническим администраторам;
  • место размещения технических средств: Российская Федерация, г. Москва, серверная инфраструктура хостинг-провайдера ООО «ТАЙМВЭБ.КЛАУД»;
  • владелец или оператор инфраструктуры: ООО «ТАЙМВЭБ.КЛАУД»;
  • операционная система сервера: Ubuntu 24.04;
  • тип хранения: файловая система сервера, NVMe-накопители и/или объектное хранилище для хранения релизных артефактов и резервных копий;
  • порядок доступа: доступ предоставляется только уполномоченным лицам с использованием индивидуальных учётных записей, разграничения прав доступа и защищённых каналов подключения.

Объектный код хранится по версиям. Для каждой версии сохраняются:

  1. Номер версии.
  2. Дата сборки.
  3. Идентификатор исходного коммита.
  4. Состав артефактов сборки.
  5. Контрольные суммы артефактов, если они применяются.
  6. Сведения о лице или процессе, выполнившем сборку.
  7. Сведения о среде сборки.

7. Технические средства компиляции исходного текста в объектный код

Компиляция и сборка исходного текста программного обеспечения «В.Чат» в объектный код выполняются на технических средствах, расположенных на территории Российской Федерации.

Основным техническим средством компиляции является сборочный сервер.

Характеристики сборочного сервера:

  • тип технического средства: виртуальный сервер сборки;
  • место размещения: Российская Федерация, г. Москва, серверная инфраструктура хостинг-провайдера ООО «ТАЙМВЭБ.КЛАУД»;
  • владелец или оператор инфраструктуры: ООО «ТАЙМВЭБ.КЛАУД»;
  • операционная система: Ubuntu 24.04;
  • среда выполнения: Node.js, версия, используемая в рабочем контуре программного обеспечения;
  • пакетный менеджер: npm;
  • система сборки: встроенные сценарии сборки Node.js-проекта, определённые в файлах конфигурации программного обеспечения;
  • система непрерывной интеграции: ручная или полуавтоматическая сборка на сервере сборки с использованием Git, Node.js, npm и сценариев сборки проекта;
  • доступ: доступ предоставляется только уполномоченным техническим администраторам с использованием индивидуальных учётных записей, разграничения прав доступа и защищённых каналов подключения.

В процессе сборки используются следующие технические средства и инструменты:

  1. Операционная система сборочного сервера.
  2. Среда выполнения Node.js.
  3. Пакетный менеджер зависимостей.
  4. Система контроля версий Git.
  5. Сценарии установки зависимостей.
  6. Сценарии проверки исходного текста.
  7. Сценарии сборки клиентской части.
  8. Сценарии сборки серверной части.
  9. Сценарии подготовки релизных артефактов.
  10. Сценарии миграции базы данных.
  11. Средства упаковки релизной версии.
  12. Средства публикации объектного кода в хранилище артефактов.

8. Порядок компиляции и сборки

Сборка программного обеспечения выполняется из исходного текста, размещённого в основном репозитории.

Общий порядок сборки:

  1. Получение актуальной версии исходного текста из репозитория Git.
  2. Проверка целостности исходного текста.
  3. Установка зависимостей.
  4. Проверка конфигурации сборочного окружения.
  5. Выполнение автоматизированных проверок, если они предусмотрены.
  6. Сборка клиентской части программного обеспечения.
  7. Сборка серверной части программного обеспечения.
  8. Формирование статических файлов.
  9. Формирование серверных файлов, необходимых для запуска программного обеспечения.
  10. Формирование релизного пакета.
  11. Присвоение версии релизу.
  12. Сохранение объектного кода в хранилище артефактов.
  13. Развёртывание объектного кода на сервере эксплуатации или подготовка к развёртыванию.

Примерный состав команд сборки:

git clone [адрес репозитория]
cd [каталог проекта]
npm install
npm run build
npm run start

Если программное обеспечение состоит из нескольких компонентов, сборка выполняется отдельно для клиентской части, серверной части и дополнительных модулей.

Примерный порядок сборки клиентской части:

cd [каталог клиентской части]
npm install
npm run build

Примерный порядок сборки серверной части:

cd [каталог серверной части]
npm install
npm run start

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

9. Контроль версий и идентификация сборок

Каждая сборка программного обеспечения связывается с определённой версией исходного текста.

Для идентификации сборки используются:

  1. Номер версии программного обеспечения.
  2. Идентификатор коммита в системе контроля версий.
  3. Дата и время сборки.
  4. Наименование ветки исходного текста.
  5. Сведения о сборочном окружении.
  6. Сведения о лице или автоматизированном процессе, выполнившем сборку.

Связь между исходным текстом и объектным кодом обеспечивает возможность воспроизведения сборки, проверки состава релиза и восстановления истории изменений.

10. Размещение объектного кода в эксплуатационной среде

После формирования объектного кода программного обеспечения «В.Чат» объектный код размещается в эксплуатационной среде, предназначенной для функционирования программного обеспечения и предоставления пользователям доступа к его основным возможностям.

Эксплуатационная среда программного обеспечения размещается на технических средствах, находящихся на территории Российской Федерации.

Основные параметры эксплуатационной среды:

  • тип среды: сервер эксплуатации программного обеспечения;
  • территория размещения: Российская Федерация;
  • место размещения: Омск, ООО «ТАЙМВЭБ.КЛАУД»;
  • операционная система: Ubuntu 24.04;
  • серверное приложение: Node.js-приложение, запускаемое через services systemd;
  • веб-сервер или reverse proxy: Nginx;
  • база данных: MySQL;
  • хранилище пользовательских файлов: локальное файловое хранилище на сервере и S3-совместимое объектное хранилище Яндекс.Облако, расположенное на территории Российской Федерации
  • механизм обмена событиями: Socket.IO / WebSocket / Fetch API.

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

К основным функциям, проверяемым перед размещением объектного кода в эксплуатационной среде, относятся:

  1. Авторизация пользователей через ВАЙЛТ.ID.
  2. Работа пользовательского интерфейса.
  3. Обмен сообщениями в личных чатах.
  4. Работа групп, каналов и иных коммуникационных разделов.
  5. Работа серверного API.
  6. Взаимодействие с базой данных.
  7. Загрузка и получение пользовательских файлов, если такая функция используется.
  8. Получение и отправка уведомлений, если такая функция используется.
  9. Проверка доступности программного обеспечения через доменное имя и веб-сервер.
  10. Проверка корректной работы основных механизмов безопасности.

Эксплуатация программного обеспечения осуществляется с использованием объектного кода, размещённого в указанной эксплуатационной среде. Изменение версии объектного кода в эксплуатационной среде производится в рамках процедуры обновления программного обеспечения.

11. Контроль доступа к техническим средствам

Доступ к техническим средствам хранения исходного текста, хранения объектного кода и компиляции исходного текста ограничивается.

Доступ предоставляется только уполномоченным лицам, участвующим в разработке, сопровождении, администрировании и эксплуатации программного обеспечения.

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

  1. Использование индивидуальных учётных записей.
  2. Разграничение прав доступа.
  3. Ограничение доступа к административным функциям.
  4. Использование защищённых протоколов подключения.
  5. Регистрация действий пользователей в системных журналах.
  6. Ограничение доступа к секретным ключам и переменным окружения.
  7. Отзыв доступа при прекращении участия лица в разработке или сопровождении программного обеспечения.

12. Защита и сохранность исходного текста и объектного кода

Для защиты и сохранности исходного текста и объектного кода применяются следующие организационные и технические меры:

  1. Хранение исходного текста в системе контроля версий.
  2. Хранение объектного кода по версиям.
  3. Резервное копирование исходного текста.
  4. Резервное копирование релизных артефактов.
  5. Ограничение доступа к репозиториям.
  6. Ограничение доступа к сборочным серверам.
  7. Ограничение доступа к серверам эксплуатации.
  8. Использование журналирования технических действий.
  9. Использование защищённых каналов доступа.
  10. Контроль изменений исходного текста.
  11. Проверка целостности релизных артефактов, если она применяется.
  12. Разделение сред разработки, сборки и эксплуатации, если это предусмотрено инфраструктурой.

13. Сведения о размещении технических средств на территории Российской Федерации

Технические средства хранения исходного текста программного обеспечения, хранения объектного кода программного обеспечения и компиляции исходного текста в объектный код программного обеспечения находятся на территории Российской Федерации.

Сведения о размещении:

Вид технического средстваНазначениеМесто размещенияОператор / провайдер
Сервер системы контроля версийХранение исходного текстаРФ, ООО «ТАЙМВЭБ.КЛАУД»ООО «ТАЙМВЭБ.КЛАУД»
Сервер резервного копированияХранение резервных копий исходного текстаРФ, ООО «ТАЙМВЭБ.КЛАУД»ООО «ТАЙМВЭБ.КЛАУД»
Сборочный серверКомпиляция и сборка исходного текста в объектный кодРФ, ООО «ТАЙМВЭБ.КЛАУД»ООО «ТАЙМВЭБ.КЛАУД»
Сервер хранения артефактовХранение объектного кода и релизных пакетовРФ, ООО «ТАЙМВЭБ.КЛАУД»ООО «ТАЙМВЭБ.КЛАУД»
Сервер эксплуатацииРазмещение и исполнение объектного кодаРФ, ООО «ТАЙМВЭБ.КЛАУД»ООО «ТАЙМВЭБ.КЛАУД»

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

14. Сведения о средствах разработки и сборки

При разработке и сборке программного обеспечения используются следующие средства:

СредствоНазначение
GitКонтроль версий исходного текста
Node.jsСреда выполнения и сборки программного обеспечения
npmУправление зависимостями
Next.jsСборка клиентской части
ExpressРабота серверной части
MySQLХранение данных программного обеспечения
NginxОбработка веб-запросов и маршрутизация
systemdЗапуск и управление серверными процессами

Фактический перечень средств разработки и сборки определяется текущей архитектурой программного обеспечения и может уточняться при изменении состава программного обеспечения.

15. Управление изменениями

Изменения в исходном тексте программного обеспечения выполняются через систему контроля версий.

Порядок управления изменениями включает:

  1. Создание изменения в отдельной ветке или рабочей копии.
  2. Проверку изменения разработчиком.
  3. Фиксацию изменения в системе контроля версий.
  4. Привязку изменения к задаче, версии или релизу, если такая привязка применяется.
  5. Сборку программного обеспечения.
  6. Проверку работоспособности.
  7. Сохранение объектного кода в хранилище артефактов.
  8. Размещение релизной версии в эксплуатационной среде.

16. Восстановление исходного текста и объектного кода

Восстановление исходного текста возможно из:

  1. Основного репозитория Git.
  2. Резервной копии репозитория.
  3. Архивной копии релиза.
  4. Локальных резервных копий, если они применяются.

Восстановление объектного кода возможно из:

  1. Хранилища артефактов.
  2. Резервной копии хранилища артефактов.
  3. Архива релизной версии.
  4. Повторной сборки из соответствующей версии исходного текста.

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

17. Ответственные лица

Ответственными за хранение исходного текста, хранение объектного кода, сборку и эксплуатацию программного обеспечения являются уполномоченные лица правообладателя.

Ответственные лица обеспечивают:

  1. Поддержание работоспособности технических средств.
  2. Контроль доступа к исходному тексту.
  3. Контроль доступа к объектному коду.
  4. Выполнение резервного копирования.
  5. Проведение сборки программного обеспечения.
  6. Размещение релизных версий.
  7. Ведение технической документации.
  8. Актуализацию сведений о технических средствах.

18. Заключительные положения

Настоящая документация описывает технические средства хранения исходного текста программного обеспечения «В.Чат», технические средства хранения объектного кода программного обеспечения, а также технические средства компиляции исходного текста в объектный код программного обеспечения.

Сведения, указанные в настоящем документе, подлежат актуализации при изменении технических средств хранения, сборки, компиляции, размещения или эксплуатации программного обеспечения.

← Ко всем документам