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

Правообладатель: ООО «КОР»
Название программы для ЭВМ: КОРТЕКС.Маршруты
Назначение программы: Планирование и распределение ресурсов Заказчика с целью построению последовательности посещения точек доставки продуктов Заказчика выездными сотрудниками.
Область применения программы:
Применение в задачах планирования выездов сотрудников или мобильных групп Заказчика по раннее определенным географическим точкам при наложении требуемых технических, функциональных и/или бизнес ограничений.
Функциональные возможности программы:
1.    Продукт позволяет осуществлять построение расписания выполнения выездов на заданную дату/время в указанной географической зоне для определенных сотрудников Заказчика.
Каждый заказ на выезд характеризуется:
 - временным интервалом, в который он должен быть исполнен,
 - длительностью исполнения,
 - списком требуемых компетенций сотрудников,
 - адресом и его географическими координатами.
Выездной сотрудник (или группа) характеризуется:
 - временным интервалом работы,
 - географическими координатами места начала работы (опционально),
 - компетенциями,
 - одной или несколькими географически ограниченными зонами работы,
 - способом передвижения: общественный транспорт или автотранспорт.
2.    Продукт способен определять на основе обработанных геоданных расстояния между всеми географическими точками планируемых выездов (как время, так и дистанцию) и предлагать вариант посещения этих точек, наиболее отвечающий сформулированным требованиям Заказчика.
3.    Продукт позволяет выбирать сценарии построения расписаний. Распределять выезды между сотрудниками количественно равномерно или распределить все заказы среди минимально допустимого количества сотрудников, чтобы высвободить ресурсы под другие задачи. Выбирать степень доверия к геоданным, т.е. считать расстояния между географическими точками выездов точно в соответствии с полученными значениями или допускать определенную погрешность.
4.    Продукт имеет функцию логирования работы алгоритмов обработки данных и состояний системы в целом. Логи могут выгружаться как в файл, так и во внешнюю систему-сборщик логов.
Операционная система: Astra Linux Special Edition
Требования к установленному ПО: Docker Desktop версии не ниже 24.7.0
Язык программирования: С++, BASH
Объем программы (контейнера): 92 Mb

Описание жизненного цикла ПО «КОРТЕКС.Маршруты» (далее – ПО)

Процесс разработки ПО осуществляется в рамках цикла производства Технологических продуктов ООО «Квантовые и оптимизационные решения» (Далее – Компания) в соответствующих направлениях с учётом нормативной̆ документации по информационной̆ безопасности, по порядку работы с информацией̆, составляющей̆ коммерческую и банковскую тайну.
Работа организована в команде с применением научно-практических методологий ведения проектной деятельности с использованием гибкого итерационного подхода к разработке. Итерации разработки – недельные, анализ и архитектура идут с использованием фреймворка Kanban. Релизный цикл месячный.

Составление, согласование и фиксация результатов разработки документации и задач, связанных с созданием ПО, осуществляется в системах Jira и Confluence, развёрнутых “on-premise” в частном облаке.
Разработка/доработка и отладка ПО осуществляется на вычислительных средствах, не участвующих в промышленной̆ эксплуатации приложений, при этом используется специально сгенерированные массивы тестовых данных, не содержащие сведений ограниченного распространения (условно-реальные данные).

Репозитарий исходных кодов продукта располагается на локальных ресурсах 141701, Московская Область, г.о. Долгопрудный, г Долгопрудный, ул Первомайская, д. 3

По результатам разработки проводятся предварительные испытания ПО, далее возможен ввод в опытную эксплуатацию на изолированных средствах или средствах ограниченной̆ промышленной̆ эксплуатации. При этом проверяется: полнота и качество реализации параметров объекта автоматизации, взаимодействие различных систем и подсистем Компании, средства восстановления работоспособности ПО после отказов. Если в ходе испытаний или опытной̆ эксплуатации выяснилось, что необходимо внести изменения в ПО, то ПО отправляется на доработку. В случае решения о передаче ПО в промышленную эксплуатацию оформляется Акт приема-сдачи в промышленную эксплуатацию и ПО передается в АПД.

