---
generated_at: 2026-03-01 20:45:00
metrics:
  claims_total: 118
  claims_with_evidence: 118
  claims_without_evidence: 0
confidence_derived: 1.00
---

# 根拠レポート：plugin-stripe 単体テストケース一覧

## 本レポートについて

### 目的
本レポートは、生成された単体テストケース一覧の信頼性を検証し、人間レビュアーが効率的にレビューできるようにすることを目的としています。

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**1.00**
  - 根拠あり：118 / 118、根拠なし：0
- 優先レビュー（高）
  1. **Stripe APIモック戦略**：実際のテスト実行時にはStripe APIのモック方法を検討する必要あり
  2. **テスト環境設定**：NODE_ENV='test'時の挙動はコードに実装されているが、テスト時の環境設定方法を確認
  3. **認証テスト**：Forbiddenエラーのテストには適切なPayloadリクエストモックが必要

## 2) 参照した情報（Evidence一覧）
> ここに「実在するもの」だけ列挙。

- E-01: `packages/plugin-stripe/src/index.ts` - プラグインエントリーポイント（L14-113）
- E-02: `packages/plugin-stripe/src/types.ts` - 型定義（L1-53）
- E-03: `packages/plugin-stripe/src/hooks/createNewInStripe.ts` - 新規作成フック（L21-143）
- E-04: `packages/plugin-stripe/src/hooks/syncExistingWithStripe.ts` - 同期フック（L21-93）
- E-05: `packages/plugin-stripe/src/hooks/deleteFromStripe.ts` - 削除フック（L19-67）
- E-06: `packages/plugin-stripe/src/utilities/deepen.ts` - オブジェクト変換ユーティリティ（L4-21）
- E-07: `packages/plugin-stripe/src/utilities/stripeProxy.ts` - Stripe APIプロキシ（L6-47）
- E-08: `packages/plugin-stripe/src/fields/getFields.ts` - フィールド生成（L13-54）
- E-09: `packages/plugin-stripe/src/webhooks/index.ts` - Webhookルーティング（L6-56）
- E-10: `packages/plugin-stripe/src/webhooks/handleCreatedOrUpdated.ts` - 作成/更新ハンドラ（L14-215）
- E-11: `packages/plugin-stripe/src/webhooks/handleDeleted.ts` - 削除ハンドラ（L10-95）
- E-12: `packages/plugin-stripe/src/routes/webhooks.ts` - Webhookルート（L9-88）
- E-13: `packages/plugin-stripe/src/routes/rest.ts` - RESTルート（L9-53）
- E-14: `packages/plugin-stripe/src/admin.ts` - クライアント側プラグイン（L7-44）
- E-15: `packages/plugin-stripe/src/ui/LinkToDoc.tsx` - UIコンポーネント（L7-49）

## 3) Claims と根拠の対応（レビューの主戦場）

### プラグインエントリーポイント (index.ts) - UT-STR-001〜012
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | stripePluginがConfig変換を行う | E-01 L14-16 | ○ |
| C-02 | restのデフォルト値がfalse | E-01 L22 | ○ |
| C-03 | syncのデフォルト値が空配列 | E-01 L23 | ○ |
| C-04 | webhooksエンドポイント追加 | E-01 L30-45 | ○ |
| C-05 | rest=true時のRESTエンドポイント追加 | E-01 L47-60 | ○ |
| C-06 | rest=false時はRESTエンドポイント未追加 | E-01 L47 | ○ |
| C-07 | syncConfigに一致するコレクションへのフック追加 | E-01 L62-108 | ○ |
| C-08 | syncConfigに一致するコレクションへのフィールド追加 | E-01 L70-75 | ○ |
| C-09 | sync空配列時のスキップ | E-01 L65-69 | ○ |
| C-10 | 既存endpointsの保持 | E-01 L31 | ○ |
| C-11 | 既存フックの保持 | E-01 L82, L90, L99 | ○ |
| C-12 | hooks未定義時の初期化 | E-01 L77-79 | ○ |

