1. Общие сведения
Платформа ТРЭК — семейство программных продуктов для работы с моделью улично-дорожной сети, обработки телематики транспортных средств, диагностики движения и расчёта светофорного регулирования. Продукты развиваются и поставляются единой командой, в едином цикле выпуска версий, и разворачиваются на стенде заказчика как один комплекс.
Правообладатель программного обеспечения — Общество с ограниченной ответственностью «Трафик Эквилибриум» (ООО «ТРЭК»), ИНН 7801565414, ОГРН 1127847046997, адрес: 199178, г. Санкт-Петербург, Линия 13-я В.О., д. 20. Разработку, выпуск версий, сопровождение и техническую поддержку осуществляет правообладатель.
2. Процесс разработки
Разработка ведётся непрерывно, в собственном репозитории исходного кода правообладателя, размещённом на территории Российской Федерации. Каждое изменение проходит:
- Разработку в отдельной ветке.
- Автоматическую проверку: сборка, статический анализ типов, проверка стиля кода, автоматические тесты.
- Ревью изменения вторым разработчиком.
- Слияние в основную ветку, сборку образов приложений и сборку поставочных образов в двух исполнениях — на базе операционных систем Astra Linux Special Edition и Альт p11.
- Установку на предпродуктивный стенд и проверку в работе.
- Установку на продуктивные стенды.
Предпродуктивный стенд обязателен для всех изменений, затрагивающих схему данных или порядок развёртывания: релиз попадает на него раньше, чем к заказчикам.
3. Версионирование и выпуск
| Тип выпуска | Содержание | Периодичность |
|---|---|---|
| Функциональный релиз | новые возможности, изменения интерфейса, изменения схемы данных | по мере готовности, ориентир — ежеквартально |
| Патч-релиз | исправления неисправностей, не меняющие состав функций | по мере необходимости |
| Срочное исправление | устранение критичной неисправности | вне графика, в сроки из §5 |
Поддерживаются текущая версия и одна предыдущая. Заказчик получает уведомление о выпуске с перечнем изменений и указанием, требует ли обновление миграции данных.
3.1. Состав поставки
Программное обеспечение поставляется заказчику комплектом контейнерных образов, собранных на базе операционной системы Astra Linux Special Edition либо Альт p11 (по выбору заказчика), и сопровождающих их файлов установки:
| Часть поставки | Назначение |
|---|---|
| Образ инфраструктуры | кэш, шина событий, пространственный индекс, сервер картографических тайлов, хранилище файлов |
| Образ платформы | веб-шлюз, подсистема аутентификации, служба учётных записей |
| Образ приложений | продукты платформы и конвейер подготовки картографических данных |
| Файл описания запуска | порядок запуска контейнеров, связи между ними, размещение данных |
| Каталог конфигураций | настройки веб-шлюза, сервера тайлов и системы управления базами данных, доступные администратору для изменения |
| Шаблон файла параметров установки | доменное имя, почтовое соединение, учётные записи, признаки включения необязательных подсистем |
Все три образа выпускаются одной версией и проверяются совместно. Комплект образов может собираться под конкретного заказчика: в поставку включаются только приобретённые продукты, остальные в образ приложений не входят.
Система управления базами данных в состав изделия не входит. Программное обеспечение является прикладным и работает на СУБД заказчика; перечень рекомендуемых систем приведён в руководстве системного администратора. Для демонстрации, пилотных установок и сред, где собственной СУБД нет, в комплект включён опциональный образ с преднастроенной СУБД; для промышленной эксплуатации рекомендуется работа на СУБД заказчика.
Разграничение ответственности. При работе на СУБД заказчика её работоспособность, резервное копирование, обновление и производительность находятся в зоне ответственности заказчика; правообладатель отвечает за прикладное программное обеспечение и оказывает поддержку по вопросам его взаимодействия с СУБД. При использовании опционального образа с преднастроенной СУБД она сопровождается правообладателем наравне с остальными частями поставки. Конкретное разграничение фиксируется договором технической поддержки.
3.2. Обновление и откат
Обновление выполняется заменой образов и повторным запуском комплекта. Данные стенда хранятся отдельно от образов и обновление переживают; миграции баз данных выполняются автоматически при запуске контейнера приложений. Как правило обновляется только образ приложений — образы инфраструктуры и платформы пересоздаются, если изменилась их версия. Порядок действий описан в поставляемой части руководства системного администратора платформы.
Возврат к предыдущей версии выполняется тем же способом — указанием предыдущей версии образов; предыдущая версия остаётся у заказчика и обращения в техническую поддержку для возврата не требует. Возврат не отменяет уже выполненные изменения схемы базы данных: если выпуск такие изменения содержал, это указывается в уведомлении о выпуске прямо, и возврат выполняется совместно с восстановлением из резервной копии, созданной до обновления.
3.3. Поставка и обновление в изолированном контуре
Стенд заказчика может не иметь доступа к сетям общего пользования. Для таких установок образы передаются файлами архивов на носителе или по защищённому каналу, согласованному с заказчиком, вместе с контрольными суммами. Установка и обновление в этом случае не требуют обращения к внешним источникам: образы загружаются из переданных файлов, все компоненты уже находятся внутри образов.
Правообладатель сопровождает каждую передачу перечнем версий компонентов, входящих в поставку, и перечнем изменений относительно предыдущей переданной версии. Файлы предыдущей версии заказчик сохраняет — они являются средством возврата.
4. Каналы обращений
| Канал | Назначение | Режим |
|---|---|---|
Электронная почта info@trafficeq.ru |
основной канал регистрации обращений | приём круглосуточный, обработка в рабочие часы |
| Телефон +7 (812) 642-24-33 | срочные обращения по инцидентам | рабочие часы |
| Телефон +7 (905) 254-55-55 | дополнительная линия | рабочие часы |
| Персональный контакт технического специалиста | стенды на сопровождении по договору | по условиям договора |
Рабочие часы технической поддержки: 09:00–18:00 по московскому времени, понедельник–пятница, кроме нерабочих праздничных дней Российской Федерации.
При обращении сообщаются: наименование продукта и версия, идентификатор стенда, описание проблемы, последовательность действий для её воспроизведения, время возникновения.
5. Классы обращений и сроки
| Класс | Признак | Срок реакции | Срок обхода или решения |
|---|---|---|---|
| Критичный | продукт недоступен, расчёт невозможен, есть риск потери данных | 4 рабочих часа | обход — 1 рабочий день, устранение — в ближайшем патч-релизе |
| Существенный | функция работает неверно, но есть обходной путь | 1 рабочий день | 5 рабочих дней |
| Незначительный | неудобство, косметический дефект | 3 рабочих дня | в очередном функциональном релизе |
| Консультация | вопрос по эксплуатации, не связанный с дефектом | 3 рабочих дня | — |
Класс обращения определяет техническая поддержка при регистрации; заказчик вправе оспорить классификацию. Приведённые сроки являются типовыми; если договором технической поддержки установлены иные сроки, применяются условия договора.
6. Порядок устранения неисправностей
- Регистрация. Обращение фиксируется, ему присваиваются номер и класс.
- Уточнение. Поддержка запрашивает недостающие сведения: журналы работы сервисов, снимки экрана, точную последовательность действий.
- Воспроизведение. Неисправность воспроизводится на стенде правообладателя на той же версии.
- Обход. Если обходной путь существует, он сообщается заявителю немедленно, не дожидаясь исправления.
- Исправление. Изменение вносится в код, проходит проверки и ревью (§2).
- Выпуск. Исправление входит в патч-релиз или срочное исправление.
- Проверка. Заявитель подтверждает, что неисправность устранена на его стенде.
- Закрытие обращения.
Если неисправность вызвана не программным обеспечением, а окружением стенда (нехватка ресурсов, сетевые ограничения, некорректная конфигурация), поддержка сообщает об этом с указанием причины и рекомендациями по устранению.
7. Персонал технической поддержки
| Линия | Роль | Задачи | Компетенции |
|---|---|---|---|
| Первая | инженер сопровождения | приём и классификация обращений, типовые процедуры, эксплуатация стендов, консультации | Linux, Docker, PostgreSQL, основы организации дорожного движения и транспортного моделирования |
| Вторая | разработчик профильного модуля | диагностика, воспроизведение, исправление кода | разработка на TypeScript/Node.js, PostgreSQL, предметная область продукта |
| Третья | архитектор платформы | изменения, затрагивающие несколько сервисов, схему данных, порядок развёртывания | архитектура распределённых систем, вычислительная геометрия, транспортное моделирование |
Численность и состав команды сопровождения определяются числом обслуживаемых стендов и условиями договоров.
8. Обучение и передача знаний
Заказчику передаётся комплект эксплуатационной документации: руководство пользователя на каждый продукт и руководство системного администратора платформы (публичная и поставляемая части), содержащее сведения, необходимые для установки, настройки, проверки и обслуживания. Вместе с документацией передаётся перечень программных компонентов, входящих в поставку, с указанием версий и условий использования. По запросу проводится установочное обучение администраторов и пользователей.
9. Прекращение поддержки версии
О прекращении поддержки версии заказчик уведомляется не позднее чем за три месяца, с указанием версии, на которую следует обновиться, и порядка перехода.