Специальные предложения. Карточка предложения

Тип	Описание
Кнопка «Назад»	Возврат к списку специальных предложений.
Элемент списка предложений	Переход в браузер по внешней ссылке. Действие обрабатывается операционной системой устройства.



Специальные предложения. Boutique

Тип	Описание
Кнопка «Назад»	Возврат к главному экрану.
Расписание мероприятий	Переход в браузер по внешней ссылке. Действие обрабатывается операционной системой устройства.
Номер телефона	Выполняется звонок по указанному номеру телефона. Действие обрабатывается операционной системой устройства.

Список курсов

Тип	Описание
Кнопка «Назад»	Возврат к главному экрану.
Элемент списка курсов	Переход к карточке курса LR Experience.

Карточка курса

Тип	Описание
Кнопка «Назад»	Возврат к списку курсов LR Experience.
Кнопка «Регистрация»	Переход в браузер по внешней ссылке. Действие обрабатывается операционной системой устройства.
Номер телефона	Выполняется звонок по указанному номеру телефона. Действие обрабатывается операционной системой устройства.
Адрес e-mail	Действие обрабатывается операционной системой устройства.

Список партнеров программы лояльности

Тип	Описание
Кнопка «Назад»	Возврат к главному экрану.
Кнопка «Фильтр»	Переход к фильтру справочника партнеров.
Кнопка «На карте»	Переход к справочнику партнеров на карте.
Элемент списка партнеров	Переход к карточке партнера.
Километраж	Построение маршрута. Действие обрабатывается операционной системой устройства.

Список партнеров программы лояльности на карте

Тип	Описание
Кнопка «Назад»	Возврат к главному экрану.
Кнопка «Фильтр»	Переход к фильтру справочника партнеров.
Кнопка «Список»	Переход к справочнику партнеров списком.
Всплывающее окно партнера	Переход к карточке партнера.
Километраж на всплывающем окне партнера	Построение маршрута. Действие обрабатывается операционной системой устройства.

Список партнеров программы лояльности. Фильтр

Тип	Описание
Кнопка «Назад»	Установка фильтра и переход к справочнику партнеров.
Кнопка «Сбросить»	Сбрасывает все установленные галочки

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

Тип	Описание
Кнопка «Назад»	Возврат к справочнику партнеров.
Внешняя ссылка	Переход в браузер по внешней ссылке. Действие обрабатывается операционной системой устройства.
Километраж, кнопка «Маршрут»	Построение маршрута. Действие обрабатывается операционной системой устройства.
Номер телефона	Выполняется звонок по указанному номеру телефона. Действие обрабатывается операционной системой устройства.
Адрес e-mail	Действие обрабатывается операционной системой устройства.

Новости партнеров

Тип	Описание
Кнопка «Назад»	Возврат к главному экрану.
Элемент списка предложений	Переход к карточке специального предложения.

Новости партнеров. Карточка новости

Тип	Описание
Кнопка «Назад»	Возврат к списку специальных предложений.
Внешняя ссылка	Переход в браузер по внешней ссылке. Действие обрабатывается операционной системой устройства.
Номер телефона	Выполняется звонок по указанному номеру телефона. Действие обрабатывается операционной системой устройства.

Новости партнеров. Условия использования

Тип	Описание
Кнопка «Назад»	Возврат к главному экрану

Остальное. Выбрать автомобиль

Тип	Описание
Кнопка «Назад»	Возврат к главному экрану.
Внешняя ссылка	Переход в браузер по внешней ссылке. Действие обрабатывается операционной системой устройства.

Остальное. Сувениры

Тип	Описание
Кнопка «Назад»	Возврат к главному экрану.
Внешняя ссылка	Переход в браузер по внешней ссылке. Действие обрабатывается операционной системой устройства.

Остальное. Обратная связь

Тип	Описание
Кнопка «Назад»	Возврат к главному экрану.
Кнопка «Отправить»	Запуск процесса отправки запроса о помощи, вывод результата и, в случае успеха, переход к главному экрану

Спроектированы 47 экранов мобильного приложения. К каждому из экранов были разработаны правила переходов, которые описывают механики работы экранов. Все экраны соответствуют предъявленным функциональным требованиям к мобильному приложению (см. п. 3.3 Функциональные требования).



5. Разработка алгоритма функционирования программного блока. Клиентский профиль

5.1 Сущности базы данных

Структура базы данных

5.2 Структура объектов БД (база данных) профиля пользователя, возвращаемых сервером

Примечание. Звёздочка после описания поля означает его обязательность:

Customer

string LastName Фамилия*

