---
generated_at: 2026-03-01 10:50:00
metrics:
  claims_total: 30
  claims_with_evidence: 28
  claims_without_evidence: 2
confidence_derived: 0.93
---

# 根拠レポート：5-ジョブキュー.md

## 本レポートについて

### 目的
本レポートは、生成された設計書・ドキュメントの信頼性を検証し、人間レビュアーが効率的にレビューできるようにすることを目的としています。

### チェック方法
以下の観点でドキュメントの内容（Claim：主張）を検証しています：

1. **根拠の有無確認**：各主張に対して、ソースコード・既存設計書・要件定義書などの根拠（Evidence）が存在するか
2. **根拠との整合性**：主張の内容が根拠と矛盾していないか
3. **網羅性**：参照すべき情報源を適切にカバーしているか

### 信頼度スコアの算出
- **confidence_derived** = 根拠あり件数 / 総主張件数
- 状態「○」：根拠あり、「△」：根拠不足または要確認

### 本レポートの使い方
1. まず「サマリー」で全体の信頼度と優先レビュー項目を確認
2. 「Claims と根拠の対応」で △ の項目を重点的にレビュー
3. 「不足情報」で補完が必要な情報源を確認

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.93**
  - 根拠あり：28 / 30、根拠なし：2
- 優先レビュー（高）
  1. **関連画面のマッピング**：管理画面との整合性確認
  2. **JSONSchema**：入力/出力スキーマの詳細確認

## 2) 参照した情報（Evidence一覧）
> ここに「実在するもの」だけ列挙。抽出フェーズで付けたIDをそのまま出す。

- E-01: `/packages/payload/src/queues/localAPI.ts` - ローカルAPI定義
- E-02: `/packages/payload/src/queues/operations/runJobs/index.ts` - ジョブ実行処理
- E-03: `/packages/payload/src/queues/config/types/taskTypes.ts` - タスク型定義
- E-04: `/packages/payload/src/queues/config/types/workflowTypes.ts` - ワークフロー型定義
- E-05: `docs/code-to-docs/機能一覧/機能一覧.csv` - 機能一覧

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | queue操作でジョブを追加できる | E-01 (52-248行目) | ○ |
| C-02 | run操作でジョブを実行できる | E-01 (250-315行目), E-02 | ○ |
| C-03 | cancel操作でジョブをキャンセルできる | E-01 (349-415行目) | ○ |
| C-04 | queueパラメータでキュー名を指定可能（デフォルト: 'default'） | E-01 (126-138行目), E-02 (89行目) | ○ |
| C-05 | waitUntilで実行開始予定日時を指定可能 | E-01 (147-149行目) | ○ |
| C-06 | limitで最大実行件数を指定可能（デフォルト: 10） | E-02 (86行目) | ○ |
| C-07 | allQueuesで全キューから実行可能 | E-02 (85行目, 144-150行目) | ○ |
| C-08 | sequentialで順次実行が可能 | E-02 (476-482行目) | ○ |
| C-09 | processingOrderで処理順序を指定可能 | E-02 (216-247行目) | ○ |
| C-10 | silentでログ出力を抑制可能 | E-02 (322-328行目) | ○ |
| C-11 | enableConcurrencyControlで同時実行制御が可能 | E-01 (162-224行目), E-02 (157-194行目) | ○ |
| C-12 | supersedes=trueで同一keyの未処理ジョブを削除 | E-01 (194-221行目) | ○ |
| C-13 | ジョブにprocessing, completedAt, hasErrorフィールドがある | E-02 (クエリ条件) | ○ |
| C-14 | ジョブにtotalTriedフィールドで試行回数を管理 | E-02 (310-320行目) | ○ |
| C-15 | 実行可能ジョブは複数条件で検索される | E-02 (112-142行目) | ○ |
| C-16 | 同一concurrencyKeyのジョブは並列実行されない | E-02 (157-194行目) | ○ |
| C-17 | 取得したジョブをprocessing=trueに更新してから実行 | E-02 (202-210行目, 236-252行目) | ○ |
| C-18 | 成功時にdeleteJobOnComplete設定で削除可能 | E-02 (491-514行目) | ○ |
| C-19 | ワークフローではtasksオブジェクトが提供される | E-04 (WorkflowHandler定義) | ○ |
| C-20 | runJobはworkflowHandlerまたはrunJSONJobを呼び出す | E-02 (403-433行目) | ○ |
| C-21 | JobCancelledErrorでキャンセル処理される | E-02 (435-470行目) | ○ |
| C-22 | overrideAccess=falseでアクセス制御が実行される | E-01 (115-124行目), E-02 (102-111行目) | ○ |
| C-23 | ワークフローにconcurrency設定が可能 | E-01 (167-176行目) | ○ |
| C-24 | タスクにretries設定が可能 | E-03 (retries定義) | ○ |
| C-25 | タスクにonFail, onSuccessハンドラが設定可能 | E-03 (onFail, onSuccess定義) | ○ |
| C-26 | handleSchedulesでスケジュール処理が可能 | E-01 (25-51行目) | ○ |
| C-27 | runByIDでID指定実行が可能 | E-01 (317-347行目) | ○ |
| C-28 | cancelByIDでID指定キャンセルが可能 | E-01 (417-460行目) | ○ |
| C-29 | 関連画面（ADM-030〜ADM-031）のマッピング | **根拠なし** | △ |
| C-30 | inputSchema/outputSchemaでJSONSchemaバリデーション | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）
- **C-29**: 画面機能マッピング.csvに具体的な画面IDの記載がないため推測
  - 候補：管理画面の実装コード確認
- **C-30**: JSONSchemaバリデーションの実際の実行箇所の確認が必要
  - 候補：タスク実行時のバリデーション処理確認

## 5) リスクフラグ（レビュー観点）
- **0 (低リスク)**: ジョブのキューイングと実行フロー
- **0 (低リスク)**: 同時実行制御のロジック
- **1 (中リスク)**: JSONSchemaバリデーションの詳細

## 6) レビュアーチェックリスト（最小）
- [ ] queue操作のパラメータが最新の実装と一致しているか確認
- [ ] run操作のクエリ条件が正確か確認
- [ ] 同時実行制御のロジックが正確か確認
- [ ] リトライ処理とバックオフ計算が正確か確認
- [ ] JSONSchemaバリデーションの実装有無を確認
