Руководство

Что понадобится

• Компьютер в заведении с Windows 10 или 11 (64-разрядной) и видеокартой NVIDIA от 6 ГБ памяти. Подойдёт свой компьютер заведения или купленный по нашему списку. Подробно — системные требования.
• Проводная сеть. Компьютер должен стоять в той же локальной сети, что и видеорегистратор.
• Доступ к регистратору: IP-адрес, логин и пароль. Лучше завести отдельного пользователя «только просмотр» — как это сделать, ниже.
• Список камер: какая смотрит на вход, какие — на бары и запретные зоны.
• Права администратора Windows на время установки.
• Интернет на время установки — программа скачивает пакеты 10–20 минут. Без интернета установка возможна из заранее скачанных пакетов. Для работы интернет не нужен.
• Telegram — если нужны сводки и тревоги на телефон.

Пользователь «только просмотр» на регистраторе

Отдельный пользователь безопаснее главного admin: даже если пароль утечёт, посторонний не сможет менять настройки регистратора или удалять архив. Где искать в меню:

• Hikvision, HiWatch — «Пользователи» (User Management): новый пользователь с ролью «Оператор» или «Просмотр», разрешены только просмотр в реальном времени и удалённый просмотр.
• Dahua, RVi-IP, Imou — «Система → Учётные записи» (Account): группа «Просмотр» без прав на настройки и архив.
• XMeye, Polyvision, H264DVR — «Пользователи» (Users): права «Просмотр» (Preview, Playback), без прав на «Настройки» и «Управление диском».
• Uniview — «Пользователи» (User): роль «Оператор» с правами только на просмотр.

Установка программы

Подготовка Windows

1. 1
   Поставьте свежий драйвер NVIDIA (Game Ready или Studio — любой). Проверка: в PowerShell команда nvidia-smi показывает видеокарту.
2. 2
   Поставьте Python 3.11 64-bit с python.org, с отметками «Install for all users» и «Add python.exe to PATH». Без него установщик ОКО остановится.
3. 3
   В BIOS включите запуск после пропадания питания: пункт AC Power Recovery или Restore on AC Power Loss — значение Power On. Сон установщик выключит сам.
4. 4
   В Windows Update задайте «Период активности» так, чтобы перезагрузки не попадали на часы работы заведения.
5. 5
   Сделайте сетевой профиль «Частная». В сети с профилем «Общедоступная» Windows не пустит к панели.

Установка

1. 1
   Распакуйте архив программы в любую папку.
2. 2
   Откройте PowerShell от имени администратора и выполните: powershell -ExecutionPolicy Bypass -File <папка>\OKO\service\install_box.ps1
3. 3
   Дождитесь конца. В последних строках установщик напишет адрес панели, например http://192.168.1.50:8080.

Что делает установщик:

• копирует программу в C:\OKO; другая папка — параметр -InstallDir D:\OKO;
• создаёт окружение Python и ставит пакеты; без интернета — параметр -Wheelhouse <папка с пакетами>;
• закрывает папку программы от обычных пользователей Windows: в настройках лежат пароли регистратора;
• открывает порт панели 8080 в брандмауэре только для частной и доменной сети; другой порт — параметр -Port;
• выключает сон и гибернацию;
• создаёт задачу планировщика OKO Box: программа стартует при включении компьютера от имени системы, без входа пользователя, и перезапускается при сбое.

Первый запуск: мастер

Откройте адрес панели в браузере с ноутбука или телефона в той же сети. Мастер проведёт через шесть шагов:

1. 1
   Пароль — пароль администратора, не короче 8 символов. Запишите его владельцу заведения.
2. 2
   Заведение — название, часы смены («Смена с … до …», целые часы) и вместимость. Для клуба обычно 20:00–06:00, для ресторана — 11:00–00:00.
3. 3
   Регистратор — кнопка «Найти в сети» покажет устройства с портами видео, «Выбрать» подставит адрес и марку. Или введите вручную: марка, IP-адрес, порт видео (RTSP, обычно 554), логин, пароль, сколько каналов. Дальше — «Проверить и дальше» или «Настрою позже».
4. 4
   Камеры — «Проверить каналы»: программа опросит каналы регистратора и покажет снимки. Нажмите на нужные камеры, дайте им имена и роли: Вход, Бар или Запретная зона. Затем «Добавить камеры».
5. 5
   Линия входа — появляется, если среди камер есть «Вход». Поставьте линии A и B (как — в разделе «Линия на входе») и нажмите «Сохранить линии». Можно «Поправлю позже».
6. 6
   Готово — «Открыть панель». Анализ запускается сам, через минуту цифры появятся на экране «Сейчас».