string FirstName Имя*

string Patronymic Отчество

date BirthDate Дата рождения (yyyy-mm-dd)*

string Sex Пол (M/F)*

string Email E-mail*

string Phone Телефон*

string PostIndex Почтовый индекс*

string Country Страна*

string Region Регион*

string District Район

string City Город*

string SubCity Населенный пункт

string Street Улица*

string House Дом*

string Building Строение

string Korpus Корпус

string Apartment Квартира

string ExtraAddress Дополнительная адресная информация

string array Vins VIN*

Result

boolean Success Результат (true/false)

string Comment Комментарий к результату

NameRef

string Name Имя

string Sex Пол (M/F)

CityRef

string Code Код КЛАДР

string PostIndex Почтовый индекс

string Region Регион

string District Район

string City Город

string SubCity Населенный пункт

StreetRef

string Code Код КЛАДР

string PostIndex Почтовый индекс

string Street Улица

Car

string Brand Марка

string ModelId Идентификатор модели

(из справочника ModelList)

string Model Модель

string Year Модельный год

string Derivative Дериватив

string Transmission КПП

string Color Цвет

string Options Пакет опций (до 17 опций)

ModelList

string Id Идентификатор модели

string Name Название модели

Repair

string Id ID сервисного обслуживания

string RepairNumber Номер заказ-наряда

string RepairDate Дата заказ-наряда

string Probeg Пробег на момент обслуживания

string Dealer Дилер, выполнявший обслуживание

RepairDetails

string RepairType Тип ремонта (платный, гарантийный)

string Code Код (операции, запчасти)

string Description Наименование (операции, запчасти)

string Value Количество

string Measure Единица измерения

TO

string Name Наименование ТО

string Probeg Пробег, км

string Months Время после покупки, месяцев

Manual

string Name Наименование руководства

string ManualURL Ссылка на файл руководства

5.3 Список endpoint'ов

Список endpoint'ов API - кто какие аргументы воспринимает и какой ответ ожидается.

(POST) Register

Назначение: Регистрация новых пользователей в личном кабинете.

При формировании объекта Customer имеется ограничение: в массиве номеров Vins необходимо указывать не более одного номера VIN, все остальные игнорируются.

Входные параметры: объект Customer, имя пользователя и пароль

{

“UserName”: “ivan@mail.ru”,

“Password”: “123456”,

“Customer”:

{

“LastName”: “Иванов”,

“FirstName”: “Петр”,

“Patronymic”: “Алексеевич”,

“BirthDate”: “1970-04-17”,

“Sex”: “M”,

“Email”: “ivan@mail.ru”,

“Phone”: “79012345678”,

“PostIndex”: “123456”,

“Country”: “Россия”,

“Region”: “Московская обл.”,

“District”: “Ногинский р-н”,

“City”: “Ногинск г.”,

“SubCity”: “”,

“Street”: “Ленина ул.”,

“House”: “23”,

“Building”: “”,

“Korpus”: “”,

“Apartment”: “45”,

“ExtraAddress”: “”,

“Vins”: [

“SALFA212334534534”

]

}

}

Результат: объект Result

{

“Result”:

{

“Success”: “true”,

“Comment”: “Пользователь успешно зарегистрирован”

}

}

В случае, когда система находится в ожидании ПТС от регистрируемого пользователя, который, однако, прошёл однажды процедуру регистрации, в объекте Result свойство Comment будет выглядеть так: "Waiting for PTS. Used to register the vehicle's VIN belongs to the client with a different name and / or last name, or has not yet received information about the sale of the dealer"

Примечание 2. При регистрации следующие данные проверяются на непустоту: UserName, Password, LastName, FirstName, Sex, Email, Phone, City, Country. Email и Phone должны содержать по одному адресу Email и номеру телефона соответственно.

Сообщения об ошибках

№	Текст ошибки	Примечание
1.	Login or password is not defined.	Не предоставлен логин и/или пароль
2.	UserName occupied	Предоставленный логин уже есть в системе
3.	JSON error description: [системное сообщение]	Ошибка преобразование JSON, описание ошибки, предоставленное системой
4.	Registration error. Description: [системное сообщение]	Общая ошибка, описание ошибки, предоставленное системой
5.	The following data is not available or has an invalid format: [список полей]	Список полей, которые пусты или имеют неверный формат, в то время как они являются обязательными
6.	Provided an invalid VIN	VIN не предоставлен или имеет неверный формат
7.	Waiting for PTS. Used to register the vehicle's VIN belongs to the client with a different name and / or last name, or has not yet received information about the sale of the dealer	Пользователь зарегистрирован, но ожидается ПТС. Возможно, VIN принадлежит иному зарегистрированному в системе лицу.
8.	User successfully registered	Пользователь успешно зарегистрирован в системе.