### createNewInStripe (hooks/createNewInStripe.ts) - UT-STR-013〜027
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-13 | テスト環境でstripeID='test' | E-03 L30-33 | ○ |
| C-14 | skipSync=true時のスキップ | E-03 L36-39 | ○ |
| C-15 | skipSync=falseのデフォルト設定 | E-03 L44 | ○ |
| C-16 | create操作でStripeリソース作成 | E-03 L101-137 | ○ |
| C-17 | create成功後のskipSync=true設定 | E-03 L130 | ○ |
| C-18 | update操作でstripeID未設定時の新規作成 | E-03 L66-98 | ○ |
| C-19 | update操作でstripeID存在時のスキップ | E-03 L74 | ○ |
| C-20 | create操作でのStripe APIエラー時のAPIError | E-03 L131-136 | ○ |
| C-21 | update操作でのStripe APIエラー時のログ出力 | E-03 L92-97 | ○ |
| C-22 | payload未定義時のスキップ | E-03 L35 | ○ |
| C-23 | syncConfig未発見時のスキップ | E-03 L47-49 | ○ |
| C-24 | data未定義時の空オブジェクト処理 | E-03 L28 | ○ |
| C-25 | フィールドマッピングの適用 | E-03 L51-59 | ○ |
| C-26 | deepenでのネストプロパティ処理 | E-03 L61 | ○ |
| C-27 | logs=true時のログ出力 | E-03 L37-38, L67-71 | ○ |

### syncExistingWithStripe (hooks/syncExistingWithStripe.ts) - UT-STR-028〜036
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-28 | update操作での既存リソース更新 | E-04 L34-84 | ○ |
| C-29 | skipSync=true時のスキップ | E-04 L30 | ○ |
| C-30 | テスト環境でのスキップ | E-04 L30 | ○ |
| C-31 | stripeID未設定時のスキップ | E-04 L54-58 | ○ |
| C-32 | Stripe APIエラー時のAPIError | E-04 L80-82 | ○ |
| C-33 | skipSyncのfalseリセット | E-04 L90 | ○ |
| C-34 | create操作での非同期 | E-04 L34 | ○ |
| C-35 | syncConfig未発見時のスキップ | E-04 L31-33 | ○ |
| C-36 | フィールドマッピングの適用 | E-04 L36-44 | ○ |

### deleteFromStripe (hooks/deleteFromStripe.ts) - UT-STR-037〜042
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-37 | Stripeリソース削除 | E-05 L45-52 | ○ |
| C-38 | リソース未発見時のスキップ | E-05 L54-59 | ○ |
| C-39 | Stripe APIエラー時のAPIError | E-05 L61-63 | ○ |
| C-40 | syncConfig未発見時のスキップ | E-05 L38-40 | ○ |
| C-41 | テスト環境でのスキップ | E-05 L33 | ○ |
| C-42 | logs=true時のログ出力 | E-05 L27-31 | ○ |

### deepen (utilities/deepen.ts) - UT-STR-043〜050
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-43 | ドット記法からネストオブジェクトへの変換 | E-06 L4-21 | ○ |
| C-44 | 複数階層の変換 | E-06 L9-17 | ○ |
| C-45 | ドットなしキーの保持 | E-06 L11-17 | ○ |
| C-46 | 複数キーの変換 | E-06 L7-18 | ○ |
| C-47 | 混在キーの処理 | E-06 L7-18 | ○ |
| C-48 | 空オブジェクト入力 | E-06 L5-7 | ○ |
| C-49 | null値の処理 | E-06 L12 | ○ |
| C-50 | undefined値の処理 | E-06 L12 | ○ |