Через 10–15 минут работы проверьте: на экране «Сейчас» цифры растут, а в разделе «Система» нет красных пунктов.

Марки регистратора нет в списке или камера подключена напрямую — добавьте её по адресу потока: «Камеры → Добавить камеру → По адресу потока». Адрес RTSP дают инструкция камеры или веб-панель регистратора. Кнопка «Проверить поток» покажет, отвечает ли камера.

Роли камер

Поток и роль камеры меняются в карточке камеры: «Камеры» → камера → «Настроить». Для входа нужен основной поток — мелкие силуэты в дверях на нём видны лучше. Для баров и зон хватает дополнительного, и так компьютер тянет больше камер.

Линия на входе

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

Как поставить камеру

• Внутри зала, над проходом, на высоте 2,5–3 метра. Взгляд — под углом вниз на дверь и 2–3 метра прохода за ней.
• В кадре вся дверь целиком: счётчику нужно видеть человека до линии и после неё.
• Не строго вниз в пол — не видно, куда идёт человек. Не в лоб — люди закрывают друг друга.
• Не против уличного света: открытая дверь днём, окно или фонарь в кадре. На просвет силуэты проваливаются в тень. Если светлого проёма не избежать, пусть он будет сбоку кадра.
• Проход не закрыт стойкой охраны или гардеробом.
• Для модуля лиц лица должны быть видны спереди-сверху, а не только макушки.

Как поставить линии

Разметка входа: «Камеры» → камера входа → «Настроить». Тяните за круглые метки на кадре.

1. 1
   A — у двери, B — в зале. Между ними 1,5–2 метра прохода. Если линии шире прохода, ничего страшного.
2. 2
   Стрелка «ВХОД» — куда идут входящие. Смотрит наружу — нажмите «Поменять направление входа». Перепутали линии — «Поменять линии местами».
3. 3
   Не ставьте линии там, где стоят. У стойки охраны, в очереди, у гардероба люди топчутся — это лишние проходы.
4. 4
   Нажмите «Сохранить разметку». Новые линии начинают работать без перезапуска анализа.

Бары и запретные зоны

Стойка бара

1. 1
   «Камеры» → камера с ролью «Бар» → «Настроить».
2. 2
   Потяните за углы рамки «ЗА СТОЙКОЙ» — обведите место за стойкой, где стоит бармен.
3. 3
   В поле «Тревога, если за стойкой никого дольше, мин» укажите порог. По умолчанию 10 минут, 0 — не следить. Пустую стойку ОКО отслеживает только в часы смены.
4. 4
   Нажмите «Сохранить разметку».

Что будет дальше:

• Бутылка в руке у стойки — событие с фото в разделе «События». В Telegram не отправляется.
• За стойкой никого дольше порога — событие «За стойкой никого N мин» в «Событиях» и сообщение в Telegram.
• Человек вернулся — событие «За стойкой снова есть человек» в «Событиях».

Запретная зона

Касса, склад, служебный вход, кухня после закрытия.

1. 1
   «Камеры» → камера с ролью «Запретная зона» → «Настроить».
2. 2
   Нажимайте по кадру — так ставятся углы зоны, нужно минимум три. Замкнуть зону — кнопка «Замкнуть зону» или двойное нажатие.
3. 3
   Обводите пол: ОКО смотрит, где у человека ноги.
4. 4
   Дайте зоне название и задайте часы охраны, например 22:00-06:00. Пусто — зона охраняется всегда. Часы — по часам компьютера.
5. 5
   Нажмите «Сохранить разметку».

Человек в зоне в часы охраны — тревога с фото в «Событиях» и в Telegram. По одной зоне тревога повторяется не чаще раза в две минуты. Фото тревог хранятся на компьютере 30 дней и удаляются сами.

Смена и отчёт

Закрытие смены

• Само, в конце часов смены. Собирается Excel-отчёт, в Telegram уходит сводка, счётчики начинаются с нуля. Всё, что было между сменами, идёт в следующую. Включается переключателем «Закрывать смену сама в конце часов» в «Настройки → Заведение и смена».
• Вручную. «Отчёты → Закрыть смену сейчас» — доступно администратору.

Что значат цифры

Проход — не человек. Гости выходят курить и возвращаются, охрана и персонал ходят через дверь всю ночь. Поэтому «Гостей ≈» — это проходы внутрь, делённые на то, сколько раз в среднем входит один гость. Пока нет ни одной сверки с кассой, программа считает, что гость входит 1,3 раза. Без модуля лиц персонал от гостей не отделяется — это поправляет только сверка с кассой.

Excel-отчёт

