Работа с QR Feedback

Модель QR-канала

Entity — подразделение, отделение или другая бизнес-единица. Managed QR code ссылается на одну entity. Каждый публичный отзыв сохраняет snapshot связи, поэтому последующее изменение назначения не переписывает историю.

Создание entity

В Settings → Entity management:

1. Укажите название и необязательное описание.
2. При необходимости добавьте до 10 email-адресов через запятую.
3. Включите email notifications, только если список получателей заполнен.
4. Добавьте trusted HTTPS Google Maps URL.
5. Включите Google Maps prompt, если хотите показывать кнопку после оценок 8–10.

Выпуск QR-кода

1. Откройте QR Management.
2. Создайте запись, задайте понятное имя и выберите entity.
3. Скачайте PNG или SVG.
4. Проверьте ссылку на реальном мобильном устройстве.
5. Только после проверки размещайте код в печати или на стойке.

Публичный URL имеет вид /qr-feedback?qr=<token>. Не заменяйте token вручную и не добавляйте в URL название entity.

Публичная форма

• общий язык всех форм выбирается в Settings → QR Feedback form;
• поддерживаются English и Українська;
• rating обязателен и принимает 1–10;
• comment необязателен, максимум 2000 символов;
• один source host может отправить не более трёх успешных форм за 10 минут;
• повторная доставка одного idempotency key не создаёт дубликат.

Работа с inbox

На странице QR Feedbacks используйте поиск, даты, entity, QR-код и rating для фильтрации. Удаление требует qr.feedback.delete и выполняется как soft delete: запись исчезает из inbox и аналитики, но остаётся доступной для аудита и сохранения исторических связей.

Метрики

В системе используются две разные классификации:

• adapted NPS: 1–6 detractors, 7–8 passives, 9–10 promoters;
• визуальные зоны distribution: красная 1–4, жёлтая 5–7, зелёная 8–10.

Цветовые зоны — только представление и не меняют формулу adapted NPS.