(POST) Authenticate

Назначение: Вход в личный кабинет

Входные параметры: имя пользователя и пароль

{

“UserName”: “ivan@mail.ru”,

“Password”: “123456”

}

Результат: объекты Result, Customer (последний присутствует только в случае успешной аутентификации) и идентификатор сеанса при успешном входе

{

“Result”:

{

“Success”: “true”,

“Comment”: “Вход выполнен”

},

“Customer”:

{

“LastName”: “Иванов”,

“FirstName”: “Петр”,

“Patronymic”: “Алексеевич”,

“BirthDate”: “1970-04-17”,

“Sex”: “M”,

“Email”: “ivan@mail.ru”,

“Phone”: “9012345678”,

“PostIndex”: “123456”,

“Country”: “Россия”,

“Region”: “Московская обл.”,

“District”: “Ногинский р-н”,

“City”: “Ногинск г.”,

“SubCity”: “”,

“Street”: “Ленина ул.”,

“House”: “23”,

“Building”: “”,

“Korpus”: “”,

“Apartment”: “45”,

“ExtraAddress”: “”,

“Vins”: [

“SALFA212334534534”

]

},

“SessionId”: “AAC2F187-C78F-415C-9CF4-7149302ED7B6”

}

В случае, когда система находится в ожидании ПТС от зарегистрированного пользователя в объекте Result свойство Comment будет выглядеть так: "Waiting for PTS. The account is not active yet. Used to register the vehicle's VIN belongs to the client with a different name and / or last name, or has not yet received information about the sale of the dealer"



Сообщения об ошибках

№	Текст ошибки	Примечание
1.	Invalid couple login / password	Не предоставлен логин и/или пароль
2.	The account is not activated yet	Аккаунт не активирован
3.	The account is locked	Аккаунт заблокирован
4.	Error: [системное сообщение]	Общая ошибка, описание ошибки, предоставленное системой
5.	Authentication failed. The reason for the error is not available	Сбой аутентификации.
6.	Authentication is performed	Аутентификация выполнена успешно
7.	Waiting for PTS. The account is not active yet. Used to register the vehicle's VIN belongs to the client with a different name and / or last name, or has not yet received information about the sale of the dealer	Пользователь зарегистрирован, но ожидается ПТС. Возможно, VIN принадлежит иному зарегистрированному в системе лицу.

(POST) RecoverPsw

Назначение: Восстановление пароля пользователя с отправкой нового пароля по электронной почте

Входные параметры: имя пользователя

{

“UserName”: “ivan@mail.ru”

}

Результат: объект Result

{

“Result”:

{

“Success”: “true”,

“Comment”: “Пароль сброшен ”

}

}



Сообщения об ошибках

№	Текст ошибки	Примечание
1.	This username is not registered	Пользователь с таким логином не зарегистрирован в системе
2.	The account with this login is not activated yet	Аккаунт не активирован
3.	The account with this login is locked	Аккаунт заблокирован
4.	Error: [системное сообщение]	Общая ошибка, описание ошибки, предоставленное системой
5.	Password reset	Пароль успешно сброшен
6.	Waiting for PTS. The account with this login is not yet activated. Used to register the vehicle's VIN belongs to the client with other data	Пользователь зарегистрирован, но ожидается ПТС. Возможно, VIN принадлежит иному зарегистрированному в системе лицу.

(POST) ChangePassword

Назначение: Восстановление пароля пользователя с отправкой нового пароля по электронной почте

Входные параметры: имя пользователя:

{

“SessionId”: “AAC2F187-C78F-415C-9CF4-7149302ED7B6”,

“OldPassword”: “abcd”,

“NewPassword”: “123”

}

Результат: объект Result

{

“Result”:

{

“Success”: “true”,

“Comment”: “Пароль изменён”

}

}

Сообщения об ошибках

№	Текст ошибки	Примечание
1.	New Password Equals Old	Новый пароль тождествен старому
2.	User with OldPassword does not exist	В системе не найден пользователь, имеющий старый пароль
3.	Password policy error	Ошибка проверки надёжности пароля
4.	Error: [системное сообщение]	Общая ошибка, описание ошибки, предоставленное системой
5.	Password shanged	Пароль успешно сброшен
6.	Unable to retrieve data about the user, possibly, the session is closed	Невозможно получить данные о пользователе, возможно, сессия закрыта.
7.	Wrong format of the session identifier	Ошибочный формат идентификатора сессии

