---
generated_at: 2026-01-28 12:15:00
metrics:
  claims_total: 80
  claims_with_evidence: 78
  claims_without_evidence: 2
confidence_derived: 0.98
---

# 根拠レポート：compare モジュール単体テストケース一覧

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.98**
  - 根拠あり：78 / 80、根拠なし：2
- 優先レビュー（高）
  1. **UT-CMP-025**：APIエラー時の例外処理（try-catchの挙動詳細が実装依存）
  2. **UT-CMP-031**：APIエラー時のnull返却（ApiClientの実装に依存）

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

- E-01: `lib/screens/compare/data_model/compare_product_model.dart` - CompareProductsData, CompareProductsクラス定義
- E-02: `lib/screens/compare/bloc/compare_screen_bloc.dart` - CompareScreenBlocクラス、mapEventToStateメソッド
- E-03: `lib/screens/compare/bloc/compare_screen_state.dart` - 各種State定義（AddToCartCompareState等）
- E-04: `lib/screens/compare/bloc/compare_screen_event.dart` - 各種Event定義（AddToCartCompareEvent等）
- E-05: `lib/screens/compare/bloc/compare_screen_repository.dart` - CompareScreenRepository抽象クラス、CompareScreenRepositoryImp実装
- E-06: `lib/screens/compare/view/compare_screen.dart` - CompareScreen StatefulWidget、_CompareScreenStateクラス
- E-07: `lib/screens/compare/view/widget/compare_view.dart` - CompareView StatelessWidget
- E-08: `lib/screens/compare/view/widget/compare_list.dart` - CompareList StatelessWidget
- E-09: `lib/screens/compare/view/widget/compare_loader_view.dart` - CompareLoaderView StatelessWidget
- E-10: `lib/screens/compare/utils/index.dart` - モジュールエクスポート定義

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | CompareProductsData.fromJsonで正しくデシリアライズされる | E-01 (L24-25) | ○ |
| C-02 | CompareProductsData.fromJsonが空JSONでもエラーなく処理される | E-01 (L20, nullable data) | ○ |
| C-03 | CompareProductsData.toJsonで正しくシリアライズされる | E-01 (L27-28) | ○ |
| C-04 | CompareProducts.fromJsonで正しくデシリアライズされる | E-01 (L43-44) | ○ |
| C-05 | CompareProducts.fromJsonがnullフィールドを許容する | E-01 (L33-35, nullable fields) | ○ |
| C-06 | CompareProducts.toJsonで正しくシリアライズされる | E-01 (L46) | ○ |
| C-07 | CompareScreenFetchEventで比較リストが取得される | E-02 (L27-62) | ○ |
| C-08 | CompareScreenFetchEventでAPI失敗時にエラー状態が発行される | E-02 (L56-59) | ○ |
| C-09 | isLoadingがtrueの場合に重複リクエストが防止される | E-02 (L28) | ○ |
| C-10 | hasMoreがfalseの場合に追加リクエストが防止される | E-02 (L28) | ○ |
| C-11 | RemoveFromCompareListEventで商品が削除される | E-02 (L63-79) | ○ |
| C-12 | RemoveFromCompareListEventでAPI失敗時にエラー状態が発行される | E-02 (L74, L77-78) | ○ |
| C-13 | AddToCartCompareEventでカートに追加される | E-02 (L80-96) | ○ |
| C-14 | AddToCartCompareEventでAPI失敗時にエラー状態が発行される | E-02 (L90-95) | ○ |
| C-15 | AddToWishlistCompareEventでウィッシュリストに追加される | E-02 (L97-113) | ○ |
| C-16 | AddToWishlistCompareEventでAPI失敗時にエラー状態が発行される | E-02 (L110-112) | ○ |
| C-17 | FetchDeleteWishlistItemEventでウィッシュリストから削除される | E-02 (L114-138) | ○ |
| C-18 | FetchDeleteWishlistItemEventでAPI失敗時にエラー状態が発行される | E-02 (L135-137) | ○ |
| C-19 | OnClickCompareLoaderEventでローダー状態が更新される | E-02 (L139-141) | ○ |
| C-20 | RemoveAllCompareListEventで全商品が削除される | E-02 (L142-156) | ○ |
| C-21 | RemoveAllCompareListEventでAPI失敗時にエラー状態が発行される | E-02 (L149-154) | ○ |
| C-22 | ページネーションで追加データが既存リストに追加される | E-02 (L38-42) | ○ |
| C-23 | 取得件数がlimit未満の場合hasMoreがfalseになる | E-02 (L44-45) | ○ |
| C-24 | callCompareApiで比較商品リストが取得される | E-05 (L24-33) | ○ |
| C-25 | callCompareApiでAPIエラー時に例外がスローされる | E-05 (L28-32) | △ |
| C-26 | removeFromCompareListで商品が削除される | E-05 (L36-41) | ○ |
| C-27 | removeFromCompareListで無効な商品IDでエラーが返却される | E-05 (L38, BaseModel返却) | ○ |
| C-28 | callAddToCartAPiで商品がカートに追加される | E-05 (L44-49) | ○ |
| C-29 | callAddToCartAPiで無効な商品IDでエラーが返却される | E-05 (L46-47, AddToCartModel返却) | ○ |
| C-30 | callWishListAddDeleteItemでウィッシュリストに追加される | E-05 (L55-66) | ○ |
| C-31 | callWishListAddDeleteItemでAPIエラー時にnullが返却される | E-05 (L58-64) | △ |
| C-32 | removeItemFromWishlistで商品が削除される | E-05 (L68-78) | ○ |
| C-33 | removeAllCompareProductsで全商品が削除される | E-05 (L81-87) | ○ |
| C-34 | initStateでカート数が取得される | E-06 (L35-37) | ○ |
| C-35 | initStateでCompareScreenFetchEventが発行される | E-06 (L38-39) | ○ |
| C-36 | スクロール終端でCompareScreenFetchEventが発行される | E-06 (L42-47) | ○ |
| C-37 | disposeでリソースが解放される | E-06 (L50-55) | ○ |
| C-38 | CompareScreenInitialStateでローダーが表示される | E-06 (L206-208) | ○ |
| C-39 | CompareScreenFetchDataState.successでデータが表示される | E-06 (L209-218) | ○ |
| C-40 | CompareScreenFetchDataState.failでエラーメッセージが表示される | E-06 (L220-222) | ○ |
| C-41 | compareScreenModelがnullの場合にローダーが表示される | E-06 (L272-287) | ○ |
| C-42 | data配列が空の場合にEmptyDataViewが表示される | E-06 (L288-291) | ○ |
| C-43 | RemoveFromCompareState.successで成功通知が表示される | E-06 (L136-141) | ○ |
| C-44 | RemoveFromCompareState.failでエラー通知が表示される | E-06 (L133-135) | ○ |
| C-45 | CompareViewで比較リストが正しく表示される | E-07 (L26-198) | ○ |
| C-46 | 商品タップで商品詳細画面に遷移する | E-07 (L72-82, L143-153) | ○ |
| C-47 | 商品画像がない場合でもエラーなく表示される | E-08 (L71-85) | ○ |
| C-48 | SKUが正しく表示される | E-07 (L100-104) | ○ |
| C-49 | 商品説明がHTMLとして正しくレンダリングされる | E-07 (L175-184) | ○ |
| C-50 | 商品リストが横スクロールで表示される | E-08 (L28-33) | ○ |
| C-51 | 商品画像が正しく表示される | E-08 (L74-85) | ○ |
| C-52 | 削除ボタンタップでRemoveFromCompareListEventが発行される | E-08 (L90-97) | ○ |
| C-53 | 価格がPriceWidgetHtmlで表示される | E-08 (L133-136) | ○ |
| C-54 | ウィッシュリスト追加アイコンタップでAddToWishlistCompareEventが発行される | E-08 (L151-159) | ○ |
| C-55 | ウィッシュリスト削除アイコンタップでFetchDeleteWishlistItemEventが発行される | E-08 (L142-150) | ○ |
| C-56 | カート追加ボタンタップでAddToCartCompareEventが発行される（simple/virtual商品） | E-08 (L246-263) | ○ |
| C-57 | カスタマイズ可能商品の場合に商品詳細画面に遷移する | E-08 (L264-284) | ○ |
| C-58 | isSaleableがfalseの場合にカート追加ボタンが半透明になる | E-08 (L229-234) | ○ |
| C-59 | 評価が存在する場合に評価バッジが表示される | E-08 (L193-228) | ○ |
| C-60 | 評価がnullの場合に評価バッジが表示されない | E-08 (L193-194, L228) | ○ |
| C-61 | CompareLoaderViewでスケルトンローダーが表示される | E-09 (L23-49, L70-97, L120-147) | ○ |
| C-62 | CompareLoaderViewでSKUとDescription見出しが表示される | E-09 (L61, L111) | ○ |
| C-63 | AddToCartCompareState.success factoryで成功状態が生成される | E-03 (L26) | ○ |
| C-64 | AddToCartCompareState.fail factoryで失敗状態が生成される | E-03 (L27) | ○ |
| C-65 | AddToWishlistCompareState.success factoryで成功状態が生成される | E-03 (L38) | ○ |
| C-66 | RemoveFromWishlistState.success factoryで成功状態が生成される | E-03 (L50) | ○ |
| C-67 | RemoveFromCompareState.success factoryで成功状態が生成される | E-03 (L62) | ○ |
| C-68 | RemoveAllCompareProductState.success factoryで成功状態が生成される | E-03 (L72) | ○ |
| C-69 | CompareScreenFetchDataState.success factoryで成功状態が生成される | E-03 (L83) | ○ |
| C-70 | OnClickCompareLoaderStateコンストラクタでローダー状態が生成される | E-03 (L92-96) | ○ |
| C-71 | OnClickCompareLoaderEventコンストラクタでイベントが生成される | E-04 (L17-19) | ○ |
| C-72 | AddToCartCompareEventコンストラクタでイベントが生成される | E-04 (L22-26) | ○ |
| C-73 | AddToWishlistCompareEventコンストラクタでイベントが生成される | E-04 (L29-32) | ○ |
| C-74 | FetchDeleteWishlistItemEventコンストラクタでイベントが生成される | E-04 (L35-38) | ○ |
| C-75 | RemoveFromCompareListEventコンストラクタでイベントが生成される | E-04 (L41-45) | ○ |
| C-76 | RemoveAllCompareListEventコンストラクタでイベントが生成される | E-04 (L48-51) | ○ |
| C-77 | CompareScreenFetchEventコンストラクタでイベントが生成される | E-04 (L54-56) | ○ |
| C-78 | AddToWishlistCompareEventでisInWishlistがtrueからfalseに切り替わる | E-02 (L101-104) | ○ |
| C-79 | AddToWishlistCompareEventでisInWishlistがfalseからtrueに切り替わる | E-02 (L101-104) | ○ |
| C-80 | FetchDeleteWishlistItemEventでisInWishlistがトグルされる | E-02 (L119-127) | ○ |

