---
generated_at: 2026-01-29 15:45:00
metrics:
  claims_total: 25
  claims_with_evidence: 23
  claims_without_evidence: 2
confidence_derived: 0.92
---

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

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.92**
  - 根拠あり：23 / 25、根拠なし：2
- 優先レビュー（高）
  1. **テストレベルの担当者定義**：組織体制の根拠なし
  2. **不具合管理プロセス詳細**：外部ドキュメント参照のため検証困難

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

- E-01: `composer.json` - PHPの依存パッケージ・スクリプト定義
- E-02: `src/Administration/Resources/app/administration/jest.config.js` - Administration Jestテスト設定
- E-03: `src/Storefront/Resources/app/storefront/jest.config.js` - Storefront Jestテスト設定
- E-04: `src/Administration/Resources/app/administration/package.json` - Admin npm依存パッケージ
- E-05: `src/Storefront/Resources/app/storefront/package.json` - Storefront npm依存パッケージ
- E-06: `phpstan.neon.dist` - PHPStan静的解析設定
- E-07: `src/Core/Framework/Resources/config/packages/e2e/e2e.yaml` - E2Eテスト環境設定
- E-08: `compose.yaml` - Docker Compose設定
- E-09: `src/Storefront/Resources/app/storefront/test/` - Storefrontテストディレクトリ構成
- E-10: `src/Storefront/Resources/app/administration/src/**/*.spec.js` - Storefront Admin拡張テストファイル

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | PHPUnit 11.5.19を使用 | E-01 (require-dev: phpunit ^11.5.19) | ○ |
| C-02 | PHPStan 2.1.31を使用 | E-01 (require-dev: phpstan 2.1.31) | ○ |
| C-03 | PHP-CS-Fixer 3.91.2を使用 | E-01 (require-dev: friendsofphp/php-cs-fixer 3.91.2) | ○ |
| C-04 | phpbench ^1.2.15を使用 | E-01 (require-dev: phpbench/phpbench ^1.2.15) | ○ |
| C-05 | Jest 29.7.0を使用 | E-04, E-05 (devDependencies: jest 29.7.0) | ○ |
| C-06 | @shopware-ag/jest-preset-sw6-admin 6.0.4を使用 | E-04 (devDependencies) | ○ |
| C-07 | @vue/test-utils 2.4.6を使用 | E-04 (dependencies) | ○ |
| C-08 | Storefrontカバレッジ閾値85% | E-03 (coverageThreshold: statements/branches/functions 85) | ○ |
| C-09 | テスト成果物は build/artifacts/jest/ に出力 | E-02, E-03 (coverageDirectory, outputDirectory設定) | ○ |
| C-10 | JUnit形式でレポート出力 | E-02, E-03 (jest-junitレポーター設定) | ○ |
| C-11 | CI実行時はサイレントレポーター使用 | E-02 (isCi判定によるレポーター切り替え) | ○ |
| C-12 | タイムゾーンはUTCに統一 | E-02 (process.env.TZ = 'UTC') | ○ |
| C-13 | E2E環境でレートリミッター無効化 | E-07 (rate_limiter各項目enabled: false) | ○ |
| C-14 | E2E環境でMessengerは同期モード | E-07 (messenger.transports.async.dsn: sync://) | ○ |
| C-15 | PHP 8.2-8.5対応 | E-01 (require: php ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0) | ○ |
| C-16 | Node.js 20+対応 | E-04 (engines: node ^20.0.0以降) | ○ |
| C-17 | composer admin:unitでAdminテスト実行 | E-01 (scripts: admin:unit) | ○ |
| C-18 | composer storefront:unitでStorefrontテスト実行 | E-01 (scripts: storefront:unit) | ○ |
| C-19 | composer bc-checkで後方互換性チェック | E-01 (scripts: bc-check) | ○ |
| C-20 | composer lintで全Lint一括実行 | E-01 (scripts: lint) | ○ |
| C-21 | プリコミットフックのインストールコマンド | E-01 (scripts: hook:pre-commit:install) | ○ |
| C-22 | Storefrontテストは106ファイル存在 | E-09 (findコマンドによる実測) | ○ |
| C-23 | 単体テストの担当者は開発者 | **根拠なし** | △ |
| C-24 | 不具合管理はGitHub Issues使用 | E-01 (support.issues: github.com/shopware/shopware/issues) | ○ |
| C-25 | 不具合分類の定義（Critical/High/Medium/Low） | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）
- **C-23: テスト担当者の定義** - 組織体制・プロセスに関する明示的なドキュメントがリポジトリ内に存在しない
  - 候補：CONTRIBUTING.md / 外部ドキュメント / チーム規約
- **C-25: 不具合分類の定義** - 一般的なソフトウェア開発慣行に基づく記述であり、プロジェクト固有の定義ドキュメントなし
  - 候補：GitHub Issue Templates / 外部プロジェクト管理ツール

## 5) リスクフラグ（レビュー観点）
- **0: 低リスク** - テストツール・バージョン情報（E-01, E-04, E-05から直接確認可能）
- **0: 低リスク** - テスト実行コマンド（composer.jsonのscriptsから確認可能）
- **0: 低リスク** - カバレッジ設定（jest.config.jsから確認可能）
- **1: 中リスク** - テスト担当者の定義（組織体制依存、要確認）
- **1: 中リスク** - 不具合分類の定義（プロジェクト固有の運用規約要確認）

## 6) レビュアーチェックリスト（最小）
- [ ] composer.jsonのテスト関連依存パッケージバージョンが最新か確認
- [ ] jest.config.jsのカバレッジ閾値がプロジェクト方針と一致しているか確認
- [ ] テスト担当者の役割分担が現在の組織体制と一致しているか確認
- [ ] 不具合分類の定義がチームで合意されているか確認
- [ ] CI/CDパイプライン（GitHub Actions等）との整合性を確認
- [ ] testsディレクトリの実際の構成と記載内容の整合性を確認
