| 1 | # Warehouse: Barcode/QR Video Capture v1 |
| 2 | |
| 3 | Общие принципы видеозахвата штрихкодов и QR на складе: читаемость с видео, пиксели на модуль, настройка камер и NVR. Требования маркетплейсов (Ozon, WB, Яндекс Маркет) к этикеткам — в `kb-warehouse-marketplace-labels-v1.md`. |
| 4 | |
| 5 | **world:** `logistics.warehouse` |
| 6 | |
| 7 | --- |
| 8 | |
| 9 | ## 1. Читаемость штрихкода/QR с видео (общие принципы) |
| 10 | |
| 11 | Без привязки к конкретным камерам и данным пользователя. |
| 12 | |
| 13 | ### 1.1 Пиксели на модуль |
| 14 | |
| 15 | - **QR-код:** для стабильного декодирования по видео каждый **модуль** (чёрный/белый квадрат) должен быть не менее **3–3,5 пикселей** в кадре (исследования у Nyquist-предела; декодеры различаются — Zbar устойчивее OpenCV на граничных случаях). |
| 16 | - **Линейный штрихкод:** практический минимум **≥2 пикселя на модуль**; при 1 px возможны серые оттенки и сбои при неидеальном угле/фокусе. |
| 17 | |
| 18 | ### 1.2 Что влияет на читаемость |
| 19 | |
| 20 | - **Расстояние камера–этикетка:** с ростом расстояния модули занимают меньше пикселей — нужно либо приблизить камеру/зону предъявления, либо повысить разрешение/уменьшить FOV. |
| 21 | - **Разрешение и FOV:** важно не физический размер этикетки, а **сколько пикселей приходится на этикетку в кадре**. Для этикетки 40×50 мм при 2 px/модуль (например, ~2 мм на модуль) нужно порядка 20×25 модулей по ширине/высоте → минимум ~40×50 пикселей на этикетку; на практике лучше 3–4 px/модуль и запас по краям. |
| 22 | - **Освещение и контраст:** равномерный свет без бликов; контраст штрихкода от 70% (как в требованиях WB) способствует и видеосъёмке. |
| 23 | - **Кодек и битрейт:** сильное сжатие (низкий битрейт, агрессивный H.264/H.265) размывает мелкие детали и может «слить» тонкие полосы штрихкода; для зон с текстом/кодами предпочтительны более высокий битрейт и по возможности меньшая агрессивность сжатия при той же разрешённости. |
| 24 | - **Глубина резкости и фокус:** этикетка и зона предъявления должны попадать в зону резкости; при малой глубине резкости размытие делает модули неразличимыми независимо от разрешения. |
| 25 | |
| 26 | ### 1.3 Две типичные зоны съёмки |
| 27 | |
| 28 | 1. **Зона выхода этикетки из принтера** — фиксация самого факта печати и (при достаточном разрешении) содержимого/кода. |
| 29 | 2. **Зона предъявления этикетки камере / наклеивания на груз** — этикетка в кадре, читаемый код для последующей проверки или разбора претензий. |
| 30 | |
| 31 | Для обеих зон расчёт одинаков: целевой размер этикетки в пикселях → из требуемых px/модуль и размера этикетки (мм) вывести нужное разрешение и FOV/расстояние. |
| 32 | |
| 33 | --- |
| 34 | |
| 35 | ## 2. Типовой кейс: парк камер, две зоны, два типоразмера этикеток |
| 36 | |
| 37 | Ориентир для конфигураций «склад — печать и предъявление ШК под запись». |
| 38 | |
| 39 | **Типоразмеры этикеток (мм):** 40×50 и 120×70 (самоклеящиеся). На каждом столе (упаковка отправлений, приём/возвраты) должна быть видна этикетка; маркетплейсы требуют захват и выхода из принтера, и зоны предъявления. |
| 40 | |
| 41 | **Две зоны захвата:** |
| 42 | 1. **Выход из принтера** — принтер этикеток сбоку от стола; этикетка при печати (подложка «вверх») должна попадать в кадр и давать читаемый код на записи. |
| 43 | 2. **Зона на столе / на товаре** — обозначенный квадрат, куда направлена камера; сотрудник показывает ШК камере; затем этикетка наклеивается на упаковку. Нужна читаемость и в момент предъявления, и на наклеенной этикетке. |
| 44 | |
| 45 | **Расстояние и свет:** камера–рабочая зона от ~1 м до ~2 м в зависимости от стола; освещение разное (есть/нет отдельного света). Связь с NVR — по PoE через коммутатор. |
| 46 | |
| 47 | **Пример парка (12 камер, Hikvision):** |
| 48 | |
| 49 | | Модель | Кол-во | Разрешение | Назначение | |
| 50 | |--------|--------|------------|------------| |
| 51 | | DS-2CD2083G2-IU | 5 | 4K, 8 Мп | Зоны с чтением ШК (столы упаковки, возвратов) | |
| 52 | | DS-I453M(C) | 4 | не 4K | Обзор | |
| 53 | | DS-I403(D) | 1 | не 4K | Обзор | |
| 54 | | DS-I202(E) | 1 | не 4K | Обзор | |
| 55 | | DS-I450L(C) | 1 | не 4K | Обзор | |
| 56 | |
| 57 | Максимально чёткие настройки (высокий битрейт, без лишнего сжатия/сглаживания, H.265, 20 fps при возможности) — для 4K-камер; остальные общее обозрение. |
| 58 | |
| 59 | ### 2.1 Документация, спецификации, playbook и evidence по моделям |
| 60 | |
| 61 | Подробный контент (даташиты Hikvision, таблицы FOV/разрешение/битрейт, playbook настроек 4K под ШК, evidence-расчёт «почему 4K не читает» при 2.8 mm, чек-лист) вынесен в **L1 (load on demand):** `kb-warehouse-barcode-video-models-l1-v1.md`. По запросу о конкретных моделях камер (DS-2CD2083G2-IU и др.), расчёте px/модуль по FOV и расстоянию или настройках NVR под штрихкод — подгружать этот файл. |
| 62 | |
| 63 | --- |
| 64 | |
| 65 | ## 3. Операционный слой (маршрутизация) |
| 66 | |
| 67 | | # | Запрос | Действие | Граница переноса | |
| 68 | |---|--------|----------|-------------------| |
| 69 | | R2 | Почему штрихкод/QR не читается с видео, сколько нужно пикселей | §1: px/модуль (QR 3–3,5, штрихкод ≥2), расстояние, FOV, разрешение, свет, кодек, резкость | Общие принципы; точные значения под конкретную камеру и этикетку — расчёт по данным | |
| 70 | | R3 | Настройка камер/NVR под съёмку этикеток | §1 + общее: разрешение и FOV под размер этикетки в кадре, битрейт выше для зон с текстом/кодом, освещение, глубина резкости | Без доступа к данным пользователя — только чеклист и формулы | |
| 71 | |
| 72 | --- |
| 73 | |
| 74 | ## 4. Transfer boundary |
| 75 | |
| 76 | - Применимо к **общим принципам** видеозахвата штрихкодов/QR (пиксели на модуль, разрешение, освещение, кодек) и к **ориентирам по моделям** (§2.1: документация, спецификации, playbook, evidence для парка Hikvision). |
| 77 | - Внутренние регламенты склада, привязка к конкретным столам/точкам и настройки NVR — за пределами документа; расчёт по §1–§2 с подстановкой параметров камеры и зоны. |
| 78 | |
| 79 | |