## 4) 不足情報（Unknown / Missing）
- **UT-CMP-025 (callCompareApi例外処理)**：try-catchでエラーをキャッチしているが、例外をスローせずにdebugPrintのみで処理している可能性がある。compareScreenModel!のnullチェックでクラッシュする可能性を確認が必要。
  - 候補：ApiClient実装 / エラーハンドリング仕様書 / 単体テスト既存コード
- **UT-CMP-031 (callWishListAddDeleteItem null返却)**：catch節でnullを返却する可能性があるが、呼び出し元での null チェックが必要かどうかは ApiClient の実装に依存する。
  - 候補：ApiClient実装 / ウィッシュリストAPI仕様書

## 5) リスクフラグ（レビュー観点）
- **0 (低リスク)**: データモデルのシリアライズ/デシリアライズ（UT-CMP-001〜006）
- **0 (低リスク)**: UI表示系のテストケース（UT-CMP-045〜062）
- **1 (中リスク)**: Bloc状態管理のテストケース（UT-CMP-007〜023）- 状態遷移の網羅性を確認
- **2 (高リスク)**: API呼び出しのエラーハンドリング（UT-CMP-024〜033）- 例外処理の実装詳細を確認

## 6) レビュアーチェックリスト（最小）
- [ ] データモデル（CompareProductsData, CompareProducts）のfromJson/toJsonがnull安全に実装されているか
- [ ] CompareScreenBlocの各イベントハンドラが正しい状態遷移を行うか
- [ ] RepositoryのAPIエラーハンドリングがBlocで適切に処理されるか
- [ ] UI Widgetのnull安全性（product?.name等）が適切か
- [ ] ページネーション（isLoading, hasMore, page）の制御が正しいか
- [ ] ウィッシュリスト状態のトグル処理が正しいか
- [ ] カート追加時の商品タイプ判定（simple/virtual vs configurable）が正しいか
