Настройка модуля «Скрытие гос. номеров»

Автоматическое скрытие гос. номеров на фотографиях объявлений. Эта инструкция написана для владельца ADWOS CMS: что подготовить, где включить модуль, какие поля проверить и как понять, что запуск прошел корректно.

Когда стоит подключать модуль

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

Что изменится на сайте

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

Что подготовить заранее

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

• Определите страницы, категории или действия, где должна срабатывать проверка.
• Подготовьте юридический текст, ключи провайдера или правила доступа, если они нужны модулю.
• Проверьте сценарий для гостя, обычного пользователя и администратора.
• Не отключайте другие защитные механизмы на боевом сайте ради первичной проверки.

Установка в ADWOS CMS

• Откройте административную панель ADWOS CMS под учетной записью администратора.
• В меню выберите раздел «Каталог», затем откройте «Маркетплейс».
• Найдите модуль «Скрытие гос. номеров» по названию или через список модулей.
• Если модуль еще не установлен, нажмите «Установить» и дождитесь завершения установки.
• Откройте карточку установленного модуля, выберите «Управлять», затем перейдите в «Настройки».
• Заполните обязательные поля, сохраните настройки и включите модуль переключателем.

Настройка модуля

В настройках модуля заполняйте только те значения, которые относятся к вашему проекту. Секретные ключи храните в защищенных полях и не переносите их в открытые тексты, письма или инструкции для пользователей.

• «URL сервиса распознавания номеров». Укажите полный адрес страницы, callback или webhook, который должен использовать внешний сервис. Поле обязательное. Адрес внешнего ALPR-сервиса (POST /detect, multipart image, JSON боксов). Без него модуль не сможет обнаруживать номера. Рекомендуется готовый образ adwos/plate-blur-sidecar.
• «Таймаут ALPR-сервиса». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: 15s. Go duration: 5s, 15s, 1m. По истечении изображение возвращается без обработки.
• «Сила размытия (radius, px)». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: 21. Радиус box-blur, чем больше — тем сильнее размытие. Применяется только в режиме blur.
• «Категории для обработки». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Выберите категории, в которых нужно скрывать номера. Если ничего не выбрано — модуль работает для всех категорий.
• «Порог уверенности». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: 0.45. Минимальная уверенность детектора (0..1), ниже которой бокс игнорируется.
• «Включить скрытие номеров». Переключатель. Включите его только если этот режим нужен в текущем сценарии. Значение по умолчанию: false.
• «Логотип / рамка поверх номера». Загрузите файл в формате, который указан в подсказке поля. Лучше использовать квадратный SVG или PNG, если это иконка. Загрузите PNG/JPG логотип — он будет наложен поверх номерного знака в режиме «Логотип / рамка».
• «Макс. размер фото (MB)». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: 15. Изображения крупнее этого лимита будут отклонены.
• «Режим скрытия». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: blur. blur — размытие; pixelate — пикселизация; frame — наложение вашего логотипа поверх номера (если логотип не загружен — fallback на blur).
• «Отступ вокруг bbox (px)». Укажите значение, которое соответствует правилам вашей площадки или документации модуля. Если поле необязательное, оставляйте его пустым только когда понимаете, как это повлияет на сценарий. Значение по умолчанию: 10. На сколько пикселей расширить область скрытия за пределы найденного номера.

После сохранения обновите страницу панели управления и убедитесь, что модуль остался включенным. Если есть тестовый режим, сначала завершите проверку в нем, а уже потом переходите на боевые ключи.

Проверка перед запуском

• Пройдите защищаемый сценарий как обычный пользователь.
• Проверьте отказ или предупреждение при невыполненном условии.
• Повторите проверку как администратор, чтобы убедиться, что управление сайтом не заблокировано.
• Убедитесь, что текст ошибки объясняет действие без раскрытия внутренних деталей.

Частые ошибки

• Проверка блокирует нужных пользователей. Пересмотрите категории, роли и условия срабатывания.
• Проверка не появляется. Убедитесь, что модуль включен именно для нужной страницы или действия.
• Пользователь не понимает отказ. Уточните текст предупреждения и добавьте ссылку на правила, если она нужна.
• Внешний сервис недоступен. Проверьте ключи, домен и резервное поведение сценария.

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