> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Плановые задачи

Повторяющаяся работа workspace через schedule-actions.

## Прохождение для начинающих

Предварительные требования: прочтите два приведенных ниже руководства для начинающих, завершите локальную веб-настройку и откройте этот монорепозиторий в корневой папке вашего редактора. Веб-настройки принадлежат `apps/web/.env.local`; Next.js не читает корень `.env`. `/dashboard` в поддельном режиме по умолчанию представляет собой демонстрацию без базы данных; `/auth` требуется перенесенная база данных.

Вкратце: рабочее пространство — это отдельные пользователи, данные и настройки одной команды. Сервер является доверенным сервером; не допускайте попадания ключей провайдера в код браузера и телефона. Миграция — это изменение версии базы данных, при котором создаются или обновляются таблицы. Модель ИИ — это механизм, который отвечает; Каталог моделей — это список доступных идентификаторов моделей и цен на сервере. Поставщик — это внешняя служба, такая как служба искусственного интеллекта, электронной почты или службы выставления счетов. Право — это грант, который позволяет рабочей области использовать функцию. Вебхук — это сообщение, которое одна служба отправляет на URL другой службы.

1. Откройте Settings → Developers и используйте элементы управления «Расписания», чтобы создать тестовое задание со средой выполнения UTC.

2. Оставьте приложение работающим и сделайте тот же серверный `SCHEDULER_TICK_SECRET` доступным для приложения и терминала; запустите команду ниже из корня репозитория.

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

Для пользовательского кода начните с предоставленного `prompts/README.md` и скопируйте ближайшее приглашение: `prompts/new-app-screen.md` для экрана приложения или `prompts/new-landing-page.md` для общедоступной страницы. Для работы с сервером, базой данных или провайдером дайте своему агенту кодирования задание из этого руководства и попросите его прочитать `AGENTS.md`, `.ai/PROJECT_CONTEXT.md` и соответствующие зеркала `.ai/`; проверьте точные исходные файлы, указанные здесь; список файлов и проверки перед редактированием; сохранять права собственности на рабочую область и секреты, доступные только серверу; и покажу вам разницу. Сообщите ему желаемое поведение, поля ввода и вывода, разрешенные роли, ожидаемые успехи и ошибки, а также тестовую учетную запись, поставщика или устройство. Используйте выборочные значения; никогда не вставляйте настоящий секрет.

[Прежде чем начать](https://supastack.dev/ru/docs/web/before-you-start.md)

[Основные сведения о терминале](https://supastack.dev/ru/docs/web/terminal-basics.md)

[Локальная веб-настройка](https://supastack.dev/ru/docs/web/ship-in-5-minutes.md)

[Подсказки агента и память проекта](https://supastack.dev/ru/docs/web/agents.md)

```
corepack pnpm jobs:tick
```


## Храните повторяющуюся работу в базе данных

Планирование настроек сохраняет тип задания и правило cron в строках `job_schedule` области рабочей области. Поля Cron оцениваются в UTC. `createDrizzleJobScheduler.claimDueSchedules` требует строки с сроком выполнения, используя `FOR UPDATE SKIP LOCKED`, переходит к следующему запуску, а затем отправляет обработчики.

Общий `JobRunner` обещает поставить в очередь/статус/отменить. Повторение принадлежит строкам планировщика; Семантика рабочего процесса Trigger.dev остается явной.


## Планировщик дисков

Установите `SCHEDULER_TICK_SECRET` только для сервера, чтобы включить `POST /api/internal/scheduler-tick`. `corepack pnpm jobs:tick` вызывает это для dev/CI; при отсутствии конфигурации возвращается 404. В `JOB_PROVIDER=trigger` развернутый cron `scheduler.tick` управляет планировщиком.

```
# Against a running local app, with SCHEDULER_TICK_SECRET configured:
corepack pnpm jobs:tick
```


## Проверка претензий и их исполнения отдельно

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

[Пример отправленного файла email.digest](https://supastack.dev/ru/docs/web/project-structure.md)

[Выполнение Trigger.dev](https://supastack.dev/ru/docs/modules/jobs.md)


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

Плановая работа — дайджесты, чистки, продления — идёт через schedule-actions вместо ad-hoc таймеров: listWorkspaceSchedules, upsertScheduleAction и removeScheduleAction управляют cron-задачами workspace.

Расписание называет задачу, cron-выражение и workspace, под которым оно работает. Воркер разрешает контекст во время выполнения, поэтому приостановленное или удалённое расписание прекращает производить работу без передеплоя.

```
listWorkspaceSchedules()
upsertScheduleAction({ task, cron })
removeScheduleAction(formData)
```


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

Относитесь к каждому плановому запуску как к недоверенному вводу: разрешайте workspace и entitlement заново внутри запуска, потому что состояние могло измениться с момента регистрации. Делайте задачу идемпотентной — повторный или двойной запуск не должен дублировать эффекты.

Расписания — это операционная поверхность: держите их видимыми в настройках или логах, чтобы застрявшее или взбесившееся расписание нашлось раньше, чем это заметят пользователи.


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

Вручную запустите расписание в песочнице, приостановите его, проверьте, что отключённый workspace перестаёт производить запуски, и подтвердите, что дублированный запуск даёт один эффект. Держите cron-выражения в управляемой конфигурации, а не разбросанными по коду задач.


## Вперёд

[Транзакционная почта](https://supastack.dev/ru/docs/modules/email.md)