---
generated_at: 2026-01-30 15:30:00
metrics:
  claims_total: 28
  claims_with_evidence: 26
  claims_without_evidence: 2
confidence_derived: 0.93
---

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

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.93**
  - 根拠あり：26 / 28、根拠なし：2
- 優先レビュー（高）
  1. **カバレッジ目標値**：明示的な目標値の設定がコード・設定から確認できない
  2. **性能テストの実施タイミング**：具体的なCI/CD設定での定義が確認できない

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

- E-01: `/package.json` - ルートpackage.json（テストスクリプト、依存関係定義）
- E-02: `/packages/loot-core/package.json` - loot-coreパッケージ設定
- E-03: `/packages/desktop-client/package.json` - desktop-clientパッケージ設定
- E-04: `/packages/sync-server/package.json` - sync-serverパッケージ設定
- E-05: `/.github/workflows/check.yml` - CIテストワークフロー
- E-06: `/.github/workflows/e2e-test.yml` - E2E/VRTテストワークフロー
- E-07: `/.github/workflows/build.yml` - ビルドワークフロー
- E-08: `/.github/workflows/codeql.yml` - セキュリティ解析ワークフロー
- E-09: `/vitest.config.ts` - ルートVitest設定
- E-10: `/packages/loot-core/vitest.config.ts` - loot-core Vitest設定
- E-11: `/packages/desktop-client/playwright.config.ts` - Playwright設定
- E-12: `/packages/loot-core/src/server/tests/` - テストディレクトリ（mockSyncServer.ts, mockData.json）
- E-13: `/packages/desktop-client/e2e/fixtures.ts` - E2Eフィクスチャ
- E-14: `/packages/sync-server/src/app-gocardless/services/tests/fixtures.js` - GoCardlessテストフィクスチャ
- E-15: `*.test.ts`, `*.test.tsx`, `*.spec.js` ファイル群 - テストファイル命名パターン

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | Vitestを単体テストフレームワークとして使用 | E-01, E-02, E-03, E-04 | ○ |
| C-02 | Vitestバージョンは^4.0.16 | E-02, E-03 | ○ |
| C-03 | Playwrightを E2Eテストフレームワークとして使用 | E-03, E-06, E-11 | ○ |
| C-04 | Playwrightバージョンは1.57.0 | E-03, E-06 | ○ |
| C-05 | E2Eテストは5シャードで並列実行 | E-06 | ○ |
| C-06 | VRTテストは5シャードで並列実行 | E-06 | ○ |
| C-07 | Testing Library（react 16.3.0）を使用 | E-03 | ○ |
| C-08 | Supertestを使用（^7.2.2） | E-04 | ○ |
| C-09 | fast-check（4.5.3）を使用 | E-02 | ○ |
| C-10 | CodeQLによるセキュリティ解析を実施 | E-08 | ○ |
| C-11 | CodeQLは週次（土曜11:23 UTC）でスケジュール実行 | E-08 | ○ |
| C-12 | CI環境はUbuntu Latest使用 | E-05, E-06, E-07 | ○ |
| C-13 | Node.js 22以上が必須 | E-01, E-05 | ○ |
| C-14 | Yarn 4.9.1以上が必須 | E-01 | ○ |
| C-15 | lageによるテスト並列実行 | E-01, E-09 | ○ |
| C-16 | mockSyncServer.tsでモックサーバーを提供 | E-12 | ○ |
| C-17 | mockData.jsonで共通モックデータを定義 | E-12 | ○ |
| C-18 | E2Eフィクスチャがfixtures.tsに定義 | E-13 | ○ |
| C-19 | PR作成時にlint・typecheck・テスト実行 | E-05 | ○ |
| C-20 | concurrency設定でワークフロー重複実行をキャンセル | E-05, E-06, E-07 | ○ |
| C-21 | Playwright Docker（v1.57.0-jammy）を使用 | E-06 | ○ |
| C-22 | VRTレポートは30日間保持 | E-06 | ○ |
| C-23 | xvfbでDesktopアプリテストを実行 | E-06 | ○ |
| C-24 | oxlintをリンターとして使用（^1.41.0） | E-01 | ○ |
| C-25 | テストファイル命名規則は*.test.ts, *.spec.js等 | E-15 | ○ |
| C-26 | モバイルテストは*.mobile.test.tsパターン | E-15 | ○ |
| C-27 | カバレッジ目標値は明示的に設定されていない | **根拠なし** | △ |
| C-28 | 性能テストは必要に応じて手動実施 | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）
- **カバレッジ目標値**: プロジェクト設定（vitest.config、CI設定）を確認したが、明示的なカバレッジ閾値の設定が見つからなかった。チームの内部ドキュメントや口頭での合意がある可能性がある。
  - 候補：チーム内wiki / コントリビューションガイド / プロジェクトREADME
- **性能テスト方針**: 性能テストに関する専用のCI/CDワークフローや設定ファイルが確認できなかった。必要に応じて手動実施という推測は、明示的な根拠がない。
  - 候補：チーム内wiki / パフォーマンス計測スクリプト / ベンチマークツール設定

## 5) リスクフラグ（レビュー観点）
- **リスク 1（低リスク）**: カバレッジ目標値が未設定の場合、品質基準が曖昧になる可能性。ただし、E2E・VRT・単体テストは充実しており、実質的な品質担保は行われている。
- **リスク 0（低リスク）**: 性能テストが定義されていないが、ローカルファーストアプリケーションの特性上、サーバー側の性能要件は限定的。

## 6) レビュアーチェックリスト（最小）
- [ ] カバレッジ目標値についてチームの合意事項を確認し、必要に応じてテスト方針書に反映する
- [ ] 性能テストの必要性と実施方針についてチームで合意し、必要に応じて追記する
- [ ] 各テストツールのバージョンが最新の package.json と一致しているか確認する
- [ ] CI/CDワークフローの設定変更があった場合、テスト方針書との整合性を確認する
- [ ] 新しいパッケージ追加時にテスト方針書の適用範囲を見直す