### stripeProxy (utilities/stripeProxy.ts) - UT-STR-051〜059
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-51 | 有効なStripeメソッド呼び出し | E-07 L22-29 | ○ |
| C-52 | ネストメソッド呼び出し | E-07 L16-20 | ○ |
| C-53 | 複数引数の受け渡し | E-07 L25 | ○ |
| C-54 | stripeMethodの型チェック | E-07 L44-45 | ○ |
| C-55 | stripeMethod未指定エラー | E-07 L44-45 | ○ |
| C-56 | 存在しないメソッドエラー | E-07 L40-42 | ○ |
| C-57 | stripeArgs配列チェック | E-07 L36-37 | ○ |
| C-58 | Stripe APIエラー時の404返却 | E-07 L30-34 | ○ |
| C-59 | appInfo設定 | E-07 L9-12 | ○ |

### getFields (fields/getFields.ts) - UT-STR-060〜070
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-60 | stripeIDフィールド追加 | E-08 L14-23 | ○ |
| C-61 | stripeIDフィールドのサイドバー配置 | E-08 L17 | ○ |
| C-62 | stripeIDフィールドの読み取り専用 | E-08 L18 | ○ |
| C-63 | stripeIDフィールドのJWT保存 | E-08 L22 | ○ |
| C-64 | skipSyncフィールド追加 | E-08 L25-33 | ○ |
| C-65 | skipSyncフィールドのチェックボックスタイプ | E-08 L26 | ○ |
| C-66 | docUrlフィールド追加 | E-08 L35-49 | ○ |
| C-67 | docUrlフィールドのUIタイプ | E-08 L36 | ○ |
| C-68 | 既存フィールド保持 | E-08 L51 | ○ |
| C-69 | isTestKeyのcustom設定 | E-08 L43 | ○ |
| C-70 | stripeResourceTypeのcustom設定 | E-08 L45 | ○ |

### handleWebhooks (webhooks/index.ts) - UT-STR-071〜077
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-71 | createdイベントルーティング | E-09 L24-30 | ○ |
| C-72 | updatedイベントルーティング | E-09 L42-48 | ○ |
| C-73 | deletedイベントルーティング | E-09 L33-39 | ○ |
| C-74 | syncConfig未設定リソースの無視 | E-09 L18-22 | ○ |
| C-75 | 不明メソッドの無視 | E-09 L51-53 | ○ |
| C-76 | logs=true時のログ出力 | E-09 L9-11 | ○ |
| C-77 | productリソースタイプの処理 | E-09 L18-19 | ○ |

### handleCreatedOrUpdated (webhooks/handleCreatedOrUpdated.ts) - UT-STR-078〜088
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-78 | 新規ドキュメント作成 | E-10 L156-186 | ○ |
| C-79 | 既存ドキュメント更新 | E-10 L188-212 | ○ |
| C-80 | authコレクションemail重複時の更新 | E-10 L95-139 | ○ |
| C-81 | authコレクションでのパスワード生成 | E-10 L164 | ○ |
| C-82 | authコレクションでの検証メール無効化 | E-10 L173 | ○ |
| C-83 | ネストフィールド変更のスキップ | E-10 L33-39 | ○ |
| C-84 | authコレクションemail未設定のログ | E-10 L140-145 | ○ |
| C-85 | skipSync=true設定 | E-10 L79-83 | ○ |
| C-86 | フィールドマッピングの適用 | E-10 L69-77 | ○ |
| C-87 | payload.create失敗時のログ | E-10 L181-185 | ○ |
| C-88 | payload.update失敗時のログ | E-10 L207-211 | ○ |

### handleDeleted (webhooks/handleDeleted.ts) - UT-STR-089〜094
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-89 | Payloadドキュメント削除 | E-11 L67-79 | ○ |
| C-90 | 既存ドキュメントなし時のログ | E-11 L54-59 | ○ |
| C-91 | ネストフィールド削除のスキップ | E-11 L25-31 | ○ |
| C-92 | payload.find失敗時のログ | E-11 L88-91 | ○ |
| C-93 | payload.delete失敗時のログ | E-11 L81-85 | ○ |
| C-94 | logs=true時のログ出力 | E-11 L26-29 | ○ |

