Инструкция пользователя

Базис Маршруты 2.0 помогает восстановить месячный маршрут медицинского представителя по фактическим чекам, справочнику точек и правилам расчета. Итог работы - понятный дневной таймлайн, маршрут на карте, контроль пробега и топлива, а также путевые листы в формате XLSX.

Какие задачи решает приложение

• Хранит карточки менеджеров, автомобили, параметры топлива и справочник точек.
• Создает графики месяцев с рабочими днями, выходными и командировками.
• Вводит фактические чеки за месяц: время, точка, объем заправки.
• Строит дневные цепочки маршрута: старт дня, поездки, встречи, заправки, возврат или ночной переезд.
• Показывает маршрут выбранного дня на карте и в маршрутной таблице.
• Позволяет вручную исправлять время, длительность встреч, расстояния, скорость, топливо и фиктивные визиты.
• Контролирует проблемные места: слишком высокая скорость, нехватка топлива, перелив бака, слишком ранний старт дня.
• Фиксирует проверенные дни, чтобы они не менялись при дальнейших пересчетах.
• Формирует дневной путевой лист на основе сохраненного маршрута.

Общая логика работы

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

Главная страница

Главная страница открывается по адресу /. В верхней шапке всегда доступна кнопка Инструкция пользователя; она открывает эту справку.

Блок "Рабочая область"

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

Блок "Новый расчет"

Используется для создания графика месяца.

1. В поле Менеджер выберите нужного сотрудника.
2. В поле Месяц выберите месяц расчета.
3. Нажмите Добавить график месяца.
4. Если график для такого менеджера и месяца уже существует, приложение откроет существующий месяц.
5. Если график новый, откроется экран редактирования входных данных месяца.

Блок "Графики месяцев"

Здесь отображаются уже созданные месяцы.

• Поле Менеджер фильтрует список по ФИО.
• Поле Месяц фильтрует список по месяцу.
• Найти применяет фильтры.
• Сброс возвращает полный список.
• Открыть месяц переходит на основную рабочую страницу месяца.
• Удалить график доступна только если в месяце нет зафиксированных дней.

Общие настройки

Откройте Общие настройки с главной страницы или из меню месяца. Настройки применяются ко всем менеджерам и последующим расчетам.

Путевой лист

Раздел задает данные, которые печатаются в XLSX-бланке.

• Организация - полная строка организации: название, ИНН, адрес, телефон, ОГРН.
• Должность ответственного - должность лица, которое выводится в блоках контроля.
• Расшифровка подписи - ФИО или инициалы ответственного.

Заполните эти поля до печати путевых листов, иначе бланк будет неполным.

Обычные визиты

Эти параметры определяют, как фактический чек превращается во встречу.

Фиктивные встречи и автоподбор

Фиктивные встречи помогают добрать маршрут до реалистичного количества визитов и пробега, если фактических чеков мало.

• Целевое количество визитов в день - сколько визитов приложение старается получить в рабочем дне.
• Фиктивная встреча: минимум - минимальная длительность вставленной встречи.
• Фиктивная встреча: максимум - максимальная длительность вставленной встречи.

Специальные точки

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

• В полях До чека задается допустимое время пребывания до фактического чека.
• В полях После чека задается допустимая пауза от чека до отъезда.

Рабочий день и топливо

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

Повторы точек в автоподборе

• Пауза для кафе и точек отдыха запрещает слишком частое повторение одной и той же точки отдыха.
• Пауза для клиник и офисов делает то же самое для рабочих офисных точек.

Внешний вид таймлайна

Выберите цветовую схему. Она влияет только на отображение таймлайна и не меняет расчет.

Интеграции

Поле Yandex Geocoder: API-ключ включает получение координат по адресу и поиск мест на карте. Если на сервере задана переменная окружения YANDEX_GEOCODER_API_KEY, она имеет приоритет над значением из формы.

После изменения настроек нажмите Сохранить настройки.

Менеджеры и точки

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

Карточка водителя и автомобиля

