Сначала распишите путь человека как цепочку событий. Затем назначьте систему-источник для клиента, абонемента, права и номера шкафа. Только после этого согласуйте протокол, ошибки и тесты. TCP/IP, RS485 или фраза «есть API» сами по себе интеграцией не являются.
Словарь
| Элемент | Роль |
|---|---|
| СКУД | Проверяет проход. Не обязана управлять шкафчиками. |
| CRM / клубная система | Хранит клиента и услугу. Не обязана знать положение ригеля. |
| KERONG LCS | Управляет шкафчиками в согласованной конфигурации и может участвовать в обмене. |
| Плата / контроллер | Передаёт команду замку и может вернуть технический результат. |
| API | Контракт обмена. Нужны реализация, авторизация, ошибки и тесты. |
| Система-источник | Единственное место, где конкретные данные считаются верными. |
| Статус замка / двери | Состояние механизма, положение дверцы и результат команды — разные данные и могут поступать из разных источников. |
Почему это решают до покупки замков
От сценария зависят тип замка, наличие плат, сеть и объём разработки. Если купить автономные двери, а потом потребовать назначение ячейки из CRM, канала может не оказаться. Обратная ошибка — собрать онлайн-инфраструктуру там, где хватает общего браслета и локального Public.
Сценарий A. Один носитель без глубокого обмена
Человек проходит турникет и открывает шкаф одной картой, но права в системах живут отдельно. Носителей меньше. Общего срока действия, единого отзыва и общего журнала от этого не появляется.
Так можно собрать на автономных KR-S8080BH или KR-S80D, если браслет совпал со считывателем. «Читает Mifare» для вывода о всех картах клуба недостаточно.
Сценарий B. Назначение ячейки из внешней системы
CRM или СКУД передаёт идентификатор и право. Система шкафчиков принимает или выбирает номер, отправляет команду и возвращает результат. Для канала команды в проекте могут использовать KR-CU-16, KR-BU, KR-SCU и KR-SBU. Это примеры узлов, а не готовый комплект: состав и топологию определяют по схеме объекта.
Аппаратная связность не подтверждает обмен с конкретной CRM. Для обмена нужны спецификация API, поля, авторизация и совместные испытания.
Смешанный контур
Гостевые шкафы могут остаться автономными на том же браслете, что и вход. Служебные двери — в онлайн-контуре. Так можно, если ясно, какая система отзывает право и что происходит при блокировке носителя.
Ошибка — одним словом «статус» называть три разных факта: состояние ригеля, положение двери и успешность команды. В ТЗ их пишут отдельно.
Карта обмена
Это один из возможных контуров, не норма всех объектов KERONG.
| Шаг | Источник | Событие | Результат |
|---|---|---|---|
| 1 | СКУД или CRM | Человек распознан | Единый ID |
| 2 | CRM / СКУД | Услуга активна | Разрешён сценарий шкафа |
| 3 | LCS или внешняя система | Выбран номер | Нет двойного назначения |
| 4 | LCS → контроллер | Команда двери | Технический результат |
| 5 | Контроллер / датчик | Состояние механизма или двери | Интерпретация совпадает с ТЗ |
| 6 | Система-источник | Шкаф свободен или право снято | Данные не разъехались |
Что сравнить
| Критерий | Общий носитель, локальные права | Интегрированный онлайн-контур |
|---|---|---|
| Один браслет | Возможен после теста | Возможен в общем сценарии |
| Одни права | Сами не появляются | Только по согласованному обмену |
| Удалённая команда | Обычно нет | Если команда подтверждена |
| Разработка | Минимальна | Контракт, безопасность, тесты |
До испытаний
- система-источник для человека, права и номера шкафа;
- правила сопоставления идентификаторов;
- команды, события, состояния и коды ошибок;
- авторизация, журнал, роли;
- тайм-ауты, повторы, защита от второй команды;
- работа без CRM, сети или части контроллеров;
- стенд, пилот, приёмка.
FAQ
«Есть API» значит, что интеграция готова?
Нет. Это контракт. Дальше разработка или настройка, ошибки и совместные тесты.
Можно ли взять карту действующей СКУД?
После проверки формата и теста на считывателе. Общий носитель не равен общим правам.
Можно ли открыть шкаф из приложения?
Только если отдельно подтверждены авторизация, команда на конкретную дверь и защита от чужого открытия. Онлайн-контур сам по себе приложения не создаёт. Готовое приложение KERONG в этой статье не утверждается.
Какие статусы можно получать?
Только подтверждённые для выбранных замков, плат, датчиков и версии программы.