(GET) ValidateVIN

Назначение: Проверка VIN-номера автомобиля на валидность

Входные параметры: строка с VIN-номером автомобиля

{

“VIN”: “SALFA212334534534”

}

Результат: объект Result

{

“Result”:

{

“Success”: “false”,

“Comment”: “VIN указан с ошибкой”

}

}

Сообщения об ошибках

№	Текст ошибки	Примечание
1.	The above is valid VIN	VIN прошёл проверку
2.	VIN Unknown error	Неизвестная ошибка проверки VIN

(GET) CheckLoginFree. Назначение: Проверка, что указанный пользователем e-mail (используется в качестве логина) еще не был зарегистрирован в системе

Входные параметры: строка с именем пользователя

{

“UserName”: “ivan@mail.ru”

}

Результат: объект Result

{

“Result”:

{

“Success”: “true”,

“Comment”: “Свободно”

}

}

Сообщения об ошибках

№	Текст ошибки	Примечание
1.	UserName free	Логин свободен
2.	UserName occupied	Логин занят

(GET) GetFirstNames

Назначение: Поиск в справочнике имен по начальным буквам имени человека

Входные параметры: строка с начальными буквами имени человека и полом (последнее опционально)

{

“Prefix”: “ал”,

“Sex”: “M”,

“Count”: 10

}

Результат: массив объектов типа NameRef

{

“Names”: [

{

“Name”: “Александр”,

“Sex”: “M”

},

{

“Name”: “Алексей”,

“Sex”: “M”

}

]

}

(GET) GetPatronymics

Назначение: Поиск в справочнике отчеств по начальным буквам отчества человека

Входные параметры: строка с начальными буквами отчества человека и полом (последнее опционально)

{

“Prefix”: “ал”,

“Sex”: “M”,

“Count”: 10

}

Результат: массив объектов типа NameRef

{

“Names”: [

{

“Name”: “Александр”,

“Sex”: “M”

},

{

“Name”: “Алексей”,

“Sex”: “M”

}

]

}

(GET) GetEmailDomains

Назначение: Поиск в справочнике почтовых доменов по начальным буквам имени домена

Входные параметры: строка с начальными буквами имени домена (последнее опционально)

{

“Prefix”: “ma”,

“Count”: 10

}

Результат: массив строк с именами доменов

{

“Domains”: [

“mail.ru”,

“masterbank.ru”

]

}

(GET) GetCities

Назначение: Поиск названий городов в справочнике адресов на основе КЛАДР

Входные параметры: строка с начальными буквами города или нас.пункта

{

“Prefix”: “элек”,

“Count”: 10

}

Результат: массив объектов типа CityRef

{

“Cities”: [

{

“Code”: “50001”,

“PostIndex”: “123456”,

“Region”: “Московская обл.”,

“District”: “Ногинский р-н”,

“City”: “Электроугли г.”,

“SubCity”: “”

},

{

“Code”: “50002”,

“PostIndex”: “123457”,

“Region”: “Московская обл.”,

“District”: “”,

“City”: “Электросталь г.”,

“SubCity”: “”

}

]

}

(GET) GetStreets

Назначение: Поиск названий улиц в выбранном ранее городе по его коду в справочнике КЛАДР

Входные параметры: строка с начальными буквами названия улицы и код города/нас.пункта по справочнику КЛАДР

{

“Prefix”: “ми”,

“Code”: “50001”,

“Count”: 10

}

Результат: массив объектов типа StreetRef

{

“Streets”: [

{

“Code”: “50001”,

“PostIndex”: “123456”,

“Street”: “Мира ул.”

},

{

“Code”: “50001”,

“PostIndex”: “123456”,

“Street”: “Мирный пер.”

}

]

}

(POST) UpdateUserProfile

Назначение: Изменение личной информации пользователя

Входные параметры: объект Customer, имя пользователя и пароль

{

“SessionId”: “AAC2F187-C78F-415C-9CF4-7149302ED7B6”,

“Customer”:

{

“LastName”: “Иванов”,

“FirstName”: “Петр”,

“Patronymic”: “Алексеевич”,

“BirthDate”: “1970-04-17”,

“Sex”: “M”,

“Email”: “ivan@mail.ru”,

“Phone”: “9012345678”,

“PostIndex”: “123456”,

“Country”: “Россия”,

“Region”: “Московская обл.”,

“District”: “Ногинский р-н”,

“City”: “Ногинск г.”,

“SubCity”: “”,

“Street”: “Ленина ул.”,

“House”: “23”,

“Building”: “”,

“Korpus”: “”,

“Apartment”: “45”,

“ExtraAddress”: “”,

“Vins”: []

}

}