Заполните:

• Имя - ФИО менеджера.
• СНИЛС, Табельный номер, Водительское удостоверение - реквизиты для путевого листа.
• Марка, тип и модель автомобиля.
• Государственный номерной знак.
• Вместимость бака, л.
• Расход, л/100км.
• Средняя скорость, км/ч.
• Макс. коэфф. пробок.
• Коэфф. кривизны дорог.

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

Справочник точек

Каждая строка таблицы - одна точка маршрута.

Важные правила:

• Точка HOME должна быть ровно одна.
• HOTEL и AIRPORT допускаются максимум по одной точке каждого типа.
• Названия точек должны быть уникальными у одного менеджера.
• Координаты можно вводить через точку или запятую.

Типы точек

• HOME - основной дом или парковка, стандартный старт и финиш дня.
• ALTERNATIVE_HOME - дополнительная домашняя точка.
• HOTEL - отель для командировок.
• AIRPORT - аэропорт.
• GAS_STATION - АЗС.
• VISIT_OFFICE - рабочая точка, клиника, офис клиента.
• VISIT_REST - кафе, ресторан, отдых, мойка и похожие вспомогательные точки.

Работа с картой точек

Правая панель показывает точки на карте.

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

После правок нажмите Сохранить менеджера или Создать менеджера. Кнопка Отмена возвращает назад без сохранения.

График работы месяца

Экран открывается кнопкой График работы на странице месяца или автоматически после создания нового графика.

Входные данные

• Месяц - период в формате YYYY-MM.
• Одометр на начало месяца, км - стартовое показание.
• Остаток топлива на начало, л - стартовый бак.
• Одометр задан вручную - включает ручной стартовый одометр. Для нового месяца приложение может подставлять расчетный конец предыдущего месяца.

Календарь

Над календарем есть режимы:

• Рабочий.
• Выходной.
• Командировка на авто.
• Командировка без авто.
• Очистить.

Последовательность настройки:

1. Выберите нужный режим.
2. Кликните по датам, которым нужно назначить этот режим.
3. Повторите для всех исключений.
4. Если режим не выбран, клик по дате только выделяет день для настройки начала и окончания.
5. Проверьте счетчики рабочих, выходных и командировочных дней.

Настройка выбранного дня

Справа от календаря находится панель дня.

• Место начала дня задает start-anchor: дом, альтернативный дом, отель, аэропорт.
• Точка начала дня появляется, если выбран режим, которому нужна конкретная точка.
• Индивидуальный минимум начала дня переопределяет самое раннее время старта только для выбранной даты.
• Место окончания дня задает end-anchor: дом, альтернативный дом, отель, аэропорт или В пути на авто.
• Точка окончания дня появляется для режимов с конкретной точкой.

Режим В пути на авто нужен, когда день заканчивается не возвращением домой, а ночным переездом до 24:00.

После настройки нажмите Сохранить изменения.

Фактические чеки

Экран открывается кнопкой Факт-чеки на странице месяца.

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

Таблица чеков

В каждой строке:

• Дата и время - вводится в формате dd.MM.yy HH:MM.
• Точка - выбирается из справочника менеджера через поле поиска.
• Топливо, л - заполняется только для заправок или других чеков с объемом топлива.
• Удалить - помечает строку к удалению.

Как добавить чек

1. Нажмите Добавить строку.
2. Укажите дату и время.
3. В поле точки начните вводить название, id или тип.
4. Выберите точку из выпадающего списка.
5. Если это заправка, укажите объем топлива.
6. Нажмите Сохранить чеки.

Если нужной точки нет в списке, сначала откройте Менеджер и точки, добавьте ее, сохраните менеджера и вернитесь к факт-чекам.

Страница месяца

Страница месяца - основной рабочий экран. Она открывается кнопкой Открыть месяц.

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

Липкое меню

