---
generated_at: 2026-01-29 18:05:00
metrics:
  claims_total: 141
  claims_with_evidence: 141
  claims_without_evidence: 0
confidence_derived: 1.00
---

# 根拠レポート: Core-System-Snippet 単体テストケース一覧

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）: **1.00**
  - 根拠あり: 141 / 141、根拠なし: 0
- 優先レビュー（高）
  1. **SnippetService::getStorefrontSnippets**: フォールバック処理とマージ順序の複雑なロジック
  2. **SnippetValidator::getValidation**: 複数形バリデーションの正規表現パターン
  3. **CustomFieldSubscriber**: イベント連動でのスニペット自動生成・削除

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

- E-01: `src/Core/System/Snippet/SnippetEntity.php`
- E-02: `src/Core/System/Snippet/SnippetDefinition.php`
- E-03: `src/Core/System/Snippet/SnippetCollection.php`
- E-04: `src/Core/System/Snippet/Aggregate/SnippetSet/SnippetSetEntity.php`
- E-05: `src/Core/System/Snippet/Aggregate/SnippetSet/SnippetSetDefinition.php`
- E-06: `src/Core/System/Snippet/Aggregate/SnippetSet/SnippetSetCollection.php`
- E-07: `src/Core/System/Snippet/SnippetService.php`
- E-08: `src/Core/System/Snippet/SnippetValidator.php`
- E-09: `src/Core/System/Snippet/SnippetFixer.php`
- E-10: `src/Core/System/Snippet/SnippetException.php`
- E-11: `src/Core/System/Snippet/SnippetFileHandler.php`
- E-12: `src/Core/System/Snippet/SnippetPatterns.php`
- E-13: `src/Core/System/Snippet/Filter/SnippetFilterFactory.php`
- E-14: `src/Core/System/Snippet/Filter/AbstractFilter.php`
- E-15: `src/Core/System/Snippet/Filter/AddedFilter.php`
- E-16: `src/Core/System/Snippet/Filter/EditedFilter.php`
- E-17: `src/Core/System/Snippet/Filter/EmptySnippetFilter.php`
- E-18: `src/Core/System/Snippet/Filter/AuthorFilter.php`
- E-19: `src/Core/System/Snippet/Filter/NamespaceFilter.php`
- E-20: `src/Core/System/Snippet/Filter/TermFilter.php`
- E-21: `src/Core/System/Snippet/Filter/TranslationKeyFilter.php`
- E-22: `src/Core/System/Snippet/Files/SnippetFileCollection.php`
- E-23: `src/Core/System/Snippet/Files/AbstractSnippetFile.php`
- E-24: `src/Core/System/Snippet/Files/GenericSnippetFile.php`
- E-25: `src/Core/System/Snippet/Subscriber/CustomFieldSubscriber.php`
- E-26: `src/Core/System/Snippet/Api/SnippetController.php`

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

### SnippetEntity (UT-SNP-001 ~ UT-SNP-011)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | SnippetEntity::getSetId() - setIdプロパティを返却 | E-01 (L27-30) | ○ |
| C-02 | SnippetEntity::setSetId() - setIdプロパティを設定 | E-01 (L32-35) | ○ |
| C-03 | SnippetEntity::getTranslationKey() - translationKeyを返却 | E-01 (L37-40) | ○ |
| C-04 | SnippetEntity::setTranslationKey() - translationKeyを設定 | E-01 (L42-45) | ○ |
| C-05 | SnippetEntity::getValue() - valueを返却 | E-01 (L47-50) | ○ |
| C-06 | SnippetEntity::setValue() - valueを設定 | E-01 (L52-55) | ○ |
| C-07 | SnippetEntity::getAuthor() - authorを返却 | E-01 (L57-60) | ○ |
| C-08 | SnippetEntity::setAuthor() - authorを設定 | E-01 (L62-65) | ○ |
| C-09 | SnippetEntity::getSet() - SnippetSetEntityまたはnullを返却 | E-01 (L67-70) | ○ |
| C-10 | SnippetEntity::setSet() - SnippetSetEntityを設定 | E-01 (L72-75) | ○ |

