Установка агента для r_keeper 7¶

Агент ставится один раз на кассовый сервер ресторана (тот, где работает midserv). На кассовые станции ставить ничего не нужно.

Установка занимает около 5 минут.

Шаг 1. Подготовьте данные¶

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

Что	Где взять
Код привязки вида `XXXX-XXXX`	Личный кабинет партнёра → Интеграции → r_keeper
Адрес и порт кассового сервера r_keeper	У ИТ-специалиста ресторана (порт по умолчанию `15151`)
Логин и пароль сотрудника r_keeper	У администратора r_keeper

Код привязки одноразовый

Он действует ограниченное время и сгорает после первого успешного использования. Если привязку нужно повторить, запросите новый код в личном кабинете.

Убедитесь, что в r_keeper включён XML-интерфейс midserv — без него агент не подключится.

Шаг 2. Скачайте агент¶

Скачать агент 0.1.0 (3.6 МБ)

Файл: broni-rkeeper-0.1.0-windows-amd64.zip · Версия: 0.1.0 · Опубликован: 2026-07-27
SHA-256: 8713cd776890256d50f1e641372ba0d054e9f55d0c8abae0f94b6bebf4764a6d

Проверьте контрольную сумму:

Get-FileHash -Algorithm SHA256 "$env:USERPROFILE\Downloads\broni-rkeeper-0.1.0-windows-amd64.zip"

Шаг 3. Распакуйте в отдельную папку¶

Создайте каталог и распакуйте туда sidecar.exe:

C:\broni-sidecar\

Не кладите агент в «Загрузки» или на рабочий стол

Рядом с sidecar.exe агент создаёт свои настройки, ключи и очередь отправки. Каталог должен быть постоянным и не должен чиститься автоматически. Не размещайте его в профиле пользователя.

Дальше все команды выполняются в PowerShell от имени администратора из этого каталога:

cd C:\broni-sidecar

Шаг 4. Проверьте связь с r_keeper¶

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

.\sidecar.exe probe --rk7-host 127.0.0.1 --rk7-port 15151 --rk7-login ЛОГИН --rk7-password ПАРОЛЬ

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

Полная проверка с записью

Если нужно убедиться, что агент сможет создавать и отменять заказы, добавьте --write. Команда создаст один пустой тестовый заказ и тут же отменит его:

.\sidecar.exe probe --rk7-host 127.0.0.1 --rk7-login ЛОГИН --rk7-password ПАРОЛЬ --write

Делайте это до открытия смены или по согласованию с рестораном.

Шаг 5. Привяжите площадку¶

.\sidecar.exe enroll --code XXXX-XXXX

Агент запросит недостающие данные — значения в скобках подставляются клавишей

Pairing code: XXXX-XXXX
RK7 cash server host: 127.0.0.1
RK7 cash server XML port [15151]:
RK7 login: ЛОГИН
RK7 password (input is echoed): ПАРОЛЬ
Broni backend base URL: https://broni.io

Пароль отображается при вводе

Убедитесь, что за экраном никто не наблюдает и что сеанс не записывается.

Что происходит дальше:

Агент подключается к r_keeper и проверяет учётные данные;
запоминает отпечаток TLS-сертификата кассового сервера — дальше он будет принимать соединения только с ним;
обменивает код привязки на постоянный токен площадки;
сохраняет настройки в sidecar.yaml, а пароли и токен — в зашифрованный secrets.bin.

Признак успеха — строки вида:

  RK7 OK: version 7.26.5, net …, restCode …
  Pinned TLS cert SHA-256: …
Enrolling with https://broni.io ...

Шаг 6. Установите и запустите службу¶

.\sidecar.exe install
.\sidecar.exe start

Проверьте состояние:

Get-Service broni-rk7-sidecar

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

Проверка установки¶

Откройте logs\sidecar.log — в первых строках должны быть версия агента и успешный check-in, без записей уровня error.
```
Get-Content .\logs\sidecar.log -Tail 50
```
В личном кабинете партнёра, раздел Интеграции → r_keeper, площадка должна отображаться как активная с текущей версией агента.
Создайте тестовую бронь в Брони → в r_keeper должен появиться заказ на соответствующем столе.
Отмените бронь → заказ должен быть отменён.

Если все пункты прошли — установка завершена. Дальнейшая настройка (интервалы, подробность журнала, служебные коды r_keeper) приходит с сервера Брони, выезжать на площадку повторно не нужно.

Обслуживание¶

Смена пароля сотрудника r_keeper¶

.\sidecar.exe stop
.\sidecar.exe set-rk7-creds
.\sidecar.exe start

Если на кассовом сервере заменили TLS-сертификат, добавьте --repin, чтобы агент запомнил новый отпечаток:

.\sidecar.exe set-rk7-creds --repin

Обновление агента¶

.\sidecar.exe stop

Замените sidecar.exe новым файлом (настройки, очередь и ключи лежат рядом и сохраняются), затем:

.\sidecar.exe start

Агент раз в 6 часов сверяет свою версию с опубликованной и предупреждает в журнале, если устарел. Самостоятельно он не обновляется — обновление всегда запускает человек.

Просмотр работы вживую¶

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

.\sidecar.exe stop
.\sidecar.exe run

Журнал будет дублироваться на экран. Остановка — Ctrl+C, затем .\sidecar.exe start.

Удаление¶

.\sidecar.exe stop
.\sidecar.exe remove

После этого можно удалить каталог C:\broni-sidecar. Заказы, уже созданные в r_keeper, останутся на месте.