👁️‍🗨️ Entrance Observer

Entrance Observer — это edge-компонент компьютерного зрения, который наблюдает за летком улья, распознаёт движение пчёл и отправляет в веб-платформу Gratheon телеметрию пчелиного трафика, а при необходимости — видеодоказательства.

Живой просмотр должен запускаться по запросу из web-app, когда пользователь открывает или начинает смотреть конкретную секцию улья. У web-app нет прямого доступа к edge-устройству, поэтому live-сессии должны запускаться и воспроизводиться через gate-video-stream и graphql-router. Постоянная загрузка видео и S3-воспроизведение остаются опциональными режимами записи, а не стандартным способом смотреть леток в реальном времени. Целевая архитектура описана в On-demand entrance video streaming.

Продуктовый обзор см. в Entrance Observer. Собранные метрики связаны с хранилищем телеметрии ульев и аналитикой временных рядов.

Направление продукта

Entrance Observer должен развиваться через три понятные аппаратные фазы. Документация теперь сгруппирована сначала по фазам, потому что каждой фазе нужны и описание продукта, и отдельный bill of materials:

1. Фаза 1 — лабораторная валидация — доказать работу камеры, модели, телеметрии и управления live-сессиями на стенде разработчика.
2. Фаза 2 — полевой MVP — поставить защищённое пилотное устройство на настоящий леток и измерить надёжность, качество подсчёта, энергопотребление и пропускную способность.
3. Фаза 3 — production kit — превратить проверенный дизайн в повторяемое, поддерживаемое и продаваемое устройство или набор SKU.

Такое разделение помогает быстро отлаживать первую сборку и одновременно показывает путь к законченному продукту Gratheon. Текущая прототипная платформа — NVIDIA Jetson Orin Nano Super Developer Kit с USB UVC-камерой. Jetson локально запускает entrance-observer, чтобы пасеке не нужно было постоянно стримить сырое видео в облако.

Обзор фаз

Модель подключения системы

Аппаратную часть нужно описывать как связанные подсистемы, а не как случайный список деталей. Так явно видны границы камеры, питания, сети, сервиса и облака.

flowchart LR
  subgraph Hive[Леток улья]
    entrance[Леток и прилётная доска]
    cameraHead[Камера, объектив, окно, кронштейн]
  end

  subgraph Edge[Edge-устройство]
    capture[Захват видео]
    detector[Детектор и трекер]
    counter[Подсчёт с направлением]
    buffer[Локальный буфер клипов]
    publisher[On-demand media publisher]
    health[Телеметрия здоровья устройства]
  end

  subgraph Cloud[Облако Gratheon]
    telemetry[telemetry-api]
    video[gate-video-stream]
    model[models-gate-tracker]
    graphql[graphql-router]
    mysql[(MySQL)]
    s3[(S3-compatible storage)]
  end

  subgraph UI[Gratheon web-app]
    web[web-app]
    player[Live player]
    charts[Графики трафика]
    archive[Архив клипов]
  end

  entrance --> cameraHead
  cameraHead --> capture
  capture --> detector
  detector --> counter
  counter -->|bee count, direction, confidence, timestamp| telemetry
  health --> telemetry
  buffer -->|опциональные выбранные клипы| video
  web -->|start/stop live session for box| graphql
  graphql --> video
  video -->|session command| publisher
  publisher -->|publish only while viewed| video
  video --> player
  video -->|опциональный cloud inference/reprocessing| model
  video --> mysql
  video --> s3
  telemetry --> mysql
  web -->|query hive, streams, telemetry| graphql
  graphql --> telemetry
  graphql --> video
  web --> charts
  web --> archive

Оценка текущего подхода

Сводка компонентного анализа

Подробный анализ находится в Component analysis and alternatives. Кратко:

Поток данных

1. Capture — entrance-observer читает кадры с камеры на edge-устройстве.
2. Infer and track — edge-приложение обнаруживает пчёл возле летка, отслеживает движение через настроенные зоны и вычисляет directional counts.
3. Aggregate — raw detections превращаются в telemetry buckets: entrances, exits, unknown direction, confidence и health metadata.
4. Upload metrics — edge-устройство отправляет movement telemetry в telemetry-api через device REST API.
5. Start live stream on demand — когда пчеловод открывает секцию улья и просит live video, web-app запускает короткую сессию через gate-video-stream. Edge-устройство публикует видео только пока сессия активна.
6. Record clips when useful — edge app или recorder в gate-video-stream могут сохранять выбранные клипы для playback, debugging и model retraining.
7. Read in web-app — Gratheon web-app использует graphql-router для user-facing queries и строит time-series charts из telemetry data.
8. Improve model — выбранные клипы используются для проверки detections, retraining модели и сравнения cloud inference с edge inference.

Ответственность API

Связанные страницы

• Фаза 1 — лабораторная валидация
• Фаза 2 — полевой MVP
• Фаза 3 — production kit
• Component analysis and alternatives
• On-demand entrance video streaming
• Future production hardware alternatives
• Jetson Orin setup
• Архив legacy research