Редактирование: установка-dll

Путь: 03_Настройка_r-keeper/установка-dll.md

Содержимое (Markdown)

# Установка DLL ReMarked на r-keeper

Инструкция описывает состав ПО для интеграции r-keeper с ReMarked, порядок запуска кассы и полную установку компонентов: модуля выгрузки меню (menu_dump), модуля взаимодействия FarCards и агента мониторинга.

## Состав ПО для r-keeper

Дистрибутивы поставляются по ссылке:
```
https://drive.google.com/drive/folders/1QS8B4qHjMhL7QRO3AMJd1jLnis7_DzPK
```

| Компонент | Назначение |
|---|---|
| `remarked_farcards` | DLL для взаимодействия ReMarked и r-keeper |
| `menu_dump` | ПО для передачи структуры меню в ReMarked |
| `monitoring_agent` | ПО для мониторинга и удалённого администрирования DLL |

Путь к FarCards на кассах (пример версии):
```
C:\REMARKED\remarked_farcards_v1.2.5
```

## Порядок запуска r-keeper после перезагрузки

```
1. Сервер:        C:\rkeeper\Rk7MidServer\MIDSERV.exe
2. FC:            C:\rkeeper\Farcards-dll -desktop   (ярлык)
3. Касса:         C:\rkeeper\Касса
4. Менеджерская:  C:\rkeeper\Rk7Manager   (при необходимости)
```

## Настройка интеграции на стороне ReMarked

Создать приложение **«API Системы лояльности Remarked»** со следующими настройками:

- **Ключ приложения** — токен, используемый для взаимодействия с API.
- **Тип кассы** — тип используемой кассы, в данном случае `rkeeper`.
- **Доступные варианты получения гостя** — указать нужные варианты.

## Настройка XML-интерфейса r-keeper

XML-интерфейс предоставляет удобный способ получения информации о системе r-keeper и сохранения данных в БД r-keeper 7. Для работы на чтение лицензировать XML-интерфейс не нужно.

### HTTP XML интерфейс кассового сервера

1. Перейти в справочник **«Сервис → Станции и устройства»**.
2. В дереве слева выбрать кассовый сервер, с которым будет работать ПО.
3. Перейти во вкладку **«Свойства»** выбранного кассового сервера.
4. В группе свойств **«HTTP ограничения»** для всех пунктов проставить значение (можно использовать стандартную привилегию, например «HTTP Access»).
5. В группе **«HTTP Server»** параметр **«HTTP Data Port»** установить в любой свободный порт на компьютере с кассовым сервером — этот порт используется при настройке ПО. Параметр **«Use Free Listen Port»** рекомендуется отключить.
6. Сохранить изменения и перезапустить кассовый сервер (или кассу).

### Пользователь для HTTP XML интерфейса

1. Перейти в справочник **«Персонал → Работники»**.
2. Выбрать существующую роль **XML-Editing** (именно её), дать ей привилегию на объект **«HTTP Access»** (или ту, что заведена ранее) в группе «Менеджерские ограничения».
3. Для роли создать пользователя с названием **строго из латинских букв (регистр важен)**, задать пароль (цифры и латинские буквы).
4. Выдать этой роли полные кассовые права.
5. Учётные данные (название и пароль) потребуются для дальнейшей настройки ПО.

**Проверка:** в браузере перейти по адресу:
```
https://127.0.0.1:8026/webgui/iservxmltest.htm
```
где `127.0.0.1` — адрес кассового сервера, `8026` — порт интерфейса. При корректной настройке браузер сообщит о сертификате, после игнорирования спросит логин/пароль интерфейса и откроет страницу проверки с готовым XML-запросом.

## Сервер синхронизации меню (menu_dump)

Модуль выгружает меню из r-keeper в CRM ReMarked: сначала выполняется первоначальная выгрузка всего доступного меню, далее — периодическая выгрузка меню и стоп-листов при изменении справочников.

Скачать последнюю версию:
```
https://drive.google.com/drive/folders/1SFYRKG0rn3xINgyx1t5XKLlVZou-cAXR
```

**Поставка.** ПО поставляется в zip-архиве. Установка — распаковкой архива в любую папку на диске. Не оставляйте номер версии в имени папки — это помешает обновлению. Рекомендуется устанавливать модуль на той же машине, где расположен кассовый сервер (мид).

### Конфигурационный файл settings.yaml

1. Запустить сервер синхронизации `remarked_menu_dump.exe` в режиме `/desktop` (в поставке есть bat-файлы для запуска) — это сгенерирует необходимые файлы, в том числе `settings.yaml`.
2. Закрыть программу, открыть `settings.yaml` (находится в папке запуска) в блокноте и прописать параметры.

В файле настроек указать:
- IP-адрес кассового сервера;
- порт HTTP XML интерфейса кассового сервера;
- имя пользователя и пароль для работы с XML-интерфейсом;
- идентификатор классификации из r-keeper (по умолчанию `2560`) — по нему выгружаются категории блюд и блюда. **Важно:** в классификации обязательно должны быть категории;
- уровень логирования от 3 до 10 (10 — максимальный, использовать при первом запуске);
- срок хранения логов (рекомендовано `7`);
- код станции, код стола и категорий — для корректных данных стоимости блюд (важно для сетевых ресторанов).

Раздел **«Настройки API»** (данные получаются от CRM ReMarked):
- токен для работы с API CRM ReMarked;
- URL API CRM ReMarked (`app.remarked.ru`);
- время ожидания ответа от сервера (по умолчанию 10 секунд);
- время в минутах для повторной синхронизации (рекомендовано 10 минут).

3. Сохранить и закрыть файл, запустить `remarked_menu_dump.exe`, проверить выгрузку.

### Bat-файлы запуска

- `desktop.bat` — запуск приложения в режиме `/desktop`;
- `install.bat` — установка службы на ПК;
- `uninstall.bat` — удаление службы с ПК.

## Дальнейшие шаги

- Настройка модуля взаимодействия **FarCards** и агента мониторинга описана в инструкции «Настройка FarCards и Telegram».
- Работа кассира с картами — в инструкции «Работа с картами r-keeper».

Отмена