Обмен данными с веб-сервисом «Департамент логистики

Введение
Рабочее место водителя представляет собой мобильное приложение к веб-сервису «Департамент
логистики» http://logdep.ru.
Назначением мобильного приложения:



Предоставить водителю информацию о маршруте из веб-сервиса «Департамент
логистики»
Отмечать статусы выполнения заказов
Обмениваться сообщениями с диспетчеров
Общие требования



Основной интерфейс должен быть разработан с использованием библиотеки jquery mobile
(В данном документе приведен схематичный дизайн приложения. При разработке
необходимо использовать стандартные компоненты и стили.)
Приложение должно корректно выглядеть и работать как на смартфонах, так и на
планшетах, как в портретном так и в ландшафтном варианте
Должна поддерживаться возможность смены языка интерфейса
Обобщенный процесс работы







Логист вечером предыдущего дня формирует рейсы для каждого водителя:
o Рейсов может быть несколько
o Каждый рейс имеет реквизиты:
 ДатаВремя выезда,
 Место начала рейса (адрес и географические координаты)
 Список точек маршрута (адрес, координаты). Каждая точка маршрута
содержит список заказов, которые необходимо доставить в эту точку.
 Плановое время прибытия в точку маршрута и т.д.
Утром, водитель запускает мобильное приложение и авторизуется (см. Авторизация)
После авторизации на экране отображается список рейсов на сегодня (см. Список рейсов)
Водитель выбирает рейс, по которому он поедет и на экране отображается маршрут рейса
(см. Рейс)
Водитель просматривает маршрут и выбирает точку в которую он поедет (кликает по
строке маршрута), при этом на экране отображаются свойства точки рейса (см. Точка
рейса)
Водитель нажимает на кнопку «Ехать», при этом вызывается внешний навигатор и ему
(навигатору) устанавливается конечная точка (координаты выбранной точки маршрута)
Когда водитель приезжает в точку маршрута и выполняет необходимые действия, в
мобильном клиенте он проставляет статус выполнения задания, затем переходит к
следующему заданию.
Обмен данными с веб-сервисом «Департамент логистики»
Все запросы отправляемые в веб-сервис «Департамент логистики» должны отправляться на
сервер http://vrp.logdep.ru/dl/storage/ А в случае недоступности основного сервера на резервный:
http://vrp1.logdep.ru/dl/storage/. Команда представляет собой текст в формате JSON, и передается
в теле POST-запроса. Результат выполнения возвращается также в формате JSON.
Функциональность
Авторизация
Для авторизации у пользователя запрашиваются данные:



Код клиента
Имя пользователя
Пароль
После успешной авторизации, введенные данные должны сохраняться и не запрашиваться при
повторном запуске.
Обмен с сервером
Для авторизации вызывается функция TL_Mobile_LoginRequest (см. описание API). При успешной
авторизации в ответ возвращается идентификатор сессии SessionId. Этот идентификатор
необходимо использовать во всех последующих запросах.
Список рейсов
В списке рейсов, отображаются все рейсы на текущую дату.
Обмен с сервером
Для запроса списка рейсов необходимо использовать функцию TL_Mobile_EnumRoutesRequest
(см. описание API). В ответ сервер возвращает список рейсов. Детальную информацию о каждом
рейсе необходимо получить при помощи функции TL_Mobile_GetRoutesRequest . В детальной
информации возвращается маршрут рейса и информация о заказах. Детальную информацию о
каждом заказе необходимо получить вызовом функции TL_Mobile_GetOrdersRequest.
Рейс
На экране маршрута рейса отображается сводная информация по рейсу в целом и список точек
маршрута рейса. При клике по строке маршрута рейса открывается экран «Точка рейса».
PS: Желательно, что бы шапка рейса (сводная информация о рейсе) не прокручивалась, а список
рейса, соответственно прокручивался.
Возврат на страницу
списка рейсов
Шапка рейса (сводная
информация о рейсе)
Выполненная точка
маршрута становится
бледной
1. При клике по строке маршрута, открывается страница «Точка рейса»
2. Кнопка «Ехать» вызывает внешний навигатор и устанавливает ему точку финиша
3. Статус рейса определяется как «Завершен», если все точки рейса выполнены полностью
или частично.
4. Выполненные (и частично выполненные) точки маршрута должны стать бледными или
как-то обесцвечивать (может быть убрать всю раскраску и все вывести серым)
Точка рейса
На странице «Точка рейса» отображается информация о задании в текущей точке, а так же список
заказов в этой точке.
1. Если пользватель нажимает на кнопку «Установить статус» в шапке точки маршрута, то
выранный статус автоматически проставляется у всех заказов в этой точке
2. Если пользователь нажимает кнопку «Установить статус» в строке заказа, то этот статус
устанавливается только у этого закза.
3. При установке статуса открывается модальная форма «Форма выбора статуса»
Статус можно установить как
у точки в целом, так и у
каждого заказа в отдельности
Форма выбора статуса
Форма выбора статус открывается при нажатии на кнопку «Установить статус». При этом
пользователь может задать комментарий.
1. Появляется при любом изменении статуса.
2. Если статус не менять, то будет просто комментарий к точке
3. Внизу отображается уже введенные комментарии к точке