Развёртывание и локальная разработка

Облачный сервис

Для большинства интеграций достаточно аккаунта консоли и API-ключа. Начните с быстрого старта: разворачивать платформу ради виджета не требуется.

Запуск исходного репозитория

Для операторов с доступом к исходникам: это pnpm-монорепозиторий. API работает на Cloudflare Workers с D1, хранилищем, очередями и другими привязками. Marketing, Console и docs — отдельные Next.js-приложения. Один поисковый движок не заменяет всю платформу.

Используйте требуемую репозиторием версию Node и закреплённую версию pnpm. Из корня:

pnpm install --frozen-lockfile
pnpm --filter @aacsearch/api db:migrate:local
pnpm --filter @aacsearch/api dev

До запуска API скопируйте пример локального окружения в .dev.vars, настройте движок и необходимые привязки. Не добавляйте секреты в Git. В отдельных терминалах запустите приложения:

pnpm --filter @aacsearch/console dev
pnpm --filter @aacsearch/marketing dev
pnpm --filter @aacsearch/docs dev

Укажите правильные адреса API, консоли и документации. При конфликте портов передайте Next.js-приложениям разные порты. Для разработки оплаты используйте тестовые реквизиты.

Production запускается отдельно

Создайте ресурсы из конфигурации развёртывания, подготовьте порядок миграций и production-секреты. До переключения трафика проверьте вход, изоляцию коллекций, фоновые задания, callbacks и восстановление. Не включайте выдачу тестовых тарифов и разработческие платёжные режимы в production. Условия развёртывания и поддержки согласуются отдельно; доступ к исходникам не означает наличие поддерживаемой self-hosted-поставки.