В рамках подготовки к использованию приложения выполните следующие действия:
Подготовка к использованию приложения
Внимание: Если у вас уже установлен White Server Agent V2, то пункты 2-3 можно пропустить.
Внимание! Данный пароль не используется для регистрации на терминале. Он нужен только для входа в бэк-офис при наличии соответствующих прав.
Внимание! Данный пароль не используется для регистрации на терминале. Он нужен только для входа в бэк-офис при наличии соответствующих прав.
1. Запросите лицензию на продукт "R-Keeper модуль Метрика ПО" для Вашего объекта.

2. Сделайте заказ ПО "Интерфейс White Server". Дождитесь выполнения заявки. Сгенерируйте лицензию "Интерфейс White Server". Скопируйте текст лицензии в буфер обмена.

3. После предоставления лицензий, установите агента WhiteServer и настройте его в соответствии с инструкцией. В конфигураторе агента выберите сервер ws.ucs.ru. В качестве лицензии использовать ранее скопированный текст лицензии (более подробно этот процесс описан в инструкции).

4. По адресу https://newadmin-ws.ucs.ru/ найдите своего агента v2 (он должен иметь статус онлайн) и примените ему настройки соединения с SQL сервером Rk7, где находится БД отчетов.

Более подробная инструкция панели администрирования описана здесь.
Пример:
{
  "ConnectionStrings": {
    "RKeeperReportService": "Server=127.0.0.1,1433;Database=RK7;User ID=sa;Password=pass"
  },
  "Rk7ReportsOptionSection": {
    "CacheTimeoutMins": 6
  }
}
Где:
RKeeperReportService - настройки с SQL.

CacheTimeoutMins - таймаут кэширования данных, в минутах.
В качестве плагина выберите последнюю версию rk_metrica_plugin.
5. Найдите своего агента и выполните сервисную команду UpdatePlugin:
6. Нажмите на кнопку "ОK", дождитесь выполнения операции.

Помимо этого, чтобы сотрудник мог пользоваться приложением, в менеджерской RK7 ему необходимо выставить привилегию "Выполнение отчетов".

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

1. Открыть на Вашем устройстве одно из приложений:
Как установить приложение
- Play market (если на Вашем устройстве установлена ОС Android);

- App Store (если на Вашем устройстве установлена ОС IOS).
2. Ввести в строку поиска название приложения "R-Keeper Metrica".

3. Скачать приложение на свое устройство.
1. Запустите приложение.

2. На экране авторизации выберите один из режимов работы с приложением:
Начало работы с приложением Metrica
- код ресторана;
- E-mail сотрудника;
- пароль.
- боевой режим, подключившись к базе данных своего объекта. Для этого на форме авторизации необходимо ввести:
Значение "Кода ресторана" не может превышать 50 символов. Приложение запоминает 10 последних кодов ресторанов, под которыми была осуществлена авторизация, и предоставляет их на выбор при вводе данных в поле "Код ресторана".
Если код ресторана, E-mail сотрудника или пароль введены некорректно, то при попытке входа в приложение на экране появится сообщение "Неправильные код ресторана, логин или пароль. Попробуйте снова".

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

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

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

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

Вы можете выбрать следующие значения периодов:
Особенности настройки периода
- День;
- Неделя;
- Месяц;
- Другой.
Для периода "Неделя" текущим периодом будет календарная неделя, захватывающая текущую дату, прошлым - прошлая неделя относительно текущего периода.
После этого на экране отобразится форма задания периодов:
Выбранное значение отображается в области фильтра. При этом на экране "Сводка" показывается как текущий период (имеет зеленый индикатор), так и прошлый (имеет желтый индикатор). На остальных экранах приложения отображается только текущий период.

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

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

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

нажав на значок напротив его названия.
Область меню
Из области меню Вы можете осуществить переход на экраны "Сводка", "Отчеты" и "Профиль". Активный экран подсвечивается в меню зеленым цветом.
Экран "Отчеты"
Переход на экран "Отчеты" осуществляется из области меню. С этого экрана Вы можете перейти на детализацию отчетов "По ресторанам", "По типам оплат", "По категориям" и Отчет "По скидкам".
Экран "Профиль"
На экране "Профиль" Вы можете посмотреть следующую информацию:
- E-mail сотрудника;
- Название объекта;
- Версию R_Keeper;
- Версию приложения.
Также отсюда Вы можете попасть в раздел настройки, нажав на стрелку напротив раздела, или выйти из приложения.
Экран "Настройки"
На экране "Настройки" (по переходу из экрана "Профиль") Вы можете настроить:

- значение "Видно записей в блоке". Это количество записей в каждом отчете, которые по умолчанию будут отображаться. Остальные записи при этом будут свернуты.

Например, если Вы установите значение параметра "Видно записей в блоке" равным 5, то в каждом отчете будут отображаться только 5 записей. Чтобы показать остальные записи отчета, Вам необходимо нажать на кнопку "Показать все":
Если у настройки "Видно записей в блоке" установлено значение "Скрыть все", то по умолчанию содержимое отчетов будет полностью свернуто:
- тему приложения:
Вы можете установить светлую тему, темную или тему по умолчанию. В случае выбора темы "По умолчанию" приложение обратится к настройкам Вашего устройства и на их основании выберет тему.
- язык приложения:
Эта настройка отвечает за то, на каком языке будут отображаться надписи в приложении. По умолчанию приложение обратится к настройкам Вашего устройства и на их основании установит язык - английский или русский. В случае если на устройстве выбран язык, отличный от перечисленных, будет установлен русский язык. На данных отчетов процедура смены языка не отразится.
- выход из приложения
- подписки:
Эта настройка дает Вам возможность подписаться на желаемые уведомления из списка. Если уведомления недоступны, то список доступных подписок будет пустым:
Выход на экран авторизации осуществляется нажатием кнопки "Выйти". При этом, если пользователь был залогинен, то осуществляется выход из профиля. Если же пользователь работал в демо-режиме, то осуществляется выход из демо-режима.
Выход из приложения
Для того чтобы выйти из приложения нужно нажать на кнопку "Выйти". При этом на экране отобразится сообщение "Вы уверены, что хотите выйти из текущего профиля?". Если Вы хотите выйти из приложения/сменить профиль, то нажмите кнопку "Выйти"; если хотите продолжить работу в приложении в текущем профиле, то нажмите кнопку "Отмена".
Чтобы посмотреть детализацию отчета "По ресторанам", на экране "Сводка" в блоке "По ресторанам" нужно нажать на знак списка:
Отчеты
Интервал построения отчета совпадает с выбранным ранее и при желании может быть Вами изменен на экране отчета.
Отчет "По ресторанам"
В шапке экрана отчета отображается его название, интервал построения отчета, а также общая по всем ресторанам сумма выручки, количество чеков и величина среднего чека:
Соотношение величин выручки по ресторанам представлены также и в графическом виде.

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

Интервал построения отчета совпадает с выбранным ранее и при желании может быть Вами изменен на экране отчета:
В отчете "По типам оплат" отображаются следующие данные:
- Название типа оплаты;
- Сумма в базовой валюте;
- Сумма в национальной валюте.
На графике отображаются процентные соотношения величины выручки по типам оплат, указанным в отчете.

Если отчет "По типам оплат" был сформирован для определенного ресторана, то

любой тип оплаты из отчета может быть детализирован нажатием на значок
В шапке экрана отчета отображается его название, интервал построения отчета, ресторан и тип оплаты.
Возврат на предыдущий экран осуществляется нажатием на
Отчет "По валюте"
Данный отчет строится только для выбранного ресторана и с указанием типа оплаты. В отчете "По валюте" отображаются следующие данные:
- Название типа оплаты;
- Сумма;
- Сумма в базовой валюте;
- Сумма в национальной валюте.
Чтобы посмотреть детализацию отчета "По категориям", нужно нажать на иконку:
Возврат на предыдущий экран осуществляется нажатием на
Отчет "По категориям"
Если Вы построили отчет "По категориям" в ходе детализации информации по ресторану, то в шапке отчета также будет указан ресторан:
- на экране "Сводка" в блоке "По категориям";
- на экране выбора детализации информации для ресторана.
В шапке экрана отчета отображается его название, интервал построения отчета, а также общая по всем ресторанам сумма выручки, количество чеков и величина среднего чека:
В этом случае величины "сумма выручки", "количество чеков" и "величина среднего чека" отображаются для указанного ресторана.

Интервал построения отчета совпадает с выбранным ранее и при желании может быть Вами изменен на экране отчета:
В отчете "По категориям" отображаются следующие данные:
- Название категории;
- Количество;
- Сумма по прайсу;
- Сумма оплаты по категории;
- Скидки по категории.
На графике отображаются процентные соотношения величины выручки по категориям, указанным в отчете.