• Назад и Вперед отменяют и возвращают ручные изменения таймлайна.
• К сохраненному откатывает отображение к последнему сохраненному состоянию.
• Сохранить текущее состояние записывает текущий таймлайн в базу.
• Скрыть карту показывает или скрывает карту выбранного дня.
• Скрыть таблицу показывает или скрывает маршрутную таблицу дня.
• Скрыть таймлайн показывает или скрывает месячный таймлайн.
• График работы открывает календарь и дневные якоря.
• Факт-чеки открывает редактор чеков.
• Менеджер и точки открывает карточку менеджера и справочник точек.
• Настройки открывает общие настройки.
• К списку месяцев возвращает на главную.

Если расчет еще не построен, на странице будет предложено запустить шаг построения маршрута.

Таймлайн месяца

Таймлайн показывает каждый день строкой от 00:00 до 24:00.

Что видно на строке дня

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

Масштаб и подписи

В панели таймлайна доступны масштабы 24ч, 12ч, 6ч, 3ч. Чем меньше интервал, тем крупнее видны детали.

Переключатели:

• Скорость включает подписи скорости на поездках.
• Расстояние включает километраж.
• Литры включает расход топлива.
• Длительность встреч включает длительность встреч.
• График бака показывает или скрывает топливный график.

Над таймлайном также работает Ctrl + колесо мыши для изменения масштаба.

Меню дня

Кнопка ... у даты открывает действия:

• Путевой лист скачивает XLSX для дня, если день готов к печати.
• Загрузить исходные данные пересобирает день из фактических чеков и настроек.
• Автоподбор подбирает фиктивную встречу или несколько встреч.
• Растянуть визиты распределяет доступное время по встречам.

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

Ручные правки на таймлайне

На таймлайне можно корректировать маршрут мышью.

• Перетаскивайте границы встреч, чтобы изменить время начала или окончания.
• Перетаскивайте некоторые полосы встреч, чтобы сдвинуть их внутри доступного окна.
• Используйте кнопку удаления у фиктивной встречи, чтобы убрать ее из дня.
• Кликайте по маркеру фактического чека, чтобы перейти к строке этого чека в редакторе.
• Если возле стартового маркера есть предупреждение, откройте его и примените предложенное время начала дня либо настройте день вручную в График работы.

После важных ручных правок нажмите Сохранить текущее состояние.

Карта выбранного дня

Карта показывает маршрут дня. День выбирается кликом по дате в таймлайне или стрелками в заголовке карты.

На карте видны точки, поездки и состояние топлива. Заголовок карты содержит:

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

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

Маршрутная таблица дня

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

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

Топливо

Топливо считается от начального остатка месяца.

Расчет учитывает:

• расход автомобиля;
• расстояние поездок;
• заправки из факт-чеков;
• вместимость бака;
• минимальный резерв из настроек.

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

Фиксация дня

Фиксация означает, что день проверен и защищен от изменений.

Когда фиксировать:

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

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

Путевой лист

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

Перед печатью проверьте:

• заполнены реквизиты в Общие настройки;
• заполнены данные водителя и автомобиля в карточке менеджера;
• день построен, сохранен и зафиксирован;
• нет нарушений по топливу и скорости;
• маршрутная таблица содержит корректный возврат или корректный ночной переезд.

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

Рекомендуемый ежедневный сценарий проверки месяца

1. Откройте месяц с главной страницы.
2. Если данных еще нет, заполните График работы, Менеджер и точки, Факт-чеки.
3. Запустите построение маршрута.
4. Откройте первый рабочий день.
5. Проверьте таймлайн, карту и таблицу.
6. Если визитов мало, используйте Автоподбор.
7. Если встречи слишком короткие или день выглядит сжатым, используйте Растянуть визиты.
8. Исправьте предупреждения по старту дня.
9. Проверьте скорость, пробег и топливо.
10. Нажмите Сохранить текущее состояние.
11. Нажмите Зафиксировать.
12. Скачайте Путевой лист, если он нужен сразу.
13. Перейдите к следующему дню стрелками на карте или таблице.

Типичные проблемы и что делать

Что важно помнить

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