Вопросы технической̆ поддержки принимаются по электронной̆ почте: servicemail@qore-llc.pro

Официальная корреспонденция по вопросам технической̆ поддержки принимается по адресу: llc.qore@qore-llc.pro
Полученные вопросы обрабатываются в соответствии с внутренними стандартами и регламентами Компании, регламентирующими общие процессы сопровождения программных продуктов.
Поддержание жизненного цикла ПО в процессе эксплуатации у Заказчика осуществляется на условиях Договора сопровождения или лицензионного соглашения.
Сопровождение и техническая поддержка ПО осуществляется в целях обеспечения:
1. Корректного функционирования всех компонентов ПО;
2. Отсутствия простоев в работе конечных пользователей̆ по причине невозможности функционирования ПО (вследствие ошибок в работе программного обеспечения, ошибок в работе специалистов Заказчика и т.д.)
Для достижения поставленных целей̆ сопровождение и техническая поддержка ПО включает в себя следующий̆ типовой̆ набор задач:
1. Устранение неисправностей̆ в случае их выявления при работе с ПО;
2. Консультирование пользователей̆ и администраторов ПО по вопросам эксплуатации по электронной̆ почте;
3. Предоставление услуг по установке и настройке компонентов ПО на территории Заказчика;
4. Предоставление услуг по модификации ПО для совместимости с новыми версиями базового системного программного обеспечения Заказчика.

Фактический̆ адрес размещения службы поддержки: 141701, Московская Область, г.о. Долгопрудный, г Долгопрудный, ул Первомайская, д. 3

ОГЛАВЛЕНИЕ

ВВЕДЕНИЕ
НАЗНАЧЕНИЕ ДОКУМЕНТА
ТРЕБОВАНИЯ К СИСТЕМЕ
ПОРЯДОК УСТАНОВКИ СИСТЕМЫ КОРТЕКС.МАРШРУТИЗАТОР
ПОРЯДОК РАЗВЕРТЫВАНИЯ СИСТЕМЫ КОРТЕКС.МАРШРУТИЗАТОР                                   
КОНТАКТЫ ИСПОЛНИТЕЛЯ


ВВЕДЕНИЕ

Система КОРТЕКС.Маршруты. - это инструмент, предназначенный для оптимального планирования расписания, организации маршрутов и распределения трудовых ресурсов, осуществляющих доставку.

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


НАЗНАЧЕНИЕ ДОКУМЕНТА

Данный документ представляет собой описание действий, которые необходимо совершить для установки и развертывания системы КОРТЕКС.Маршруты.

ТРЕБОВАНИЯ К СИСТЕМЕ

1. Любая ОС, поддерживающая программную среду Docker версии не ниже 27.4.0.
2. Наличие приложения для опытных пользователей и разработчиков, которое дает возможность взаимодействовать с операционной системой через интерфейс командной строки. Например, Терминал.

ПОРЯДОК УСТАНОВКИ СИСТЕМЫ
 КОРТЕКС.МАРШРУТИЗАТОР

1.   Создать папку qoretex
2.   Скачать и сохранить в папке qoretex образ qoretex.routing.tar
3.   Установить и запустить программную среду Docker Desktop
4.   Открыть Терминал
5.   Зайти посредством Терминала в папку qoretex
6.   Загрузить образ qoretex.routing.tar в среду Docker посредством ввода в командную строку терминала следующей команды:
docker load--input ./qoretex.routing.tar


После успешной загрузки в Терминале отобразится сообщение
Loaded image: qoretex.routing: 1.0.0


7. Проверить, что в списке доступных образов появился qoretex.routing при помощи команды dockerimages


Система выдаст информацию о наличии qoretex.routing


Теперь образ системы КОРТЕКС.Маршрутизатор установлен и можно перейти к ее развертыванию.


ПОРЯДОК РАЗВЕРТЫВАНИЯ СИСТЕМЫ КОРТЕКС.МАРШРУТЫ

1. В директории qoretex cоздать новую директорию data, в которую пользователь разместит необходимые для расчета данные и куда система запишет результаты расчетов и логи.