Параметр Vins данным методом UpdateUserProfile не анализируется.

Результат: объекты Result, Customer (последний присутствует только в случае успешной аутентификации) и идентификатор сеанса при успешном входе

{

“Result”:

{

“Success”: “true”,

“Comment”: “Вход выполнен”

},

“Customer”:

{

“LastName”: “Иванов”,

“FirstName”: “Петр”,

“Patronymic”: “Алексеевич”,

“BirthDate”: “1970-04-17”,

“Sex”: “M”,

“Email”: “ivan@mail.ru”,

“Phone”: “9012345678”,

“PostIndex”: “123456”,

“Country”: “Россия”,

“Region”: “Московская обл.”,

“District”: “Ногинский р-н”,

“City”: “Ногинск г.”,

“SubCity”: “”,

“Street”: “Ленина ул.”,

“House”: “23”,

“Building”: “”,

“Korpus”: “”,

“Apartment”: “45”,

“ExtraAddress”: “”,

“Vins”: [

“SALFA212334534534”

]

}

}

Особенности. Обновление выполняется только тогда, когда сессия пользователя активна.

Сообщения об ошибках

№	Текст ошибки	Примечание
1.	Changing user data made	Данные пользователя успешно изменены
2.	Not fully defined query parameters	Не достаточно предоставленных данных
3.	JSON error description: [системное сообщение]	Ошибка преобразование JSON, описание ошибки, предоставленное системой
4.	Error: [системное сообщение]	Общая ошибка, описание ошибки, предоставленное системой

(GET) GetCarDetails

Назначение: Получение детализированной информации об автомобиле на основе его VIN-номера

Входные параметры: VIN автомобиля, ключ сеанса

{

“SessionId”: “AAC2F187-C78F-415C-9CF4-7149302ED7B6”,

“Vin”: “SALFA212334534534”

}

Результат: объект Car (если указанный VIN не принадлежит данному владельцу, то объект Car будет отсутствовать)

{

“Car”:

{

“Brand”: “Land Rover”,

“ModelId”: “3”,

“Model”: “Discovery 4”,

“Year”: “2012”

“Derivative”: “Range Rover TDV8 4.4 Vogue”

“Transmission”: “Auto 8 Speed Trans ZF 8H70”

“Color”: “Santorini Black”

“Options”: [

“2012 Model Year”,

“Active Rear E Differentia”,

“Adaptive Headlights BiXenon”,

...

]

},

“Result”:

{

“Success”: “true”,

“Comment”: “Данные получены”

}

}

Сообщения об ошибках

№	Текст ошибки	Примечание
1.	Запрос выполнен успешно
2.	Unable to retrieve data about the car ( or information is not enabled)	Невозможно получить информацию о транспортном средстве (информация не найдена)
3.	Unable to retrieve data about the user, possibly, the session is closed	Ошибка запроса данных пользователя, возможно закрыта сессия.
4.	Wrong format of the session identifier	Ошибочный формат идентификатора сессии
5.	Error: [системное сообщение]	Общая ошибка, описание ошибки, предоставленное системой

(GET) GetRepairList

Назначение: Получение списка сервисных обслуживаний для автомобиля с заданным VIN-номером.

Примечание. BuyPeriod в выходных результатах есть количество месяцев от даты покупки автомобиля, до даты RepairDate

Входные параметры: VIN автомобиля, ключ сеанса

{

“SessionId”: “AAC2F187-C78F-415C-9CF4-7149302ED7B6”,

“Vin”: “SALFA212334534534

}

Результат: массив объектов Repair

{

“Repairs”: [

{

“Id”: “3222420”,

“RepairNumber”: “RKL-290983”,

“RepairDate”: “2013-10-03”,

“Probeg”: “28192”,

“Dealer”: “Major, Новая Рига 9 км”,

“BuyPeriod”: “112”

},

{

“Id”: “3222420”,

“RepairNumber”: “RKL-290983”,

“RepairDate”: “2012-06-16”,

“Probeg”: “28192”,

“Dealer”: “Major, Новая Рига 9 км”,

“BuyPeriod”: “96”

}

],

“Result”:

{

“Success”: “true”,

“Comment”: “Есть записи о сервисном обслуживании”

}

}

Сообщения об ошибках