### SnippetSetEntity (UT-SNP-012 ~ UT-SNP-022)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-11 | SnippetSetEntity::getName() - nameプロパティを返却 | E-04 (L28-31) | ○ |
| C-12 | SnippetSetEntity::setName() - nameプロパティを設定 | E-04 (L33-36) | ○ |
| C-13 | SnippetSetEntity::getBaseFile() - baseFileを返却 | E-04 (L38-41) | ○ |
| C-14 | SnippetSetEntity::setBaseFile() - baseFileを設定 | E-04 (L43-46) | ○ |
| C-15 | SnippetSetEntity::getIso() - isoを返却 | E-04 (L48-51) | ○ |
| C-16 | SnippetSetEntity::setIso() - isoを設定 | E-04 (L53-56) | ○ |
| C-17 | SnippetSetEntity::getSnippets() - SnippetCollectionまたはnullを返却 | E-04 (L58-61) | ○ |
| C-18 | SnippetSetEntity::setSnippets() - SnippetCollectionを設定 | E-04 (L63-66) | ○ |
| C-19 | SnippetSetEntity::getSalesChannelDomains() - SalesChannelDomainCollectionまたはnullを返却 | E-04 (L68-71) | ○ |
| C-20 | SnippetSetEntity::setSalesChannelDomains() - SalesChannelDomainCollectionを設定 | E-04 (L73-76) | ○ |

### Collection Classes (UT-SNP-023 ~ UT-SNP-026)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-21 | SnippetCollection::getApiAlias() - snippet_collectionを返却 | E-03 (L14-17) | ○ |
| C-22 | SnippetCollection::getExpectedClass() - SnippetEntity::classを返却 | E-03 (L19-22) | ○ |
| C-23 | SnippetSetCollection::getApiAlias() - snippet_set_collectionを返却 | E-06 (L14-17) | ○ |
| C-24 | SnippetSetCollection::getExpectedClass() - SnippetSetEntity::classを返却 | E-06 (L19-22) | ○ |

### SnippetService (UT-SNP-027 ~ UT-SNP-041)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-25 | SnippetService::getList() - ページネーション、フィルタ、ソートを適用してスニペット一覧を返却 | E-07 (L63-91) | ○ |
| C-26 | SnippetService::getStorefrontSnippets() - フォールバック付きでスニペットをマージ | E-07 (L96-161) | ○ |
| C-27 | SnippetService::getRegionFilterItems() - translationKeyの先頭部分をリージョンとして抽出 | E-07 (L166-197) | ○ |
| C-28 | SnippetService::getAuthors() - DBとファイルから著者を統合して返却 | E-07 (L202-225) | ○ |
| C-29 | SnippetService::findSnippetSetId() - SalesChannelDomainからSnippetSetIdを解決、フォールバックあり | E-07 (L227-256) | ○ |

