---
generated_at: 2026-01-29 16:00:00
metrics:
  claims_total: 28
  claims_with_evidence: 26
  claims_without_evidence: 2
confidence_derived: 0.93
---

# 根拠レポート：61-検索設定

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.93**
  - 根拠あり：26 / 28、根拠なし：2
- 優先レビュー（高）
  1. **Elasticsearchとの連携詳細**：ソースコードで `storefrontEsEnable` フラグの参照は確認したが、詳細な連携仕様は未確認
  2. **メッセージキーと実際の表示テキスト**：翻訳ファイル（snippets）は未参照のため、実際の表示テキストは推定

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

- E-01: `src/Administration/Resources/app/administration/src/module/sw-settings-search/index.js`
- E-02: `src/Administration/Resources/app/administration/src/module/sw-settings-search/page/sw-settings-search/index.js`
- E-03: `src/Administration/Resources/app/administration/src/module/sw-settings-search/page/sw-settings-search/sw-settings-search.html.twig`
- E-04: `src/Administration/Resources/app/administration/src/module/sw-settings-search/view/sw-settings-search-view-general/index.js`
- E-05: `src/Administration/Resources/app/administration/src/module/sw-settings-search/view/sw-settings-search-view-live-search/index.js`
- E-06: `src/Administration/Resources/app/administration/src/module/sw-settings-search/component/sw-settings-search-search-behaviour/index.js`
- E-07: `src/Administration/Resources/app/administration/src/module/sw-settings-search/component/sw-settings-search-searchable-content/index.js`
- E-08: `src/Administration/Resources/app/administration/src/module/sw-settings-search/component/sw-settings-search-excluded-search-terms/index.js`
- E-09: `src/Administration/Resources/app/administration/src/module/sw-settings-search/component/sw-settings-search-search-index/index.js`
- E-10: `src/Administration/Resources/app/administration/src/module/sw-settings-search/service/productIndex.api.service.js`
- E-11: `src/Administration/Resources/app/administration/src/module/sw-settings-search/acl/index.js`
- E-12: `docs/code-to-docs/画面一覧/画面一覧.csv`
- E-13: `docs/code-to-docs/画面機能マッピング/画面機能マッピング.csv`

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | モジュール名は sw-settings-search | E-01 (49行目) | ○ |
| C-02 | ルートパスは sw.settings.search.index | E-01 (61-93行目) | ○ |
| C-03 | 2つのタブ（一般、ライブ検索）がある | E-01 (74-92行目), E-03 | ○ |
| C-04 | product_search_config エンティティを使用 | E-01 (59行目), E-02 (51行目) | ○ |
| C-05 | AND/OR検索の切り替えが可能 | E-02 (32-35行目), E-06 (38-50行目) | ○ |
| C-06 | 最小検索文字数は1〜20の範囲 | E-06 (32-34行目) | ○ |
| C-07 | viewer/editor/creator/deleter の4つの権限ロールがある | E-11 (9-57行目) | ○ |
| C-08 | 保存ショートカットは SYSTEMKEY+S | E-02 (21-27行目) | ○ |
| C-09 | 言語切り替え機能がある | E-02 (205-208行目), E-03 (18-22行目) | ○ |
| C-10 | 検索可能フィールドにはname, productNumber, ean等がある | E-07 (51-187行目) | ○ |
| C-11 | フィールドにはsearchable, ranking, tokenize属性がある | E-07 (219-249行目) | ○ |
| C-12 | 除外キーワードの追加・削除・編集が可能 | E-08 (116-258行目) | ○ |
| C-13 | 除外キーワードのデフォルトリセット機能がある | E-08 (283-297行目) | ○ |
| C-14 | インデックス再構築機能がある | E-09 (162-179行目) | ○ |
| C-15 | インデックス再構築は3秒間隔でポーリング | E-09 (7行目) PRODUCT_INDEXER_INTERVAL = 3000 | ○ |
| C-16 | インデックスAPIエンドポイントは /_action/indexing/product.indexer | E-10 (14行目) | ○ |
| C-17 | 未保存で画面離脱時に確認モーダルが表示される | E-02 (98-104行目), E-03 (100-110行目) | ○ |
| C-18 | カスタムフィールドも検索対象に設定可能 | E-07 (44-47行目), E-01 (32-35行目) | ○ |
| C-19 | 最終インデックス日時が表示される | E-09 (81-101行目) | ○ |
| C-20 | 進捗バーでインデックス再構築の進捗が表示される | E-09 (121-147行目) | ○ |
| C-21 | ライブ検索タブで検索テストが可能 | E-05 (10-35行目), E-01 (84-91行目) | ○ |
| C-22 | Elasticsearch有効時に特殊な処理がある | E-05 (39-41行目), E-07 (252-254行目) | ○ |
| C-23 | 関連機能は「商品検索」（機能No.32） | E-13 | ○ |
| C-24 | 画面No.61として登録されている | E-12 | ○ |
| C-25 | 設定グループは「general」 | E-01 (97行目) | ○ |
| C-26 | アイコンは regular-search | E-01 (99行目) | ○ |
| C-27 | Elasticsearchの詳細な連携仕様 | **根拠なし** | △ |
| C-28 | メッセージの実際の表示テキスト | **根拠なし**（翻訳ファイル未参照） | △ |

## 4) 不足情報（Unknown / Missing）
- **Elasticsearch連携の詳細仕様**
  - ソースコードで `storefrontEsEnable` フラグの存在は確認したが、Elasticsearch有効時の具体的な動作差異は未調査
  - 候補：`src/Elasticsearch/` ディレクトリ内のソースコード / Shopware公式ドキュメント

- **翻訳ファイル（snippets）**
  - メッセージキーは確認したが、実際の表示テキストは翻訳ファイルから取得する必要がある
  - 候補：`src/Administration/Resources/app/administration/src/module/sw-settings-search/snippet/` ディレクトリ

- **バックエンドAPI仕様**
  - フロントエンドからのAPI呼び出しは確認したが、バックエンドの詳細な処理仕様は未調査
  - 候補：`src/Core/Content/Product/` 内のコントローラー・サービス

## 5) リスクフラグ（レビュー観点）
- **0（低リスク）**：モジュール構造、ルーティング、基本的なCRUD操作
- **0（低リスク）**：権限設定（ACL）
- **1（中リスク）**：Elasticsearch連携の記述（一部推定含む）
- **0（低リスク）**：データベース更新仕様（Repository経由の操作は明確）

## 6) レビュアーチェックリスト（最小）
- [ ] ルーティングパス `sw.settings.search.index` が実際の画面URLと一致するか確認
- [ ] 権限ロール（viewer/editor/creator/deleter）が実際の権限管理と一致するか確認
- [ ] 検索フィールドのデフォルト値（ranking等）が実際のビジネス要件と一致するか確認
- [ ] インデックス再構築の実行時間が許容範囲内か確認（商品数による）
- [ ] Elasticsearch有効時の動作差異について、必要に応じて追加調査