№	Текст ошибки	Примечание
1.	Запрос выполнен успешно
2.	В целях безопасности Ваших данных, информация по сервисной истории автомобиля отображается с момента регистрации на сайте или даты регистрации автомобиля в подтверждающих документах
3.	Модель с указанным VIN не принадлежит зарегистрированному клиенту. Для подтверждения необходимо отправить электронную копию ПТС, свидетельства о регистрации или иного подтверждающего владение автомобилем документа на e-mail jaguarlandrover@dmbasis.ru
4.	Идентификатор сессии ошибочен или есть другая причина того, что логин пользователя не был получен
5.	Идентификатор сессии имеет неверный формат
6.	Error: [системное сообщение]	Общая ошибка, описание ошибки, предоставленное системой

(GET) GetRepairDetails

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

Входные параметры: ID сервисного обслуживания, ключ сеанса

{

“SessionId”: “AAC2F187-C78F-415C-9CF4-7149302ED7B6”,

“RepairId”: “3222420

}

Результат: массив объектов RepairDetailsResult

{

“Result”:

{

“Success”: “true”,

“Comment”: “Данные получены”

},

“RepairDetails”: [

{

“RepairType”: “Платный ремонт”,

“Code”: “80.15.42”,

“Description”: “ФИЛЬТР ВЕНТИЛЯЦИИ САЛОНА - ЗАМЕНА”,

“Value”: “0,2”,

“Measure”: “н/ч”

},

{

“RepairType”: “Платный ремонт”,

“Code”: “AJ82766”,

“Description”: “ФИЛЬТР”,

“Value”: “1”,

“Measure”: “шт.”

}

]

}

Сообщения об ошибках

№	Текст ошибки	Примечание
1.	Запрос выполнен успешно
2.	No access to the service history	Нет доступа к сервисной истории
3.	RepairId wrong	Идентификатор RepairiD имеет неверный формат
4.	Unable to determine login by SessionId or invalid SessionId	Идентификатор сессии ошибочен или есть другая причина того, что логин пользователя не был получен
5.	Wrong format of the session identifier	Идентификатор сессии имеет неверный формат
6.	Error: [системное сообщение]	Общая ошибка, описание ошибки, предоставленное системой

(GET) GetTO

Назначение: Информация о периодичности сервисного обслуживания (для автомобиля с заданным VIN-номером).

Входные параметры: ID сервисного обслуживания, ключ сеанса

{

“SessionId”: “AAC2F187-C78F-415C-9CF4-7149302ED7B6”,

“Vin”: “SALFA212334534534”

}

Результат: массив объектов RepairTOResult

{

“Result”:

{

“Success”: “true”,

“Comment”: “Данные получены”

},

“TOName”: “Гарантийное обслуживание на 2013 год”,

“CheckListName”: “Регламент технического обслуживания”,

“FileName”: “RR_check (2012)”,

“TOs”: [

{

“Name”: “Обслуживание A”,

“Probeg”: “8000”,

“Months”: “6”

},

{

“Name”: “Обслуживание A”,

“Probeg”: “12000”,

“Months”: “12”

}

]

}

Сообщения об ошибках

№	Текст ошибки	Примечание
1.	Запрос выполнен успешно
2.	SessionId wrong	Идентификатор SessionId имеет неверный формат
3.	Wrong number of session SessionId, perhaps, the session was closed or does not exist	Идентификатор сессии имеет неверный формат или сессия закрыта/не существует
4.	Unable to find information about maintenance	Не найдена информация о техобслуживании (в БД)
5.	Unable to find information about model	Не найдена информация о модели (в БД)
5.	Error: [системное сообщение]	Общая ошибка, описание ошибки, предоставленное системой

(GET) AddCar

Назначение: Информация о периодичности сервисного обслуживания (для автомобиля с заданным VIN-номером).

Входные параметры: ID сервисного обслуживания, ключ сеанса

{

“SessionId”: “AAC2F187-C78F-415C-9CF4-7149302ED7B6”,

“Vin”: “SALFA212334534534”

}

Результат: объект RepairTOResult

{

“Result”:

{

“Success”: “true”,

“Comment”: “Запрос выполнен успешно” UpdateUserProfile

}

}

Сообщения об ошибках

№	Текст ошибки	Примечание
1.	Model is in Active state	Модель в статусе «не активна»
2.	Model exists	Модель уже существует
3.	Model added	Модель успешно добавлена
4.	The session was closed or does not exist	Сессия закрыта или не существует
5.	Wrong format of the SessionId	Ошибочный формат идентификатора сессии
6.	Error: [системное сообщение]	Общая ошибка, описание ошибки, предоставленное системой

(GET) GetManuals

Назначение: Получение списка файлов руководств, сопоставленных модели.

