Перейти к содержимому
supastack
Обзор документации
ДесктопTauri

For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ru/docs/modules/jobs.md (or send Accept: text/markdown).

Задачи Trigger.dev

Держите устойчивое поведение workflow явным.

Задать вопрос об этом руководстве
Открыть в

Настройка и конфигурация

Перед любым действием прочтите Перед началом работы и Основные сведения о терминале. В этих инструкциях предполагается, что вы открыли полный монорепозиторий supastack в VS Code; его корень package.json отмечает корень репозитория. В командах pnpm пакет рабочей области представляет собой папку приложения или общего кода; В продукте рабочее пространство — это контейнер данных и граница безопасности команды. corepack pnpm --filter ... выбирает один пакет из монорепозитория, пока команды выполняются из его корня. Если вы открыли только синхронизированную папку мобильного устройства или рабочего стола, она не содержит веб-серверной части, настройки Docker или корневых сценариев: запустите серверную часть из этого монорепозитория или доступного размещенного сервера и используйте собственные сценарии папки платформы. Переменная среды — это именованный параметр, хранящийся в локальном файле .env или на панели управления хостингом; перезапустите соответствующее приложение после его изменения и не допускайте попадания секретов сервера в значения NEXT_PUBLIC_ и EXPO_PUBLIC_.

1. Откройте apps/web/src/job-handlers.ts и apps/web/src/scheduler-runtime.ts в VS Code. Работа — это фоновая работа; планировщик решает, когда поставить его в очередь.

2. Для локальной галочки устанавливаем одинаковый SCHEDULER_TICK_SECRET в apps/web/.env.local и корневой .env репозитория; сценарий тикания считывает корневой файл .env, а конечная точка Интернета считывает настройки своего приложения.

3. Запустите Web с помощью corepack pnpm --filter @supastack/web dev, затем запустите corepack pnpm jobs:tick из корня. Ожидается: терминал показывает результат POST из localhost:3000. Trigger.dev является отдельным поставщиком и нуждается в собственной учетной записи и ключах сервера.

Установите JOB_PROVIDER=trigger с серверными TRIGGER_SECRET_KEY и TRIGGER_PROJECT_REF для отправки продакшен-задач. Просмотрите apps/web/trigger.config.ts и задачу ai.generate в apps/web/trigger до настройки целевого проекта.

JOB_PROVIDER=trigger
TRIGGER_PROJECT_REF=your-project-reference
# Provide TRIGGER_SECRET_KEY through the server secret store.

Команды для копирования

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

# Terminal 1 — start the Web app from the monorepo root:
corepack pnpm --filter @supastack/web dev

# Terminal 2 — run one scheduler tick from the monorepo root:
corepack pnpm jobs:tick

Рабочий процесс внедрения

Общий контракт JobRunner обещает enqueue, status и cancel. Trigger.dev владеет семантикой, специфичной для workflow; не выводите планирование, повторы или гарантии устойчивости из общего интерфейса.

Устойчивый ID задачи приложения связывает отправку, выполнение работником, записи использования и результаты. Неудачное прикрепление метаданных запуска провайдера после подтверждённой отправки не должно вызывать повторную отправку или инвалидировать принятую работу.

Проверка и устранение неполадок

Если тик возвращает 404, убедитесь, что секрет существует в обоих файлах настроек и точно соответствует, а затем перезапустите Web. Если терминал сообщает, что соединение отклонено, сначала запустите Web. Если ни одно задание не выполнялось, проверьте, включено ли расписание и срок выполнения; одна отметка не приводит к немедленному запуску будущего расписания.

Проверьте, что развёрнутый идентификатор задачи и проект совпадают с настроенным окружением. Отделяйте приём отправки от завершения workflow и от доставки почты. Прочитайте docs/production-ai-runtime.md о восстановлении и безопасной диагностике до ручного повтора работы.

Часто задаваемые вопросы

14 вопросов

Что такое supastack?

supastack — модульная основа для создания SaaS-продуктов с AI. Она объединяет общую инфраструктуру, чтобы вы могли сосредоточиться на продуктовых функциях.

Поддерживает ли он web и mobile?

Да. supastack включает приложения Next.js и Expo как отправные точки для web- и мобильных интерфейсов.

Какая аутентификация включена?

Better Auth покрывает e-mail/пароль, OTP и социальный вход. Личные воркспейсы провижинируются вместе с аккаунтом, чтобы продуктовые записи были ограничены с первого дня.

Как он поддерживает AI?

supastack включает настраиваемый мультипровайдерный AI, учёт использования, бюджеты и зашифрованную поддержку bring-your-own-key.

Как обрабатываются подписки?

Для продуктов на ките Stripe-биллинг, подписки и права доступа образуют основу платного доступа. Секреты провайдеров остаются только на сервере.

Где живёт мой продуктовый код?

Продуктовые функции остаются в отдельном коде, а продукт настраивает и интегрирует модули основы supastack.

Как устроены цены supastack?

Кит — разовая покупка с пожизненными обновлениями: один фреймворк за $249 (временная стартовая цена — скидка $100 от стандартной цены $349) или все фреймворки (Next.js, iOS, Android) за $499 (временная стартовая цена — скидка $100 от стандартной цены $599), плюс $75 за каждое дополнительное место разработчика. Без подписки на кит. Оплата на этом сайте доставляет лицензионный ключ по e-mail, доступ к репозиторию — через приглашение GitHub.

Как воркспейсы ограничивают мои данные?

Записи пользователей ограничены по workspaceId. Идентичность, права доступа, AI-использование, события биллинга и записи аудита остаются внутри границы личного воркспейса.

Как работают фоновые задачи?

Trigger.dev — явный рантайм задач. Контракт JobRunner обещает только enqueue, status и cancel — семантика workflow остаётся специфичной для Trigger.dev и явной.

Чем почта отличается от рассылок?

Транзакционная почта покрывает продуктовые сценарии вроде уведомлений о завершении. Холодные рассылки и кампании — забота продукта, вне почтового модуля этого кита.

Как работают покупки в мобильном приложении?

Мобильное приложение поддерживает нативные покупки и восстановление через RevenueCat, а сервер проверяет доступ. Настройте аккаунты магазинов и завершите тестирование на устройствах перед публикацией. Веб-оплата остается отдельной.

Где хранятся ключи AI-провайдеров?

Bring-your-own-key креденшелы зашифрованы и остаются только на сервере. Ключи удаляются из логов; использование и бюджеты видны на уровне воркспейса.

Какие способы оплаты принимает оформление заказа?

Оформление заказа на Stripe принимает карты, а после включения кошельков в аккаунте Stripe может также предлагать Alipay и WeChat Pay — удобно для покупателей из Китая. Авторизации кошельков подтверждаются асинхронно, поэтому страница лицензии обновляется, как только платёж завершается.

Могу ли я получить возврат средств?

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

RU
Тема