Kerong

13 мая 2025 г.Около 4 минGateПостаматSmartOffice

ПОСТАМАТ - KERONG LCS

Функциональность

удаленный онлайн мониторинг всех событий с локерами в журнале событий.
Удаленное открытие ячейки (при наличии разрешения в системе)
Просмотр текущего состояния занятости ячеек локера.

Установка в качестве демона линукс:

Создать директорию /opt/kerong-gate и поместить в нее kerong-gate.jar, kerong-gate.conf, application.yml

    mkdir /opt/kerong-gate
    cp kerong-gate.jar /opt/kerong-gate
    cp application.yml /opt/kerong-gate
    cp kerong-gate.conf /opt/kerong-gate

Создать файл сервиса /etc/systemd/system/sigur-gate.service следующего содержания:

[Unit]
Description=kerong-gate
After=syslog.target

[Service]
User=root
Group=root
ExecStart=/opt/kerong-gate/kerong-gate.jar
SuccessExitStatus=143

[Install]
WantedBy=multi-user.target

Перечитать список сервисов linux

    systemctl daemon-reload

Запуск и остановку сервиса можно осуществлять стандартынми командами, модуль работает только в режиме 2

    service kerong-gate start
    service kerong-gate status
    service kerong-gate stop

Запуск

В режиме печати конфигурации Kerong

Используется для получения идентификаторов устройств при регистрации Провайдера

    java -jar kerong-gate.jar print

В режиме интеграции Inspark - Kerong

    java -jar kerong-gate.jar

Настройка схемы интеграции

В Библиотеке устройств (Меню->Устройства) найти устройство Kerong.
Если такого устройства нет, скачать устройство по ссылке и выполнить Импорт (Меню->Импорт).

Инфо

Согласно модели Inspark, Устройство является набором локеров (замков), и задает режимы доступа (PUBLIC, PRIVAT, CORPORAT).

Модель Kerong показана ниже

Топик канала	Тип значения	Представление в Kerong
accessMode	строковый	Режим доступа в постомате
locksSetId	мгновенный	Идентификатор набора замков
locksSetName	строковый	Название набора замков
lock-0	сигнальный	Замок подключеный к 0 входу платы
lock-1	сигнальный	Замок подключеный к 1 входу платы
lock-2	сигнальный	Замок подключеный к 2 входу платы
lock-3	сигнальный	Замок подключеный к 3 входу платы
lock-4	сигнальный	Замок подключеный к 4 входу платы
lock-5	сигнальный	Замок подключеный к 5 входу платы
lock-6	сигнальный	Замок подключеный к 6 входу платы
lock-7	сигнальный	Замок подключеный к 7 входу платы
lock-8	сигнальный	Замок подключеный к 8 входу платы
lock-9	сигнальный	Замок подключеный к 9 входу платы
lock-10	сигнальный	Замок подключеный к 10 входу платы
lock-11	сигнальный	Замок подключеный к 11 входу платы
lock-12	сигнальный	Замок подключеный к 12 входу платы
lock-13	сигнальный	Замок подключеный к 13 входу платы
lock-14	сигнальный	Замок подключеный к 14 входу платы
lock-15	сигнальный	Замок подключеный к 15 входу платы

Инфо

1 - замок закрыт, 0 - замок открыт, null - замок не подключен или состояние не определено

Собрать Типовую конфигурацию с таким Устройством, указав тип GATE.
Подключить Типовую конфигурацию к контроллеру на объекте.
Создать Провйдера для Kerong.
В секции Устройства внешней системы создать зоны , в ID проставить номера зон локеров.
Чтобы получить все номера зон системы Kerong, выполните предварительно следующие действия:

запустить модуль интеграции в режиме печати конфигурации;
в логе модуля будут выданы все доступные наборы и их идентификаторы для интеграции.
realLockNumber - замок подключенный к входу платы управления замками, номера входов платы и соответственно номера замков
с 0-15;
virtualLockNumber - ячейка, бокс с замком, характеризуется номером ячейки. Ячейки нумеруются с 1 - N в рамках зоны. Каждой ячейке соответствует один замок из набора замков. Например, в наборе 1,
для замка 0 определена ячейка 1

Примечание

Идентификатором наборов в помещении "Офис ИСС" будут наборы 10 и 11 которое необходимо прописать в схеме соединения в ТК.

Привязать к заведенным зонам экземпляры устройств платформы.
Каждой ячейке в поле Альтернативный код введите значение virtualNumber (см. выше), если планируется функция управления (открытие) ячейки.
В Справочнике Событий (Меню->Справочник событий) создайте события, которые планируется получать от системы Kerong (см. ниже материал по настройке действий Kerong)
В справочник типов помещения внести тип для зон ячеек, получить его ID .

