Агент Брони для r_keeper 7 — обзор¶
Что делает агент¶
Агент — это служба Windows, которая работает на кассовом сервере r_keeper 7 и связывает его с Брони. Она:
- создаёт в r_keeper заказ под будущую бронь и отменяет его при отмене брони;
- отмечает посадку гостя, печать пречека и закрытие счёта;
- передаёт в Брони закрытые оплаченные счета — по ним считается комиссия;
- синхронизирует список столов и залов ресторана.
Персонал ресторана с агентом не взаимодействует: официанты работают в r_keeper как обычно.
Как он подключается¶
Агент сам обращается к Брони по HTTPS: примерно раз в 20 секунд отправляет состояние и забирает задания. Внутри сети он работает с кассовым сервером r_keeper по локальному XML-интерфейсу.
Входящие подключения не нужны
Открывать порты наружу, выделять внешний IP или менять правила входящего
трафика на межсетевом экране не требуется. Достаточно, чтобы с кассового
сервера был доступен https://broni.io.
Устойчивость к обрывам связи¶
Всё, что нужно отправить в Брони, складывается в очередь на диске и повторяется до подтверждения. Отключение интернета не приводит к потере закрытых счетов: после восстановления связи очередь уходит сама.
Раз в 5 минут агент дополнительно сверяет недавно закрытые заказы в r_keeper со своей очередью — на случай, если сервер был выключен.
Требования¶
| Требование | Значение |
|---|---|
| Где ставится | Кассовый сервер r_keeper 7 (тот, где работает midserv) |
| ОС | Windows Server 2016+ или Windows 10/11 |
| Проверенная версия r_keeper | 7.26.5 |
| Интерфейс r_keeper | XML-интерфейс midserv включён, по умолчанию порт 15151 |
| Учётная запись r_keeper | Сотрудник с правами на чтение заказов и работу с бронями |
| Права для установки | Локальный администратор (регистрация службы Windows) |
| Сеть | Исходящий HTTPS (443) к broni.io |
| Данные площадки | Код привязки из личного кабинета партнёра |
Лицензия r_keeper «XML: Save Order»
Сценарий бронирования (создание, изменение, отмена заказа, чтение справочников)
работает на базовой лицензии. Отдельная лицензия «XML: Save Order» нужна
только для сохранения состава заказа и для интеграции Брони не требуется.
Если в журнале встретится ошибка 5239 — см. Диагностику.
Что появится на кассовом сервере¶
Всё хранится в одной папке рядом с sidecar.exe; в системе регистрируется одна
служба.
| Файл или каталог | Что это |
|---|---|
sidecar.exe |
сам агент, один исполняемый файл |
sidecar.yaml |
настройки подключения, создаётся при привязке |
secrets.bin |
пароль r_keeper и токен площадки, зашифрованы средствами Windows (DPAPI) |
data\state.db |
служебный кэш отслеживаемых заказов |
data\spool\ |
очередь отправки: pending, sent, dead |
logs\sidecar.log |
журнал работы, ротация, хранение 7 дней |
Имя службы Windows — broni-rk7-sidecar.
Пароли не покидают кассовый сервер
Учётные данные r_keeper шифруются средствами Windows и привязываются к конкретной машине. В Брони они не передаются.