Живой счётчик выработки на экране директора

01 — Постановка задачиAPI есть. Но пользоваться им можно только методом проб

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

У CVControl действительно есть рабочий REST API — авторизация, дерево фильтров, выгрузка событий. Но несколько вещей, критичных для того, чтобы данные вообще пошли, документация не проговаривала напрямую — их пришлось нащупывать вручную, отправляя тестовые запросы и глядя на реакцию сервера:

• Авторизация принимает данные строго как обычную веб-форму — JSON тот же самый эндпоинт молча отклоняет с «field required», как будто поля вообще не было в запросе.
• Фильтры устройств организованы деревом, а не плоским списком — верхние узлы это «папки», и если запросить события по такой папке, сервер вернёт вперемешку данные всех вложенных камер и зон разом. Забирать нужно только «листья» дерева.
• Пагинация есть, но обходить её нужно самому — листать offset вручную, пока не наберётся заявленное сервером общее количество записей.
• Идентификаторы листовых фильтров у двух площадок группы оказались разными числами для одной и той же по смыслу точки учёта — жёстко прописывать их в коде нельзя, дерево нужно каждый раз обходить заново.

02 — АрхитектураТри способа читать одни и те же данные, без единой лишней базы

Соблазн — завести отдельную БД и копить туда историю «на всякий случай». Не стали: у CVControl уже есть собственное хранилище, дублировать его целиком избыточно. Вместо этого — три лёгких клиента поверх одного и того же API, каждый под свою задачу:

• Скрипт постраничной выгрузки (только стандартная библиотека Python, без внешних зависимостей) — для полной архивной выгрузки за период, с автоматическим обходом дерева фильтров и пагинации.
• Внешняя обработка 1С — тот же самый API, но напрямую из учётной системы: логин, обход фильтров, постраничная выгрузка событий средствами платформы 1С, без промежуточных файлов.
• Настольное табло реального времени — лёгкий опрос раз в 15 секунд одним запросом с limit=1, чтобы получить только актуальный count, без выгрузки самих событий. Работает как обычное окно Windows на компьютере руководителя — без браузера, без локального сервера, без внешних зависимостей.

03 — Детали, которые обычно опускаютПростой линии — это не «давно не было ответа от сервера»

Первая версия индикатора простоя была наивной: если сервер долго не отвечает — красная лампа. Быстро выяснилось, что это неверная метрика. Сервер может отвечать исправно каждые 15 секунд, просто счётчик в ответе не меняется — линия реально стоит, а сеть тут ни при чём. Индикатор переписали так, чтобы он следил именно за фактическим изменением значения, а не за фактом получения ответа.

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

Третья мелочь — какой день считать выходным. Отсутствие прироста в субботу или воскресенье — норма, а не авария; такое же событие в будний день — уже повод для звонка мастеру смены. Порог простоя и рабочие дни вынесены в настройки, а не зашиты в логику — у разных площадок группы разный график.

04 — ИтогЧто это дало

Руководство получило то, чего не было в принципе — не отчёт по итогам смены, а живую картину прямо сейчас: сколько выработано с начала смены, как это соотносится со вчерашним днём на тот же час, и стоит ли линия дольше разумного. Всё это — на обычном компьютере под управлением Windows, без установки специализированного ПО: приложение собирается в единый исполняемый файл, который запускается двойным кликом даже на машине, где никогда не было Python.

Отдельная ценность кейса — не в самом табло, а в том, что подобная интеграция реальна почти с любой промышленной системой, у которой есть хоть какое-то API, даже если официальная документация покрывает от силы половину того, что нужно знать для реальной работы.