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

# 根拠レポート：テスト方針書

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.94**
  - 根拠あり：30 / 32、根拠なし：2
- 優先レビュー（高）
  1. **行カバレッジ・分岐カバレッジの目標値**：明示的な設定ファイルなし
  2. **テストデータのファクトリ関数の網羅性**：全モジュールでの確認未完了

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

- E-01: `/Users/tomoka.baba/Work/medusa-develop/package.json` - パッケージバージョン、スクリプト定義
- E-02: `/Users/tomoka.baba/Work/medusa-develop/jest.config.js` - Jestルート設定
- E-03: `/Users/tomoka.baba/Work/medusa-develop/.github/workflows/action.yml` - メインCIパイプライン
- E-04: `/Users/tomoka.baba/Work/medusa-develop/.github/workflows/test-cli-with-database.yml` - CLIテストパイプライン
- E-05: `/Users/tomoka.baba/Work/medusa-develop/.github/workflows/docs-test.yml` - ドキュメントテストパイプライン
- E-06: `/Users/tomoka.baba/Work/medusa-develop/packages/medusa-test-utils/src/medusa-test-runner.ts` - 統合テストランナー
- E-07: `/Users/tomoka.baba/Work/medusa-develop/packages/medusa-test-utils/src/module-test-runner.ts` - モジュールテストランナー
- E-08: `/Users/tomoka.baba/Work/medusa-develop/packages/medusa-test-utils/src/database.ts` - テストDB管理ユーティリティ
- E-09: `/Users/tomoka.baba/Work/medusa-develop/integration-tests/http/jest.config.js` - HTTP統合テスト設定
- E-10: `/Users/tomoka.baba/Work/medusa-develop/integration-tests/modules/jest.config.js` - モジュール統合テスト設定
- E-11: `/Users/tomoka.baba/Work/medusa-develop/packages/modules/order/jest.config.js` - モジュール単位のJest設定例
- E-12: `/Users/tomoka.baba/Work/medusa-develop/packages/admin/admin-vite-plugin/vitest.config.ts` - Vitest設定
- E-13: `/Users/tomoka.baba/Work/medusa-develop/packages/modules/product/integration-tests/__tests__/product.spec.ts` - 統合テスト実装例
- E-14: `/Users/tomoka.baba/Work/medusa-develop/packages/core/utils/src/common/__tests__/is-email.spec.ts` - 単体テスト実装例
- E-15: `/Users/tomoka.baba/Work/medusa-develop/CLAUDE.md` - プロジェクト構成・コマンド説明

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | テストフレームワークとしてJest 29.7.0を使用 | E-01 (`"jest": "^29.7.0"`) | ○ |
| C-02 | フロントエンドテストにVitest 3.0.5を使用 | E-01 (`"vitest": "^3.0.5"`) | ○ |
| C-03 | パッケージマネージャーはYarn 3.2.1 | E-01 (`"packageManager": "yarn@3.2.1"`) | ○ |
| C-04 | 単体テストは`yarn test`で実行 | E-01, E-15 | ○ |
| C-05 | 統合テストは`yarn test:integration:*`で実行 | E-01, E-15 | ○ |
| C-06 | CIパイプラインはGitHub Actionsで実行 | E-03, E-04, E-05 | ○ |
| C-07 | 単体テストは4シャードで並列実行 | E-03 (`matrix: shard_index: [1, 2, 3, 4]`) | ○ |
| C-08 | パッケージ統合テストはfast/slowグループに分割 | E-01, E-03 (`group: ["slow", "fast"]`) | ○ |
| C-09 | HTTP統合テストは4シャードで並列実行 | E-03 (`shard_index: [1, 2, 3, 4]`) | ○ |
| C-10 | モジュール統合テストは4シャードで並列実行 | E-03 (`shard_index: [1, 2, 3, 4]`) | ○ |
| C-11 | CI環境でPostgreSQLをDockerサービスとして使用 | E-03 (`services: postgres:`) | ○ |
| C-12 | CI環境でRedisをDockerサービスとして使用 | E-03 (`services: redis:`) | ○ |
| C-13 | Node.js 20を使用 | E-03 (`node-version: 20`) | ○ |
| C-14 | テストDBは動的に作成・削除 | E-08 (`createDatabase`, `dropDatabase`) | ○ |
| C-15 | MedusaIntegrationTestRunnerでフルスタックテスト | E-06 | ○ |
| C-16 | ModuleIntegrationTestRunnerでモジュールテスト | E-07 | ○ |
| C-17 | テスト間でDBをトランケート | E-08 (`teardown` function) | ○ |
| C-18 | @swc/jest 0.2.36をトランスパイラとして使用 | E-01 (`"@swc/jest": "^0.2.36"`) | ○ |
| C-19 | supertest 7.1.4をHTTPテストに使用 | E-01 (`"supertest": "^7.1.4"`) | ○ |
| C-20 | @faker-js/faker 9.2.0をテストデータ生成に使用 | E-01 (`"@faker-js/faker": "^9.2.0"`) | ○ |
| C-21 | pg-god 1.0.12をテストDB管理に使用 | E-01 (`"pg-god": "^1.0.12"`) | ○ |
| C-22 | msw 2.3.0をAPIモックに使用 | E-01 (`"msw": "^2.3.0"`) | ○ |
| C-23 | テストファイルは`*.spec.ts`または`*.test.ts` | E-02, E-14 | ○ |
| C-24 | テストディレクトリは`__tests__/` | E-02, E-14 | ○ |
| C-25 | Turboによるビルドキャッシュ活用 | E-01 (`"turbo": "^1.6.3"`), E-03 | ○ |
| C-26 | 統合テストのタイムアウトは300,000ms | E-13 (`jest.setTimeout(300000)`) | ○ |
| C-27 | ドキュメントテストはVale Linterを使用 | E-05 (`vale-action@reviewdog`) | ○ |
| C-28 | CLIテストでプロジェクト作成を検証 | E-04 (`medusa new cli-test`) | ○ |
| C-29 | NODE_OPTIONS=--max_old_space_size=4096を設定 | E-03 | ○ |
| C-30 | Linear連携でIssue自動作成 | E-03 workflow files存在確認 | ○ |
| C-31 | 行カバレッジの具体的目標値 | **根拠なし** | △ |
| C-32 | 分岐カバレッジの具体的目標値 | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）
- **カバレッジ目標値**: プロジェクト内に明示的なカバレッジ目標を定義するファイル（例: `.coveragerc`, `codecov.yml`等）が見つかりませんでした。`jest.config.js`にはカバレッジ収集の設定がありますが、具体的な閾値は設定されていません。
  - 候補：プロジェクトのCONTRIBUTING.md / CI設定でのカバレッジゲート / チーム内の暗黙的な基準

## 5) リスクフラグ（レビュー観点）
- **0（低リスク）**: テストツール・バージョン情報
- **0（低リスク）**: CI/CDパイプライン構成
- **0（低リスク）**: テストランナーの動作仕様
- **1（中リスク）**: カバレッジ目標値が明示されていないため、品質基準が曖昧
- **0（低リスク）**: テストデータ準備方針

## 6) レビュアーチェックリスト（最小）
- [ ] テストレベルの定義が組織のQA方針と一致しているか確認
- [ ] カバレッジ目標値について、チーム/プロジェクトの方針を確認し、必要に応じて追記
- [ ] テスト環境の構成がプロダクション環境と適切に分離されているか確認
- [ ] CI/CDパイプラインの実行時間が許容範囲内か確認
- [ ] テストデータのファクトリ関数が全モジュールで一貫して使用されているか確認