2. Находясь в Терминале в директории qoretex вести в команду:
docker run -v ./data:/opt/qore/routing/data -it --name qoretex.routing qoretex.routing:1.0.0


В командной строке появится информация о входе в контейнер:


3. Проверить, что контейнер запущен, можно следующим образом:

1) параллельно с окном запуска контейнера открыть новое (второе) окно
Терминала, не закрывая при этом окно запуска контейнера

2) ввести в новом окне команду «docker ps»


Если контейнер запущен, то система отразит это в текущем статусе, обозначив его как „UP“. В приведенном ниже примере система отобразила, что контейнер запущен 6 секунд назад.



Теперь система КОРТЕКС.Маршруты установлена, развернута и можно приступать администрированию системы, планированию расписания, организации маршрутов и распределению трудовых ресурсов, осуществляющих доставку.


КОНТАКТЫ ИСПОЛНИТЕЛЯ

Техническая поддержка:
Электронная почта:servicemail@qore-llc.pro

ОГЛАВЛЕНИЕ

НАЗНАЧЕНИЕ ДОКУМЕНТА
ИСХОДНАЯ НАСТРОЙКА СИСТЕМЫ
РЕЗУЛЬТАТЫ РАСЧЕТА И ЛОГИРОВАНИЕ
НАСТРОЙКА АПИ
КОНТАКТЫ ИСПОЛНИТЕЛЯ


НАЗНАЧЕНИЕ ДОКУМЕНТА

Данное руководство описывает действия администратора по скачиванию, установке, работе и поддержке системы КОРТЕКС.Маршруты.


ИСХОДНАЯ НАСТРОЙКА СИСТЕМЫ

Действия администратора системы по установке, развертыванию, первоначальной настройке приложения описаны в отдельном документе „Руководство по установке системы КОРТЕКС.Маршруты “


РЕЗУЛЬТАТЫ РАСЧЕТА И ЛОГИРОВАНИЕ

Результат расчета и логи сохраняются в выходную директорию, указанную при развертывании контейнера «routing_result.csv» и «log.txt» соответственно.


НАСТРОЙКА АПИ

Для корректной работы системы КОРТЕКС.Маршруты необходимо:

1) Создать директорию (data), в которой пользователь разместит необходимые для расчета данные, куда будут записаны результаты расчета и соответствующие логи.

2) связать созданную директорию data с директорией контейнера. Для этого при развертывании контейнера необходимо указать -v /{path_to_directory_}/data:/opt/qore/routing/data, где «path_to_directory_» - путь к созданной ранее папке data.


В приведенном примере команда docker run -v ./data:/opt/qore/routing/data -it - -name qoretex.routing qoretex.routing:1.0.0 выполняется из директории, в которой находится папка data, поэтому между -v и косой чертой указан символ пробела и точка.


Техническая поддержка:

Электронная почта: servicemail@qore-llc.pro

ОГЛАВЛЕНИЕ

ВВЕДЕНИЕ
НАЗНАЧЕНИЕ ДОКУМЕНТА
ТРЕБОВАНИЯ К ДАННЫМ,ЗАПУСКАЕМЫМ В ОБРАБОТКУ
1. ПОРЯДОК ЗАПУСКА ЗАДАЧ В ОБРАБОТКУ
1.1. Подготовка контейнера для загрузки задачи
1.2. Запуск задачи для расчета
1.3. Получение результатов расчета
ОПИСАНИЕ ПОЛУЧЕННЫХ ДАННЫХ
КОНТАКТЫ ИСПОЛНИТЕЛЯ


ВВЕДЕНИЕ

Система КОРТЕКС.Маршруты. - это инструмент, предназначенный для оптимального планирования расписания, организации маршрутов и распределения трудовых ресурсов, осуществляющих доставку.

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


НАЗНАЧЕНИЕ ДОКУМЕНТА

Данное руководство описывает действия пользователя по работе с системой КОРТЕКС.Маршруты.


ТРЕБОВАНИЯ К ДАННЫМ, ЗАПУСКАЕМЫМ В ОБРАБОТКУ

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