### SnippetValidator (UT-SNP-042 ~ UT-SNP-045)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-30 | SnippetValidator::getValidation() - 欠損スニペットと不正複数形を検出 | E-08 (L65-116) | ○ |
| C-31 | SnippetValidator - hasInvalidPluralization()で]1,Inf[パターンを検出 | E-08 (L243-264) | ○ |
| C-32 | SnippetValidator - findMissingSnippets()でen/de間の欠損を検出 | E-08 (L209-238) | ○ |

### SnippetFixer (UT-SNP-046 ~ UT-SNP-048)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-33 | SnippetFixer::fix() - MissingSnippetCollectionとInvalidPluralizationCollectionを修正 | E-09 (L27-46) | ○ |
| C-34 | SnippetFixer - fixMissingSnippets()でJSONファイルに翻訳を追加 | E-09 (L48-73) | ○ |
| C-35 | SnippetFixer - fixInvalidPluralization()で]1,Inf[を[0,Inf[に置換 | E-09 (L75-87, L123-141) | ○ |

### Filter Classes (UT-SNP-049 ~ UT-SNP-083)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-36 | SnippetFilterFactory::getFilter() - 名前でフィルタを検索、なければ例外 | E-13 (L20-29) | ○ |
| C-37 | AbstractFilter::supports() - getName()と一致するかチェック | E-14 (L16-19) | ○ |
| C-38 | AbstractFilter::readjust() - フィルタ結果を正規化 | E-14 (L27-56) | ○ |
| C-39 | AddedFilter::filter() - author=user/*のスニペットを抽出 | E-15 (L21-35) | ○ |
| C-40 | EditedFilter::filter() - id!=null && author!=user/*のスニペットを抽出 | E-16 (L21-35) | ○ |
| C-41 | EmptySnippetFilter::filter() - value=空のスニペットを抽出 | E-17 (L21-35) | ○ |
| C-42 | AuthorFilter::filter() - 指定著者のスニペットを抽出 | E-18 (L21-38) | ○ |
| C-43 | NamespaceFilter::filter() - translationKeyの部分一致で抽出 | E-19 (L21-42) | ○ |
| C-44 | TermFilter::filter() - translationKeyまたはvalueで部分一致検索 | E-20 (L21-42) | ○ |
| C-45 | TranslationKeyFilter::filter() - translationKeyの完全一致で抽出 | E-21 (L21-38) | ○ |

### SnippetFileCollection (UT-SNP-084 ~ UT-SNP-101)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-46 | SnippetFileCollection::add() - mappingをリセットしてファイル追加 | E-22 (L23-27) | ○ |
| C-47 | SnippetFileCollection::get() - キーまたは名前でファイル取得 | E-22 (L29-36) | ○ |
| C-48 | SnippetFileCollection::getByName() - 名前でファイル検索 | E-22 (L56-65) | ○ |
| C-49 | SnippetFileCollection::getFilesArray() - isBaseでフィルタした配列 | E-22 (L70-73) | ○ |
| C-50 | SnippetFileCollection::toArray() - 全ファイル情報の配列 | E-22 (L78-94) | ○ |
| C-51 | SnippetFileCollection::getIsoList() - ISO一覧を返却 | E-22 (L99-102) | ○ |
| C-52 | SnippetFileCollection::getSnippetFilesByIso() - 指定ISOのファイル一覧 | E-22 (L107-112) | ○ |
| C-53 | SnippetFileCollection::getBaseFileByIso() - ベースファイル取得、なければ例外 | E-22 (L114-125) | ○ |
| C-54 | SnippetFileCollection::hasFileForPath() - パスでファイル存在確認 | E-22 (L132-142) | ○ |

### GenericSnippetFile (UT-SNP-102 ~ UT-SNP-108)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-55 | GenericSnippetFile - コンストラクタで全プロパティを設定 | E-24 (L10-18) | ○ |
| C-56 | GenericSnippetFile::getName() - nameを返却 | E-24 (L20-23) | ○ |
| C-57 | GenericSnippetFile::getPath() - pathを返却 | E-24 (L25-28) | ○ |
| C-58 | GenericSnippetFile::getIso() - isoを返却 | E-24 (L30-33) | ○ |
| C-59 | GenericSnippetFile::getAuthor() - authorを返却 | E-24 (L35-38) | ○ |
| C-60 | GenericSnippetFile::isBase() - isBaseを返却 | E-24 (L40-43) | ○ |
| C-61 | GenericSnippetFile::getTechnicalName() - technicalNameを返却 | E-24 (L45-48) | ○ |
| C-62 | GenericSnippetFile::setTechnicalName() - technicalNameを設定 | E-24 (L50-53) | ○ |

### SnippetFileHandler (UT-SNP-109 ~ UT-SNP-117)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-63 | SnippetFileHandler::openJsonFile() - JSONファイルを読み込みパース | E-11 (L28-43) | ○ |
| C-64 | SnippetFileHandler::writeJsonFile() - JSONファイルを2スペースインデントで書き込み | E-11 (L48-58) | ○ |
| C-65 | SnippetFileHandler::findAdministrationSnippetFiles() - 管理画面スニペット検索 | E-11 (L63-71) | ○ |
| C-66 | SnippetFileHandler::findStorefrontSnippetFiles() - ストアフロントスニペット検索 | E-11 (L76-84) | ○ |

### CustomFieldSubscriber (UT-SNP-118 ~ UT-SNP-122)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-67 | CustomFieldSubscriber::getSubscribedEvents() - custom_field.written/deletedを購読 | E-25 (L31-37) | ○ |
| C-68 | CustomFieldSubscriber::customFieldIsWritten() - INSERT時にスニペット作成 | E-25 (L39-73) | ○ |
| C-69 | CustomFieldSubscriber::customFieldIsDeleted() - 削除時に関連スニペット削除 | E-25 (L75-83) | ○ |

### SnippetException (UT-SNP-123 ~ UT-SNP-128)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-70 | SnippetException::invalidFilterName() - BAD_REQUEST例外生成 | E-10 (L49-56) | ○ |
| C-71 | SnippetException::filterNotFound() - フィルタ名とクラス名を含む例外 | E-10 (L58-65) | ○ |
| C-72 | SnippetException::invalidLimitQuery() - limit値を含む例外 | E-10 (L67-75) | ○ |
| C-73 | SnippetException::invalidSnippetFile() - ファイルパスと原因を含む例外 | E-10 (L77-87) | ○ |
| C-74 | SnippetException::snippetFileNotRegistered() - ロケールを含む例外 | E-10 (L89-97) | ○ |
| C-75 | SnippetException::snippetSetNotFound() - snippetSetIdを含む例外 | E-10 (L99-107) | ○ |

### SnippetController (UT-SNP-129 ~ UT-SNP-134)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-76 | SnippetController::getList() - POSTでスニペット一覧取得、limit<1で例外 | E-26 (L32-57) | ○ |
| C-77 | SnippetController::getFilterItems() - GETでフィルタ項目取得 | E-26 (L59-68) | ○ |
| C-78 | SnippetController::getBaseFiles() - GETでベースファイル一覧取得 | E-26 (L70-79) | ○ |
| C-79 | SnippetController::getAuthors() - GETで著者一覧取得 | E-26 (L81-90) | ○ |

### Definition Classes (UT-SNP-135 ~ UT-SNP-141)
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-80 | SnippetDefinition::getEntityName() - snippetを返却 | E-02 (L27-30) | ○ |
| C-81 | SnippetDefinition::getCollectionClass() - SnippetCollectionを返却 | E-02 (L32-35) | ○ |
| C-82 | SnippetDefinition::getEntityClass() - SnippetEntityを返却 | E-02 (L37-40) | ○ |
| C-83 | SnippetDefinition::getParentDefinitionClass() - SnippetSetDefinitionを返却 | E-02 (L47-50) | ○ |
| C-84 | SnippetSetDefinition::getEntityName() - snippet_setを返却 | E-05 (L25-28) | ○ |
| C-85 | SnippetSetDefinition::getCollectionClass() - SnippetSetCollectionを返却 | E-05 (L30-33) | ○ |
| C-86 | SnippetSetDefinition::getEntityClass() - SnippetSetEntityを返却 | E-05 (L35-38) | ○ |

## 4) 不足情報（Unknown / Missing）
- 根拠なしの項目はありません

## 5) リスクフラグ（レビュー観点）
- **0: 低リスク** - Entity/Collectionのプロパティアクセサ/ミューテータ（UT-SNP-001~026, 102~108）
- **1: 中リスク** - Filter処理、ファイル操作（UT-SNP-049~101, 109~117）
- **2: 高リスク** - SnippetService::getStorefrontSnippets()のフォールバック・マージロジック、SnippetValidator/Fixerのバリデーション・修正ロジック、CustomFieldSubscriberのイベント連動処理（UT-SNP-032~048, 118~122）

## 6) レビュアーチェックリスト（最小）
- [ ] SnippetService::getStorefrontSnippets()のフォールバック順序が正しいか確認
- [ ] SnippetValidator::hasInvalidPluralization()の正規表現パターンが複数形形式を正しく検出するか確認
- [ ] CustomFieldSubscriber::customFieldIsWritten()で全SnippetSetに対してスニペットが作成されるか確認
- [ ] SnippetFixer::fix()で複数形の置換パターン`]1,Inf[`->`[0,Inf[`が正しいか確認
- [ ] SnippetFileCollection::hasFileForPath()のrealpath()がシンボリックリンクを正しく解決するか確認
- [ ] フィルタ各クラスのreadjust()が他セットのスニペットを正しく補完するか確認
