Интеграция 1С:Фитнес клуб КОРП с турникетом ZKTeco

Проект: Интеграция 1С:Фитнес клуб КОРП с турникетом ZKTeco
Платформа: 1С:Предприятие 8.3 (8.3.24.1368)
Конфигурация: 1С:Фитнес клуб КОРП, редакция 4.0 (4.0.56.2)
Цель: Автоматизация контроля доступа клиентов по абонементам и учёт фактической посещаемости студии.
1. Постановка задачи
Организовать интеграцию турникета фирмы ZKTeco с конфигурацией 1С:Фитнес клуб КОРП.
- Система должна управлять доступом клиентов на основании информации об их абонементах.
- Реализовать запись фактов посещения (успешных и отказанных) в базу 1С для последующего анализа и отчётности.
2. Функциональные требования
2.1. Контроль доступа
- При предъявлении карты/брелока клиентом турникет отправляет запрос в 1С.
- 1С проверяет:
• наличие действующего абонемента,
• срок действия,
• количество оставшихся посещений (если абонемент по визитам),
• ограничения (по времени, дням недели).
- Если условия выполнены → турникет открывается.
- Если нет → проход блокируется.
2.2. Учёт посещаемости
- Каждое событие фиксируется в 1С:
• дата и время,
• ФИО клиента,
• результат (успешный проход / отказ).
- Возможность построения отчётов:
• посещаемость за период,
• количество визитов по клиентам,
• загрузка зала по времени.
2.3. Синхронизация и обновление данных
- Система должна в реальном времени (или с минимальной задержкой — до 1 минуты) передавать данные между турникетом и 1С.
- При продлении абонемента или внесении изменений права доступа должны обновляться автоматически.
- Возможность ручной синхронизации (кнопка в интерфейсе администратора).
3. Требования к интеграции
- Использовать официальный SDK/API турникета ZKTeco (уточнить модель устройства: F18, InBio, ZKAccess и т.д.).
- Подключение по TCP/IP (предпочтительно) или RS-485.
- Интеграция реализуется как модуль расширения конфигурации 1С:Фитнес клуб КОРП.
- Поддержка запуска службы вместе с сервером 1С.
- Логирование всех действий и ошибок (сохранение в журнал регистрации).
4. Интерфейс в 1С
- В карточке клиента:
• отдельная вкладка «Посещаемость» с историей фактических входов.
- В разделе «Отчёты»:
• отчёт «Посещаемость» с фильтрацией по датам, клиентам, видам абонементов, статусу прохода.
- В разделе «Настройки»:
• параметры работы турникета (IP, порт, режим работы, таймауты).
• возможность временно отключить интеграцию.
5. Технические условия
- Сервер 1С и турникет находятся в одной локальной сети (или через VPN).
- Версия платформы: 1С:Предприятие 8.3 (8.3.24.1368).
- Конфигурация: 1С:Фитнес клуб КОРП, редакция 4.0 (4.0.56.2).
- Турникет ZKTeco (уточнить модель).
6. Результаты работ
- Рабочая интеграция 1С и турникета.
- Турникет открывается только для клиентов с действующими абонементами.
- Посещения фиксируются в 1С автоматически.
- Реализованы отчёты и интерфейсы для администратора.
- Подготовлена краткая инструкция по эксплуатации.
- Проведено тестирование на контрольной группе клиентов.
Итог
После внедрения администраторы будут видеть реальную посещаемость, а клиенты смогут проходить только при наличии активного абонемента.