1.  Геоданные
2.  Данные по курьерам
3.  Данные по заказам

Геоданные должны описывать следующую необходимую информацию:
a.  Местоположение центров изохрон
b.  Геометрическая форма изохрон
c.  Расстояния между центрами изохрон (метрические и временные)

Геоданные представляются в соответствующих файлах:
a.  moscow_grid.geojson
b.  moscow_isochrones.geojson
c.  distance_matrix_part*.csv(файлов может быть несколько)

Данные по курьерам должны содержать следующую информацию по каждому курьеру:

id — идентификатор курьера
zone — указание соответствующей геозоны или города
transport — тип используемого транспорта
start_latitude — географическая широта стартовой локации курьера
start_longitude — географическая долгота стартовой локации курьера
end_latitude — географическая широта финальной локации курьера
end_longitude — географическая долгота финальной локации курьера
start_time — время начала рабочей смены курьера (Unixstamp, кол-во миллисекунд от 01-01-1970)
end_time — время окончания рабочей смены курьера (Unixstamp, кол-во миллисекунд от 01-01-1970)

Данные по курьерам представляются в файле couriers.csv в формате csv, где заголовками выступают описанные выше именования типов данных.


Данные по заказам должны описывать следующую информацию по каждому заказу:

id — идентификатор заказа
zone — указание соответствующей геозоны или города
address — адрес в текстовом виде с указанием индекса, города, улицы, дома
latitude — географическая широта локации адреса заказа
longitude — географическая долгота локации адреса заказа
start_time — крайнее время начала обработки заказа (Unixstamp, кол-во миллисекунд от 01-01-1970)
end_time — крайнее время окончания обработки заказа (Unixstamp, кол-во миллисекунд от 01-01-1970)
duration_time — длительность обработки заказа (кол-во миллисекунд)

Данные по курьерам представляются в файле orders.csv в формате csv, где заголовками выступают описанные выше именования типов данных.


1. ПОРЯДОК ЗАПУСКА ЗАДАЧ В ОБРАБОТКУ

1.1. Подготовка контейнера для загрузки задачи
1.  Открыть Терминал или любое другое приложение, позволяющее напрямую вводить команды
2.  Запустить контейнер

а) Если контейнер запускается в первый раз, то ввести в командной строке Терминала следующую команду:
docker run -v /{path_to_}/data:/opt/qore/routing/data -it --name


qoretex.routingqoretex.routing:1.0.0

Вместо «path_to_» указывается путь к папке data. В приведенном примере папка data находится в директории documents.


В командной строке появится информация о входе в контейнер:

б)Если контейнер уже запускался и сохранен в системе, то в Терминале необходимо ввести команду:


docker start -ai qoretex.routing


В командной строке появится информация о входе в контейнер:


1.2. Запуск задачи для расчета

1.  Поместить данные, необходимые для расчета задачи, в связанную с контейнером директорию data. Адрес нахождения директории необходимо уточнить у администратора, занимавшегося установкой системы КОРТЕКС.Маршруты и создавшего данную директорию.

2.  Для запуска процесса расчета вести в Терминале команду:
./qoretex_routing data


Система сначала начнет загрузку данных, а потом запустит процесс расчета.


1.3. Получение результатов расчета

По окончанию расчета в папке «data» будет создана папка «result», в которую запишутся результаты вычислений (.csv) и логи (.txt)

ОПИСАНИЕ ПОЛУЧЕННЫХ ДАННЫХ

По результатам работы программы формируется файл routes_result.csv с маршрутами для курьеров, представленный в формате csv со следующей спецификацией:

id — идентификатор курьера
time — момент времени в секундах от начала дня (от 0:00)
pos — идентификатор заказа, по которому также можно определить соответствующую локацию
status — статус курьера в данный момент времени (не работает или завершил работу [-1], в ожидании [0], в пути [1], в процессе обработки заказа [2])

Пример содержания файла, описывающего результат:


КОНТАКТЫ ИСПОЛНИТЕЛЯ

Техническая поддержка:
Электронная почта:servicemail@qore-llc.pro