### stripeWebhooks (routes/webhooks.ts) - UT-STR-095〜102
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-95 | 有効なWebhookイベント処理 | E-12 L43-51 | ○ |
| C-96 | 無効署名時の400返却 | E-12 L37-41 | ○ |
| C-97 | カスタムwebhookハンドラ(関数)呼び出し | E-12 L54-62 | ○ |
| C-98 | カスタムwebhookハンドラ(オブジェクト)呼び出し | E-12 L65-76 | ○ |
| C-99 | イベントタイプに対応しないハンドラのスキップ | E-12 L66-67 | ○ |
| C-100 | endpointSecret未設定時の200返却 | E-12 L19 | ○ |
| C-101 | signature未設定時のスキップ | E-12 L32 | ○ |
| C-102 | constructEvent失敗時のログ | E-12 L38-40 | ○ |

### stripeREST (routes/rest.ts) - UT-STR-103〜107
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-103 | 認証ユーザーのStripe API呼び出し | E-13 L31-38 | ○ |
| C-104 | 未認証ユーザーのForbiddenエラー | E-13 L26-28 | ○ |
| C-105 | stripeProxyエラー時の500返却 | E-13 L39-47 | ○ |
| C-106 | stripeProxyのstatus反映 | E-13 L37-38 | ○ |
| C-107 | addDataAndFileToRequest呼び出し | E-13 L18 | ○ |

### stripePlugin (admin.ts) - UT-STR-108〜111
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-108 | クライアント側フィールド追加 | E-14 L29-38 | ○ |
| C-109 | restのデフォルト値がtrue（admin版） | E-14 L16 | ○ |
| C-110 | syncConfig未設定時のスキップ | E-14 L27-41 | ○ |
| C-111 | configのスプレッド保持 | E-14 L24-42 | ○ |

### LinkToDoc (ui/LinkToDoc.tsx) - UT-STR-112〜118
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-112 | stripeID存在時のリンク表示 | E-15 L19-46 | ○ |
| C-113 | テストキー時のURL | E-15 L16-17 | ○ |
| C-114 | 本番キー時のURL | E-15 L16-17 | ○ |
| C-115 | stripeID未設定時のnull返却 | E-15 L48 | ○ |
| C-116 | stripeResourceTypeのURL反映 | E-15 L17 | ○ |
| C-117 | CopyToClipboardコンポーネント表示 | E-15 L31 | ○ |
| C-118 | target='_blank'設定 | E-15 L40 | ○ |

## 4) 不足情報（Unknown / Missing）
- 特になし
  - 全てのテストケースはソースコードに基づいて作成されています

## 5) リスクフラグ（レビュー観点）
- **0: 低リスク** - 全てのテストケースがソースコードから導出されています
- **注意点**：
  - Stripe APIのモック戦略は実装時に検討が必要
  - 認証テスト（Forbidden）はPayloadのテスト環境セットアップに依存
  - NODE_ENV='test'の挙動はコード内で明示的に定義されている
  - handleCreatedOrUpdatedとhandleDeletedはvoid関数として呼び出されるため、非同期テストの方法を検討する必要あり

## 6) レビュアーチェックリスト（最小）
- [ ] テストケースの優先度が適切か（高/中/低）
- [ ] 正常系・異常系・境界値の観点が網羅されているか
- [ ] Stripe APIモック戦略が決定されているか
- [ ] テスト環境でのNODE_ENV設定が考慮されているか
- [ ] 認証テストのモック方法が決定されているか
- [ ] deepen関数のエッジケース（深いネスト、特殊文字）が必要か検討
- [ ] Webhookハンドラの非同期実行（void）のテスト方法が決定されているか
- [ ] UIコンポーネント（LinkToDoc）のReactテスト環境が整備されているか