Настройка модуля интеграции

Конфигурационный файл application.yml хорошо документирован, поэтому ниже приведены только уточняющие сведения.

Настройка на Провайдера.

В ключ sem-next.rest.extSystemId - ID Провайдера, зарегистрироваванный в платформе.

Настройка на зону (помещение).

В ключ sem-next.rest.sensor-location-id необходимо внести ТИП ID ПОМЕЩЕНИЯ. Модуль интеграции будет использовать этот тип помещения для создания конкретных помещений из системы Kerong, и привязки параметров-ячеек к конкретным помещениям.

Настройка адресации ячейки

В ключ channels.locks.real-number вписывается номер realLockNumber ячейки на плате, который соответствует топику устройства.

Важно!

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

[real-number -> topic]

Обновления значений ячеек

Api Kerong не позволяет отслеживать состояние замков по подписке, поэтому реализована отправка значений состояния
замков периодически при синхронизации метаданных интеграции.

# Настройка интеграции журнала событий Kerong для генерации событий Semnext
events:
    # задание периодичности обновления метаданных интеграции в виде крон строки
    # (устройства и параметры настроенные в Inspark и их и их представление в Kerong)
    # при настройке интеграции предлагается установить каждые 15 минут часа: 0 0,15,30,45 * * * ?
    # для штатной работы раз в час: 0 0 * * * ?
    cron:  0 0 * * * ?

Инфо

Настройка раз в 15 минут будет означать, что данные внесенные в системы и значения параметров отправятся в это время даже если на постомате за этот интервал не было зафиксировано ни одного события.

Получение действий Kerong

Все типы событий по действиям (operation) от Kerong, которые могут быть получены модулем интеграции, приведены в конфигурационном файле.
Каждое событие в журнале Kerong связано с ячейкой, а через него с замком. Событие может вызывать изменение состояния
замка или нет, это определяется в конфигурационном файле для каждого события

# Настройка интеграции событий Kerong событиям Inspark
events:
    refs:
        # Сопоставление операций в журнале событий Kerong событиям Inspark
        -
            # Наименование операции в Kerong.
            operation: Аренда
            # значение отправляемое для связанного замка на данное событие:
            # true - замок закрыт
            # false - замок открыт
            # если значение не указано, тогда значение замку не отправляется
            value: true
            # Идентификатор события в Semnext
            semEventId: 5001
            # Шаблон текста события, поддерживаются подстановки
            # $LOCKNUMBER - номер замка
            # $ZONENAME - имя зоны в Kerong
            # $OPERATION - наименование операции
            # $FIO - фио клиента связанного с событием
            # $IDENTIFIER - это номер карты, телефона использованного клиентом
            # $ZONEID - идентификатор зоны
            semEventMessageTemplate: В постамате $ZONENAME ($ZONEID) $OPERATION ячейки $LOCKNUMBER клиентом $FIO идентификатор $IDENTIFIER

Чтобы по событию Kerong в Inspark отправлялось значение интеграционоого параметра, необходимо в конфиге для данного события задать значение параметра true или false

        -
            operation: Закончилась аренда
            value: false

Пояснение

Это означает, что по событию "Закончилась аренда", для параметра замка связанного с этим событием будет отправлено значение 0. Если не задать ни какого значения по событию, будет означать, что состояние замка не меняется
и новое значение не отправляется

Чтобы на основании события Kerong создавалось событие в Inspark необходимо в конфиге для данного события задать
параметр semEventId

-
            # Наименование операции в Kerong.
            operation: Аренда
            # Идентификатор события в Semnext
            semEventId: 5001
            semEventMessageTemplate: В постамате $ZONENAME ($ZONEID) $OPERATION ячейки $LOCKNUMBER клиентом $FIO 
            идентификатор $IDENTIFIER начата аренда

Работа с Kerong в Inspark

При корректной настройке и работе системы Kerong все ячейки должны иметь актуальный статус, в Журнал событий должны поступать настроенные события, у параметров-статусов ячейки заполнены помещения (проставляет интеграционный модуль).

Управление со стороны Inspark реализовано только в части открытия ячейки.
Создайте дашборд с виджетом под название Kerong. Один виджет описывает одну Зону замков. Привяжите к каждой ячейке параметр-ячейку. Для каждой ячейки доступна операция по ее Открытию.

Внимание

если для ячейки не прописан в Альтернативном коде номер ячейки в системе Kerong (virtualNumber), операция открытия не будет работать.

В административном приложении эта же операция может быть выполнена в разделе Внешние команды.