> ## 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

# スケジュールタスク

スケジュールアクションによるワークスペースの定期処理。

## 初心者向けのウォークスルー

前提条件: 以下の 2 つの初心者向けガイドを読み、Web ローカルのセットアップを完了し、エディターでルートにあるこのモノリポジトリを開きます。 Web 設定は `apps/web/.env.local` に属します。 Next.js はルート `.env` を読み取りません。デフォルトのフェイク モードの `/dashboard` はデータベースなしのデモです。 `/auth` には移行されたデータベースが必要です。

簡単に説明すると、ワークスペースは 1 つのチームの個別のユーザー、データ、設定です。サーバーは信頼できるバックエンドです。プロバイダー キーがブラウザーや電話コードに含まれないようにします。移行は、テーブルを作成または更新する、バージョン管理されたデータベースの変更です。 AI モデルは答えを返すエンジンです。モデル カタログは、使用可能なモデル ID と価格のサーバーのリストです。プロバイダーは、AI、電子メール、請求サービスなどの外部サービスです。資格は、ワークスペースで機能を使用できるようにする付与です。 Webhook は、あるサービスが別のサービスの 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/ja/docs/web/before-you-start.md)

【端末の基本】(/docs/web/terminal-basics)

[Webローカル設定](https://supastack.dev/ja/docs/web/ship-in-5-minutes.md)

[エージェント プロンプトとプロジェクト メモリ](https://supastack.dev/ja/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` では、デプロイされた `scheduler.tick` cron がスケジューラを駆動します。

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


## 請求と実行を個別に検証する

重複するティック、期限/期限外ルール、無効な行、ハンドラーの失敗、キャンセル、別のワークスペースのスケジュールをテストします。請求/前払いとジョブの完了を個別に検査します。主張された行は完了した作業の証拠ではありません。

[発送メール.ダイジェスト例](https://supastack.dev/ja/docs/web/project-structure.md)

[Trigger.devの実行](https://supastack.dev/ja/docs/modules/jobs.md)


## インストールとセットアップ

定期処理——ダイジェスト、クリーンアップ、更新——はアドホックなタイマーではなく schedule-actions を通ります：listWorkspaceSchedules、upsertScheduleAction、removeScheduleAction がワークスペースの cron 駆動タスクを管理します。

スケジュールはタスク、cron 式、実行されるワークスペースを名指します。ワーカーは実行時にコンテキストを解決するため、一時停止または削除されたスケジュールは再デプロイなしに処理を止めます。

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


## 実装ワークフロー

すべての定期実行を信頼できない入力として扱います：登録時から状態が変わっている可能性があるため、実行内でワークスペースとエンタイトルメントを再解決します。タスクを冪等にしてください——再試行や二重発火が効果を重複させてはいけません。

スケジュールは運用面です：設定やログで見えるように保ち、スタックしたり暴走したスケジュールをユーザーが気づく前に見つけられるようにします。


## 検証とトラブルシューティング

サンドボックスでスケジュールを手動発火し、一時停止し、無効化されたワークスペースが実行を止めること、二重発火が1つの効果しか生まないことを確認します。cron 式はタスクコードに散らさず、管理された設定に置いてください。


## 次へ

[トランザクションメール](https://supastack.dev/ja/docs/modules/email.md)