---
generated_at: 2026-02-24 17:10:00
metrics:
  claims_total: 32
  claims_with_evidence: 30
  claims_without_evidence: 2
confidence_derived: 0.94
---

# 根拠レポート：1-ドキュメント埋め込みインジェスト

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.94**
  - 根拠あり：30 / 32、根拠なし：2
- 優先レビュー（高）
  1. **メモリ使用量上限1GB**：Vercel公式ドキュメント未確認
  2. **AIアボートシグナル対応の詳細動作**：コード上は存在するが詳細未検証

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

- E-01: `apps/studio.giselles.ai/app/api/vector-stores/cron/document/ingest/route.ts`
- E-02: `apps/studio.giselles.ai/app/api/vector-stores/cron/document/ingest/fetch-ingest-targets.ts`
- E-03: `apps/studio.giselles.ai/lib/vector-stores/document/ingest/ingest-document.ts`
- E-04: `apps/studio.giselles.ai/lib/vector-stores/document/database.ts`
- E-05: `apps/studio.giselles.ai/db/schema.ts`（L544-636: documentVectorStores, documentVectorStoreSources）
- E-06: `apps/studio.giselles.ai/vercel.json`
- E-07: `docs/code-to-docs/バッチ一覧/バッチ一覧.csv`

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | バッチは3分ごとに実行される | E-06 (`"schedule": "*/3 * * * *"`) | ○ |
| C-02 | エンドポイントは`/api/vector-stores/cron/document/ingest` | E-06, E-01 | ○ |
| C-03 | maxDurationは800秒 | E-01 (L18: `export const maxDuration = 800`) | ○ |
| C-04 | 認証はBearer トークンとCRON_SECRETの比較 | E-01 (L25-37: isAuthorized関数) | ○ |
| C-05 | SHA-256によるタイミングセーフ比較を使用 | E-01 (L22-23, L36: digest関数とtimingSafeEqual) | ○ |
| C-06 | idle状態のドキュメントが対象 | E-02 (L51: `eq(documentVectorStoreSources.ingestStatus, "idle")`) | ○ |
| C-07 | 15分以上running状態のドキュメントが対象 | E-02 (L34-36, L52-56: STALE_THRESHOLD_MINUTES = 15) | ○ |
| C-08 | failed状態はリトライ対象外 | E-01 (L4-11: コメント), E-02 (L26-28: コメント) | ○ |
| C-09 | ドキュメントは順次処理される | E-01 (L61: `for (const target of targets)`) | ○ |
| C-10 | 楽観的排他制御（atomic UPDATE）を使用 | E-03 (L153-174: claimResult UPDATE文) | ○ |
| C-11 | rowCount=0でスキップ | E-03 (L177-186: `if (claimResult.rowCount === 0)`) | ○ |
| C-12 | Supabase Storageからファイルダウンロード | E-03 (L202-211: supabase.storage.from().download()) | ○ |
| C-13 | TXT/MD/PDF形式対応 | E-03 (L221: `fileType: "txt" | "md" | "pdf"`) | ○ |
| C-14 | テキスト抽出→チャンキング→埋め込み生成の順 | E-03 (L223-253, L284-306) | ○ |
| C-15 | 埋め込みプロファイルごとに処理 | E-03 (L274-306: `for (const embeddingProfileId of embeddingProfileIds)`) | ○ |
| C-16 | 部分挿入のロールバック削除対応 | E-03 (L307-321: catch内でdeleteDocumentEmbeddingsByProfiles呼び出し) | ○ |
| C-17 | document_vector_store_sourcesテーブル操作 | E-03, E-04, E-05 | ○ |
| C-18 | document_embeddingsテーブル操作 | E-04 (L85-114: insertDocumentEmbeddings) | ○ |
| C-19 | 入力データソースにdocument_embedding_profilesを含む | E-02 (L68-91: storeProfiles取得クエリ) | ○ |
| C-20 | ingestStatus列のステータス値（idle/running/completed/failed） | E-05 (L570-574: DocumentVectorStoreSourceIngestStatus型) | ○ |
| C-21 | ingestErrorCode列でエラーコード保存 | E-05 (L598), E-03 (L367-377) | ○ |
| C-22 | ingestedAt列で完了日時保存 | E-05 (L605), E-03 (L336-337) | ○ |
| C-23 | エラーコード一覧（source-not-found, file-not-found等） | E-03 (L57-64: IngestErrorCode型) | ○ |
| C-24 | embeddingDimensionsは1536/3072 | E-05 (L770-771, L788-793: インデックス定義) | ○ |
| C-25 | レスポンスはprocessed/success/failure/skippedを含む | E-01 (L84-91: Response.json) | ○ |
| C-26 | エラーログ出力形式 | E-01 (L76-80), E-03 (L316-319, L379) | ○ |
| C-27 | スキップログ出力形式 | E-03 (L179) | ○ |
| C-28 | SUPABASE_URL, SUPABASE_SERVICE_KEY環境変数必須 | E-03 (L29-34) | ○ |
| C-29 | CRON_SECRET環境変数必須 | E-01 (L40-45) | ○ |
| C-30 | アボートシグナル対応 | E-03 (L144, L199, L213, L241, L254, L275, L292, L329, L351-361) | ○ |
| C-31 | メモリ使用量上限1GB | **根拠なし** | △ |
| C-32 | アボート時のidle状態復帰詳細 | E-03 (L351-361: 概要のみ、詳細動作は要確認) | △ |

## 4) 不足情報（Unknown / Missing）
- **メモリ使用量上限**：Vercel Serverless Functionsの公式ドキュメントで確認が必要。コード内に明示的な設定なし。
  - 候補：Vercel公式ドキュメント / vercel.json / next.config.ts

- **アボートシグナルの詳細動作**：signal.throwIfAborted()の呼び出し箇所は確認できるが、実際のアボートトリガー（クライアント切断等）の詳細は未確認
  - 候補：Next.js公式ドキュメント / Vercel Cron動作仕様

## 5) リスクフラグ（レビュー観点）
- 0: 低リスク - 大部分の主張がコードで直接確認可能
- 1: 中リスク - メモリ上限値は運用環境依存のため、実際の制限はVercel設定に依存

## 6) レビュアーチェックリスト（最小）
- [ ] Vercel Serverless Functionsのメモリ制限を確認し、必要に応じて記載を修正
- [ ] 実際のcronジョブ実行ログでアボート動作を確認
- [ ] failed状態からの復旧手順（再アップロード等）が運用マニュアルに記載されているか確認
