NEARILY — плагин лояльности для iikoFront
==========================================
Версия 0.5.0

Что это: кнопка «Nearily» на экране заказа. Бариста вводит 4-значный код гостя
или номер телефона (либо сканирует QR) — визит засчитывается, а если гостю
положена награда, она применяется к открытому заказу как скидка.

--------------------------------------------------
1. КУДА КОПИРОВАТЬ
--------------------------------------------------
Скопируйте ВСЮ папку Nearily целиком в:

    C:\Program Files\iiko\iikoRMS\Front.Net\Plugins\Nearily\

Внутри должны лежать:
    Nearily.IikoFront.dll        <- загрузчик, его и запускает iikoFront
    Manifest.xml
    config.json                  <- вы создаёте его на шаге 2
    logic\0.5.0\                 <- рабочая часть плагина
        Nearily.IikoFront.Core.dll
        System.Reactive.dll

ОБНОВЛЕНИЯ АВТОМАТИЧЕСКИЕ: загрузчик сам проверяет новую версию, скачивает
её в папку logic и применяет при следующем запуске iikoFront. Копировать
файлы вручную больше не нужно — эта установка последняя. Если интернета
нет, плагин продолжает работать на той версии, которая уже лежит в logic.

ВАЖНО: не кладите рядом Resto.Front.Api.V8.dll. iikoFront поставляет свою
копию, вторая ломает загрузку плагина.

--------------------------------------------------
2. CONFIG.JSON
--------------------------------------------------
Переименуйте config.example.json в config.json и заполните:

    "cafeId"       — идентификатор кофейни в Nearily (даст Nearily)
    "sharedSecret" — секретный ключ этой кассы (даст Nearily, выдаётся один раз)
    "baseUrl"      — не менять

Остальные настройки (типы скидок, таймауты, правила лояльности) приходят
с сервера при запуске и обновляются на ходу — здесь их нет специально.

--------------------------------------------------
3. ТИПЫ СКИДОК В IIKOOFFICE
--------------------------------------------------
В iikoOffice → Розничные продажи → Типы скидок и надбавок нужны две записи,
и у обеих должна стоять галочка «Применяется вручную»:

    а) фиксированная скидка — для бесплатного напитка
    б) скидка произвольной суммой — для кэшбэка

GUID каждой из них пришлите в Nearily: они настраиваются централизованно,
в config.json их вписывать не нужно.

--------------------------------------------------
4. ПЕРЕЗАПУСК
--------------------------------------------------
Полностью закройте и снова откройте iikoFront. Плагин загружается только
при старте.

--------------------------------------------------
5. ПРОВЕРКА
--------------------------------------------------
Откройте заказ — на экране заказа должна появиться кнопка «Nearily».
Нажмите её: в заголовке окна ввода будет написана версия — «Nearily 0.5.0».
Если кнопки нет, смотрите лог iikoFront:

    C:\Program Files\iiko\iikoRMS\Front.Net\Logs\

Самые частые причины: папка положена не туда, config.json отсутствует или
в нём опечатка, iikoFront не перезапускали.

--------------------------------------------------
6. ЭКРАН ОБНОВЛЕНИЙ
--------------------------------------------------
Нажмите «Nearily» на экране заказа и введите 000000 на вкладке
«Код или телефон». Откроется служебный экран — он покажет:

    * текущую версию плагина на этой кассе;
    * скачанное обновление, если оно уже лежит и ждёт перезапуска;
    * кнопку «проверить обновления сейчас», не дожидаясь автопроверки.

000000 — это не код гостя: коды гостей всегда 4-значные, поэтому спутать
их нельзя. Через сканер QR служебный экран не открывается.

Если касса работает неделями без перезапуска, скачанное обновление может
ждать долго. Чтобы это было видно, в заголовке окна ввода появляется
подпись вида «Nearily 0.5.0 · обновление 0.4.1 готово». Это значит одно:
обновление уже на кассе, осталось перезапустить iikoFront, когда удобно.
Прерывать смену специально не нужно.

Если проверка сообщает «файл обновления не прошёл проверку целостности» —
повторять не нужно, напишите нам. Во всех остальных случаях касса
продолжает работать на текущей версии как обычно.

--------------------------------------------------
7. НЕСКОЛЬКО НАПИТКОВ (новое в 0.5.0)
--------------------------------------------------
Раньше одно сканирование = один штамп, даже если гость взял три кофе.
Теперь после того как гость определён, плагин спрашивает:

    Один напиток?
    «Да»  — начислить 1 штамп
    «Нет» — указать количество (от 1 до 10)

Обычная продажа не стала длиннее: «Да» — это одно нажатие.

Если гость перешагнул награду внутри одной покупки (например, было 6
штампов из 7, взял 3 кофе), награда сразу появляется у него в приложении,
а оставшиеся штампы переходят на следующую карту. Списать награду можно
со следующего заказа.

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

В кофейнях с кэшбэком вопрос не задаётся: кэшбэк считается от суммы чека,
а в чеке уже есть все напитки.

--------------------------------------------------
ПОДДЕРЖКА
--------------------------------------------------
Telegram: @nearily_bot   ·   support@nearily.com   ·   nearily.com/support