Раздел «Отчёты» — все закрытые смены: вошло, пик, гостей, тревоги, график по часам. Отчёт скачивается кнопкой «Excel» в строке смены или «Отчёт Excel» в карточке смены. Без модуля лиц в отчёте три листа: «Смена», «По часам» с графиком входов и выходов и «Тревоги». Файлы лежат в папке reports внутри папки программы, по умолчанию C:\OKO\reports.

Сверка с кассой

1. 1
   «Отчёты» → нужная смена.
2. 2
   В блоке «Сверка с кассой» впишите в поле «Гостей по кассе», сколько гостей было по кассе или билетам.
3. 3
   Нажмите «Сохранить». Очистить поле и сохранить — убрать сверку.

Оценка гостей пересчитывается уже после первой сверки: программа берёт медиану по последним сменам со сверкой, до десяти смен. Чем больше сверок, тем устойчивее оценка — сделайте хотя бы 3–5.

Если в карточке смены предупреждение, что при закрытии внутри оставалось много людей и выходы посчитаны не полностью, проверьте линию входа: люди могут выходить мимо неё.

Telegram

Подключение

1. 1
   В Telegram найдите @BotFather → команда /newbot → придумайте имя → получите токен вида 123456789:AA….
2. 2
   Напишите своему новому боту любое сообщение — иначе он не сможет писать вам.
3. 3
   Узнайте свой chat_id: напишите боту @userinfobot, он ответит числом Id. Для группы добавьте бота в группу — id группы начинается с минуса.
4. 4
   «Настройки → Telegram»: включите «Присылать сообщения», вставьте токен и chat_id, нажмите «Сохранить», затем «Отправить тест».

Что присылает бот

Пороги меняются в «Настройки → Тревоги»: «Камера молчит дольше, мин», «Зал заполнен на, %» (0 — не следить), «На диске меньше, ГБ» и переключатель «Сводка за смену после закрытия». О каждой проблеме бот пишет один раз, а когда она прошла — ещё раз. Одинаковые сообщения — не чаще раза в минуту.

Команды /now и /last

• /now — сколько сейчас внутри и из какой вместимости, сколько вошло, пик и во сколько, оценка гостей и текущие проблемы.
• /last — итог прошлой смены.
• /help — список команд.

Бот отвечает только в чат из настроек, чужим молчит, и только когда включено «Присылать сообщения». Для команд компьютеру нужен выход в интернет — открывать что-то снаружи и пробрасывать порты не нужно.

Модуль лиц

Модуль распознавания лиц — опция. По умолчанию он выключен, в пробный период недоступен и включается, только если входит в лицензию. Без него ОКО считает силуэты и не хранит биометрических данных.

С модулем лиц программа считает разных гостей, а не проходы, видит постоянных гостей и убирает персонал из счёта. Как это работает:

1. 1
   Лицо найдено. На кадре входа модель находит лицо и опорные точки: глаза, нос, губы.
2. 2
   Выравнивание. Лицо поворачивается ровно и уменьшается до 112×112 точек.
3. 3
   Отпечаток. Из лица получаются 512 чисел — по ним программа сравнивает людей. Для раздела «Гости» сохраняется ещё фото человека и оценка возраста и пола. Всё это лежит только на компьютере заведения.
4. 4
   Сравнение. Отпечаток сравнивается с уже знакомыми: похож — тот же человек вернулся, нет — новый гость.

Включение

1. 1
   «Настройки → Распознавание лиц» — переключатель. Если модуль не входит в лицензию, переключатель недоступен.
2. 2
   В окне отметьте «Гости предупреждены и дают согласие на обработку изображения лица» и нажмите «Включить». Без отметки модуль не включится.
3. 3
   Анализ перезапустится, в панели появится раздел «Гости».

Персонал

В разделе «Гости» — лица за эту смену или за всё время. Каждому можно дать роль: «Гость», «Сотрудник», «VIP», «Чёрный список». Отметьте сотрудников один раз — их проходы перестанут считаться гостями.

Если камера не отвечает

Состояние камеры видно в разделе «Камеры»: «Работает», «Подключается», «Анализ остановлен», «Выключена».

1. 1
   Проверьте, что регистратор включён и подключён к сети.
2. 2
   Вспомните, не меняли ли пароль на регистраторе. Меняли — впишите новый: «Камеры → Регистраторы → Изменить». И не забудьте нажать «Сохранить» на самом регистраторе.
3. 3
   Подождите: программа переподключается сама. Если кадров нет дольше 5 минут, в Telegram придёт «Камера … не отвечает», а когда камера вернётся — «снова работает».
4. 4
   «Камеры → Регистраторы → Каналы» → «Проверить каналы» — покажет, какие каналы отвечают, и текст ошибки у тех, что молчат.

Что значат ошибки 401, 451, таймаут и чёрный кадр — в разделе «Поддержка».