Если отчет "По категориям" был сформирован для определенного ресторана, то любая

категория из отчета может быть детализирована нажатием на значок
Возврат на предыдущий экран осуществляется нажатием на
Отчет "По блюдам"
Данный отчет строится только для выбранного ресторана и с указанием категории. В деталях отчета "По блюдам" отображаются следующие данные:
В шапке экрана отчета отображается его название, интервал построения отчета, ресторан и категория.
- Название блюда;
- Количество;
- Средняя цена;
- Сумма (без скидки);
- Сумма оплаты;
- Величина скидки.
Чтобы посмотреть детализацию отчета "По скидкам", нужно нажать на иконку:
Возврат на предыдущий экран осуществляется нажатием на
Отчет "По скидкам"
Если Вы построили отчет "По скидкам" в ходе детализации информации по ресторану, то в шапке отчета также будет указан ресторан:
- на экране "Сводка" в блоке "По скидкам";
- на экране выбора детализации информации для ресторана.
В шапке экрана отчета отображается его название, интервал построения отчета, а также общая по всем ресторанам сумма выручки, количество чеков и величина среднего чека:
В этом случае величины "сумма выручки", "количество чеков" и "величина среднего чека" отображаются для указанного ресторана.

Интервал построения отчета совпадает с выбранным ранее и при желании может быть Вами изменен на экране отчета:
В отчете "По скидкам" отображаются следующие данные:
- Название скидки;
- Количество скидок;
- Количество чеков со скидками;
- Сумма скидок;
- Сумма оплаты по чекам.
На графике отображаются процентные соотношения величины выручки по скидкам, указанным в отчете.

Если отчет "По скидкам" был сформирован для определенного ресторана, то любая скидка

из отчета может быть детализирована нажатием на значок
Возврат на предыдущий экран осуществляется нажатием на
Отчет "По скидке"
Данный отчет строится только для выбранного ресторана и с указанием скидки. В отчете "По скидке" отображаются следующие данные:
В шапке экрана отчета отображается его название, интервал построения отчета, ресторан и название скидки.
- Название скидки;
- Количество;
- Сумма.
Чтобы посмотреть детализацию отчета "По сменам", нужно нажать на иконку
на экране выбора детализации информации для ресторана.
Возврат на предыдущий экран осуществляется нажатием на
Отчет "По сменам"
В шапке экрана отчета отображается его название, интервал построения отчета и название ресторана:
В отчете "По сменам" отображаются следующие данные:
- Номер смены;
- Дата открытия;
- Сумма в базовой валюте.
При нажатии на
данные выбранной смены можно детализировать до чеков и операций:
Возврат на предыдущий экран осуществляется нажатием на
Отчет "Чеки"
Данный отчет строится только для выбранного ресторана и с указанием смены. В отчете "Чеки" отображаются следующие данные:
В шапке экрана отчета "Чеки" отображается его название, интервал построения отчета, ресторан и номер смены.
- Номер чека;
- Сумма чека;
- Дата открытия чека;
- Количество гостей по чеку.
Возврат на предыдущий экран осуществляется нажатием на
Отчет "Чек"
Данный отчет строится только для чека из отчета "Чеки". В отчете "Чек" отображаются следующие данные:

Блок 1:
В шапке экрана отчета "Чек" отображается его название, интервал построения отчета, ресторан, номер смены и чек, данные по которому отображаются в отчете.
- Дата и время открытия чека;
- Дата и время закрытия чека;
- Сумма чека;
- Количество гостей.
Блок 2:
- Номер стола;
- Имя официанта;
- Имя кассира.
Блок 3:
- Название блюда;
- Количество единиц блюда в чеке;
- Цена блюда;
- Сумма блюда в чеке.
Блок 4:
- Скидка по чеку;
- Сумма скидки.
Блок 5:
- Валюта оплаты;
- Сумма оплаты;
- Сумма в базовой валюте.
Если к чеку скидки не были применены, то блок не отображается.
Возврат на предыдущий экран осуществляется нажатием на
Отчет "Операции"
Данный отчет строится только для выбранного ресторана и с указанием смены. В отчете "Операции" отображаются следующие данные:
В шапке экрана отчета "Операции" отображается его название, интервал построения отчета, ресторан и номер смены.
- Номер заказа;
- Дата операции;
- Название операции;
- Сумма;
- Номер стола.