Входные параметры: VIN автомобиля, ключ сеанса

{

“SessionId”: “AAC2F187-C78F-415C-9CF4-7149302ED7B6”,

“Vin”: “SALFA212334534534”

}

Результат: массив объектов Manuual с результатом выполнения запроса Result

{

“Manuuals”: [

{

“Name”: “Правила эксплуатации”,

“ManualURL”: “~/DOC/Правила эксплуатации.pdf”

},

{

“Name”: “Как научиться крутить баранку за 5 минут”,

“ManualURL”: “~/DOC/Как научиться крутить баранку за 5 минут.pdf”

}

],

“Result”:

{

“Success”: “true”,

“Comment”: “Запрос выполнен успешно”

}

}



Сообщения об ошибках

№	Текст ошибки	Примечание
1.	Запрос выполнен успешно
2.	Unable to retrieve brand name by SessionId and VIN	Не удалось получить наименование бренда (марки) автомобиля по идентификатору сессии или VIN
3.	Manuals not found	Руководство не найдено
4.	Unable to retrieve data about the user, possibly, the session is closed	Не удалось получить данные пользователя, возможно сессия закрыта
5.	Wrong format of the SessionId	Ошибочный формат идентификатора сессии
6.	Error: [системное сообщение]	Общая ошибка, описание ошибки, предоставленное системой

(GET) GetAccessories

Назначение: Получение списка файлов, сопоставленных модели.

Входные параметры: VIN автомобиля, ключ сеанса

{

“SessionId”: “AAC2F187-C78F-415C-9CF4-7149302ED7B6”,

“Vin”: “SALFA212334534534”

}

Результат: Ссылка на страницу аксессуаров с результатом выполнения запроса Result

{

“AccessoryURL”: “http://www.kremlin.ru”,

“Result”:

{

“Success”: “true”,

“Comment”: “Запрос выполнен успешно”

}

}

Сообщения об ошибках

№	Текст ошибки	Примечание
1.	Запрос выполнен успешно
2.	Accessories not found	Информация об аксессуарах не найдена
3.	Unable to retrieve data about the user, possibly, the session is closed	Не удалось получить данные пользователя, возможно сессия закрыта
4.	Wrong format of the SessionId	Ошибочный формат идентификатора сессии
5.	Error: [системное сообщение]	Общая ошибка, описание ошибки, предоставленное системой

(GET) SendSMSCode

Назначение: Отправка кода подтверждения в виде SMS на номер телефона, указанный пользователем.

Примечание. Для успешной отправки SMS функцией SendSMSCode номер телефона должен быть с кодом страны без каких-либо разделителей (только цифры и «+» вначале, который может быть опущен), например, так: +79031234567, или так: 79031234567.

Входные параметры: строка с номером мобильного телефона

{

“Phone”: “79101234567”

}

Результат: объект Result и строка с отправленным кодом подтверждения

{

“Result”:

{

“Success”: “true”,

“Comment”: “Код отправлен”

},

“Code”: “1234”

}

Сообщения об ошибках

№	Текст ошибки	Примечание
1.	Code sent	СМС-код отправлен
2.	Error sending code: [системное сообщение]	Ошибка при отправке смс-кода, описание ошибки, предоставлено системой

(POST) AskQuestion

Назначение: Реализация функции обратной связи с клиентами. Клиент может быть неавторизованным. Входные параметры: Фамилия Имя Отчество, код телефонного номера, номер телефона, адрес электронной почты, город проживания, VIN автомобиля, марка автомобиля, город дилера, дилер, текст запроса, тип запроса.

{

“vin”: “SALFA212334534534”,

“fio”: “Иванов Александр Петрович”,

“phoneCode”: “903”,

“phoneNumber”: “1234567”,

“email”: “email@mail.ru”,

“liveCity”: “Москва”,

“brand”: “Land Rover”,

“city”: “Москва”,

“dealer”: “Major”,

“questionText”: “Тестирование”,

“questionType”: “Претензия”

}

Результат: ответ сервиса обратной связи записывается в свойство Text и представляет собой диагностическое сообщение, характеризующее успешность выполнения запроса или причины его невыполнения; в свойство RequestNumber записывается номер заявки; результат вызова сервиса мобильного API помещается в свойство Result

{

“Text”: “Успешно”,

“RequestNumber”: “1234567”,

“Result”:

{

“Success”: “true”,

“Comment”: “Запрос выполнен успешно”

}

}

Сообщения об ошибках

