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

Пройдите этот список перед тем, как направить на AACSearch реальный трафик. Каждый раздел заканчивается проверкой, отвечающей на конкретный вопрос; если проверка не проходит, устраните причину до перехода дальше.

Данные

• Импортируйте представительные документы со стабильными id из своего каталога, а не сгенерированными.
• Разберите отклонённые строки — принятый пакет всё равно может содержать построчные ошибки. См. инкрементальную индексацию.
• Проверьте обновления и удаления, а не только первую загрузку.
• Сверьте типы полей, флаги фасетов, поля поиска и сортировки с тем, что действительно нужно вашему интерфейсу.
• Сохраните исходные данные и докажите, что можете пересобрать коллекцию.

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

Доступ

• Полные ключи есть только на сервере. В браузере полного ключа нет.
• Браузерные клиенты используют поисковый ключ, в идеале короткоживущий, созданный через createBrowserKey. См. ключи и виджет.
• Поисковые ключи ограничены теми коллекциями, к которым должны иметь доступ.
• Для браузерных ключей заданы разрешённые origins и IP, и production-origin среди них.

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

Поиск

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

Проверка: измените черновик профиля и убедитесь, что живой поиск не изменился; затем опубликуйте и убедитесь, что изменение применилось. После этого активируйте предыдущий релиз и проверьте, что прежние сортировки и фасеты вернулись.

Оплата и квоты

• Организация на нужном тарифе.

curl https://api.aacsearch.com/v1/entitlement \
  -H "X-NOVA-API-KEY: $NOVA_API_KEY"

• features содержит всё, что вы вызываете. Отсутствующее будет отвечать 403 в production.
• В кошельке есть кредиты, если вы используете ассистента, голос, поиск по фото, семантический поиск или переранжирование.
• Вы знаете, что происходит при нуле: поиск по ключевым словам продолжает работать, измеряемые ИИ-функции отвечают 402.

Проверка: plan в ответе совпадает с купленным, suspended отсутствует или равен false, а quota показывает ожидаемый потолок. См. тарифы, потребление и кредиты.

Эксплуатация

• Нужные вебхуки зарегистрированы, подпись проверена целиком, а намеренно сломанный эндпоинт повторяется.
• Клиент учитывает Retry-After и делает backoff на 500/502/503.
• Повторные записи безопасны: Idempotency-Key для createConnector, event_id для событий и дедупликация доставок вебхуков.
• Базовый набор полезных запросов записан до изменения релевантности.
• Для разделения трафика используются эксперименты.
• Секреты и платёжные привязки проверены в production-окружении: локальный тест не подтверждает приём реальных платежей.
• Записано, кто публикует релевантность, меняет ключи и отвечает на инцидент.

Проверка: намеренно вызовите неудачную доставку вебхука и убедитесь, что в записи видны повторы, а получатель дедуплицирует по X-AACSearch-Delivery.

Восстановление

• Вы можете восстановить каждую коллекцию из исходных данных.
• Учётная запись владельца восстановима: резервные коды двухфакторной аутентификации сохранены, есть второй владелец или администратор.
• Известен путь при инциденте: ящик поддержки и какие сведения туда включать.

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

Далее

• Лимиты и квоты — потолки, которые проверяет этот список.
• Ошибки и повторы — по чему ветвиться, если проверка не прошла.
• Вебхуки — доставка событий в production.