Первичная настройка

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

1. Войдите как Owner

Используйте email и пароль из AUTH_ADMIN_EMAIL и AUTH_ADMIN_PASSWORD. Убедитесь, что доступны Dashboard, App Feedback, Users, Roles, Audit Log и Settings. Отсутствующий пункт меню обычно означает отсутствие permission.

2. Настройте SMTP

Для production восстановление пароля требует SMTP_*. Проверьте доставку:

pnpm email:test -- recipient@example.com

3. Подключите источники отзывов

Откройте Settings → App Feedback integrations.

Источник	Что подготовить
Apple	App ID, Issuer ID, Key ID и приватный `.p8` с доступом к customer reviews
Google	Android package name и service-account JSON с `Reply to reviews`
Minfin	Только включить; credentials не нужны

Укажите polling interval, сохраните форму и для Apple/Google выполните Test saved connection.

Google может вернуть 0 отзывов

Успешный ответ с нулевым результатом означает, что credentials и package name приняты, но в доступном Google API окне нет подходящих production-отзывов с текстом.

4. Выполните первую синхронизацию

Нажмите Sync now. Проверьте:

результат последнего sync в Settings;
записи в Audit Log;
импортированные строки в App Feedback;
запуск worker и последующее изменение lastSuccessAt.

5. Подготовьте QR-канал

В Settings → Entity management создайте подразделение или другую entity.
При необходимости добавьте до 10 email-получателей и Google Maps URL.
В Settings → QR Feedback form выберите English или Українська.
В QR Management создайте QR-код и назначьте entity.
Скачайте код и сделайте тестовую отправку с мобильного устройства.

6. Добавьте команду

Создайте пользователя в Users, назначьте роль и попросите пройти установку пароля по email. Для оператора App Feedback обычно достаточно роли Customer Support Agent.

Критерии готовности

/health отвечает успешно;
web и worker работают;
вход, reset password и email-тест проходят;
источники сохраняются и тестируются;
ручной sync создаёт FeedbackSyncRun;
тестовый QR-отзыв появляется в inbox и аналитике;
административные действия видны в Audit Log.