№	Текст ошибки	Примечание
1.	Запрос выполнен успешно
2.	Wrong format of the SessionId	Ошибочный формат идентификатора сессии
3.	Unable to retrieve data about the user, possibly, the session is closed	Не удалось получить данные пользователя, возможно сессия закрыта
4.	Error: [системное сообщение]	Общая ошибка, описание ошибки, предоставленное системой
5.	Ошибка в процессе выполнения запроса	Одна из возможных причин - несоответствие параметров друг другу, например, нет дилеров для указанного бренда в указанном городе и т.п.

(GET) GetCarModels

Назначение: Внутренний справочник моделей

Входные параметры: отсутствуют

Результат: массив объектов типа ModelList

{

“ModelList”: [

{

“Id”: “1”,

“Name”: “Defender”

},

{

“Id”: “2”,

“Name”: “Freelander 2”

}

]

}

5.3 Тестирование мобильного приложения

5.3.1 Сценарии использования (user-case)

User-case

Номер экрана	Название экрана	Сценарии	Правила валидации полей
1	Главный экран до авторизации	§ просмотреть фотографии автомобилей марки § посмотреть специальные предложения для незарегистрированных пользователей
2	Главный экран после авторизации	§ сменить текущий автомобиль. § посмотреть дилеров списком § посмотреть специальные предложения для зарегистрированных пользователей, списком
3	Главное меню	перейти в соцсеть по ссылке
4	Авторизация	авторизоваться	§ обязательные поля должны быть заполнены § пользователь с указанным Email должен быть зарегистрирован в системе § пара email-пароль должна пройти проверку авторизации
5	Восстановление пароля	восстановить пароль	§ обязательные поля должны быть заполнены § пользователь с указанным Email должен быть зарегистрирован в системе
6	Регистрация	зарегистрироваться	§ обязательные поля должны быть заполнены § данные введенные в поле VIN автомобиля должны пройти проверку на корректный VIN § данные введенные в поле Email должны пройти проверку на корректный email § данные введенные в поля Пароль и Повтор Пароля должны совпадать
7	Профиль. Просмотр	§ просмотреть профиль § деавторизация
8	Профиль. Редактирование	изменить профиль	§ обязательные поля должны быть заполнены § данные введенные в поле Email должны пройти проверку на корректный email
9	Мой автомобиль	просмотреть карточку «Мой автомобиль»
11	Помощь на дорогах. Информация	просмотреть информацию помощи на дорогах
12	Помощь на дорогах. Получить помощь	запросить помощь на дороге	обязательные поля должны быть заполнены
13	Инструкции	просмотреть инструкции
14	Периодичность ТО	просмотреть информацию о периодичности ТО
15	Сервисная информация. Список ТО	просмотреть список ТО автомобиля
16	Сервисная информация. Карточка ТО	просмотреть карточку ТО автомобиля
17	Справочник дилеров. Список	просмотреть дилеров списком
18	Справочник дилеров. На карте	просмотреть дилеров на карте
19	Справочник дилеров. Фильтр	фильтровать дилеров
20	Карточка дилера	§ просмотреть карточку дилера § позвонить дилеру по телефону § построить маршрут от текущего местоположения до дилера
21	Рейтинг дилеров	просмотреть рейтинг дилеров
22	Специальные предложения. Список	просмотреть специальные предложения списком
23	Специальные предложения. Карточка предложения	просмотреть карточку специального предложения
24	Специальные предложения. Boutique	просмотреть информацию о Boutique
25	Список курсов по вождению	просмотреть курсы списком
26	Карточка курса по вождению	просмотреть карточку курса
27	Справочник партнеров. Список	просмотреть партнеров списком
28	Справочник партнеров. На карте	просмотреть партнеров на карте
29	Справочник партнеров. Фильтр	фильтровать партнеров
30	Справочник партнеров. Карточка партнера	§ просмотреть карточку партнера § позвонить партнеру по телефону § построить маршрут от текущего местоположения до партнера
31	Условия предоставления услуги партнером программы лояльности	посмотреть условия предоставления
32	Остальное. Выбрать автомобиль	перейти к конфигуратору автомобиля
33	Остальное. Сувениры	просмотреть информацию о сувенирах
34	Остальное. Обратная связь	оставить сообщения обратной связи	§ данные введенные в поле VIN автомобиля должны пройти проверку на корректный VIN § данные, введенные в поле e-mail, должны пройти проверку на корректный e-mail
35	Остальное. Новости карточка	просмотреть карточку новости



6. Охрана труда и экологичность

6.1 Охрана труда

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

Любой производственный процесс, в том числе работа с ЭВМ, связан с появлением опасных и вредных факторов.

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

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

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

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

Определение опасных факторов при работе...