商品検索・絞り込みの期待結果検証の実装資料

# Claude Code実装指示：B5 商品検索・絞り込みの期待結果検証

この指示文だけで完結する。別に渡す資料はない。要件の境界を守ったまま、既存のコードへ最小の変更で次の実装を加える。
対象は、Shopifyの店の中にある商品だけにする。ブランド、シリーズ、型番、別名、状態の項目を持つ架空の商品で、検索語ごとに「何が出てほしいか」を先に決めて固定する。

先に既存コード、変更対象、認証経路を確認する。既存の変更は消さない。推測で埋めない。テストはローカルか検証環境で先に作り、実装が済んだら受け入れテストを実行して、結果を実行条件とログつきで残す。

## 進め方
1. 店舗のテーマを置いた作業フォルダでClaude Codeを開き、下の指示文を渡す。CLAUDE.mdと検索・絞り込みに関わるテーマファイルを読ませ、既存の未コミット変更は残す。
2. 監査として、商品の正式名称、型番、別名がどの項目に入っているかを調べ、検索対象になっている項目とそうでない項目を書き出す。
3. 最小変更にとどめる。型番と別名を検索対象の項目に加え、絞り込みの組み合わせ方をANDかORの一つに決めて実装する。
4. 架空データの20商品を検証環境に入れ、受け入れテストの検索語ごとに結果を照合する。0件になる条件も含める。
5. 差分を確認する。変更ファイルの一覧を作り、本番の商品データを書き換えていないことを確かめる。
6. 進捗を更新する。変更一覧、実行したテスト、未検証の検索語、戻し方を報告に書く。

## 守ること（対象外・境界）
- 外部モールの在庫や相場エンジンを複製しない
- 正式名称、別名、型番を別の項目として持つ
- 絞り込みの組み合わせをANDとORのどちらで扱うかを仕様に書く
- 標準検索の限界を実測なしに断定しない

## 納品物
- 商品の項目の決め方：ブランド、シリーズ、型番、別名、状態（登録項目名はbrand、series、reference、aliases、condition）
- 検索語と、出てほしい結果の対応表
- 変更したファイルの一覧と差分
- 受け入れテストの実行結果
- 導入手順と戻し方

## 前提
- 対象の店の標準の検索と絞り込みの設定を先に確認する
- 検索アプリを使う場合は、同じ検索語と同じ商品データで比べる
- 架空の商品20件（synthetic）で手元の確認を先に済ませる

## 受け入れテスト
1. B5-AT1 検索語「REF-003」でDEMO-003だけが一致する。（実行状態: 未実行／必要な環境: 検証用の店舗に架空の商品20件を入れた状態）
2. B5-AT2 別名「R003」で正式型番と同じ商品が出る。出ない場合は、別名が未対応であることを仕様に書く。（実行状態: 未実行／必要な環境: 検証用の店舗に架空の商品20件を入れた状態）
3. B5-AT3 ブランド「Demo A」とシリーズ「S2」で5件、状態「new」を加えると1件（DEMO-015）、該当のない組み合わせでは0件の案内が出る。（実行状態: 未実行／必要な環境: 検証用の店舗に架空の商品20件を入れた状態）
4. B5-AT4 絞り込みを解除すると20件すべてに戻る。（実行状態: 未実行／必要な環境: 検証用の店舗に架空の商品20件を入れた状態）

未実行の項目は「未実行」、実環境が要る項目は「実環境待ち」と記録し、実行条件とログを残す。記録上の区分はnot_runとblocked_external。

## 架空データ
実店舗のデータではない。下のJSONをそのまま検証用のデータにする。
```json
{
  "data_kind": "synthetic",
  "contains_real_customer_data": false,
  "note": "架空の商品20件と、検索語・絞り込みごとの期待結果。",
  "filter_logic": "AND",
  "queries": [
    {
      "id": "Q1",
      "query": "REF-003",
      "filters": {},
      "expected_ids": [
        "DEMO-003"
      ]
    },
    {
      "id": "Q2",
      "query": "R003",
      "filters": {},
      "expected_ids": [
        "DEMO-003"
      ],
      "note": "別名一致。標準検索で対応できるかは未確認"
    },
    {
      "id": "Q3",
      "query": "",
      "filters": {
        "brand": "Demo A",
        "series": "S2"
      },
      "expected_ids": [
        "DEMO-011",
        "DEMO-013",
        "DEMO-015",
        "DEMO-017",
        "DEMO-019"
      ]
    },
    {
      "id": "Q4",
      "query": "",
      "filters": {
        "brand": "Demo A",
        "series": "S2",
        "condition": "new"
      },
      "expected_ids": [
        "DEMO-015"
      ]
    },
    {
      "id": "Q5",
      "query": "",
      "filters": {
        "brand": "Demo C"
      },
      "expected_ids": []
    },
    {
      "id": "Q6",
      "query": "",
      "filters": {},
      "expected_count": 20
    }
  ],
  "items": [
    {
      "id": "DEMO-001",
      "brand": "Demo A",
      "series": "S1",
      "reference": "REF-001",
      "aliases": [
        "R001"
      ],
      "condition": "used"
    },
    {
      "id": "DEMO-002",
      "brand": "Demo B",
      "series": "S1",
      "reference": "REF-002",
      "aliases": [
        "R002"
      ],
      "condition": "used"
    },
    {
      "id": "DEMO-003",
      "brand": "Demo A",
      "series": "S1",
      "reference": "REF-003",
      "aliases": [
        "R003"
      ],
      "condition": "new"
    },
    {
      "id": "DEMO-004",
      "brand": "Demo B",
      "series": "S1",
      "reference": "REF-004",
      "aliases": [
        "R004"
      ],
      "condition": "used"
    },
    {
      "id": "DEMO-005",
      "brand": "Demo A",
      "series": "S1",
      "reference": "REF-005",
      "aliases": [
        "R005"
      ],
      "condition": "used"
    },
    {
      "id": "DEMO-006",
      "brand": "Demo B",
      "series": "S1",
      "reference": "REF-006",
      "aliases": [
        "R006"
      ],
      "condition": "new"
    },
    {
      "id": "DEMO-007",
      "brand": "Demo A",
      "series": "S1",
      "reference": "REF-007",
      "aliases": [
        "R007"
      ],
      "condition": "used"
    },
    {
      "id": "DEMO-008",
      "brand": "Demo B",
      "series": "S1",
      "reference": "REF-008",
      "aliases": [
        "R008"
      ],
      "condition": "used"
    },
    {
      "id": "DEMO-009",
      "brand": "Demo A",
      "series": "S1",
      "reference": "REF-009",
      "aliases": [
        "R009"
      ],
      "condition": "new"
    },
    {
      "id": "DEMO-010",
      "brand": "Demo B",
      "series": "S1",
      "reference": "REF-010",
      "aliases": [
        "R010"
      ],
      "condition": "used"
    },
    {
      "id": "DEMO-011",
      "brand": "Demo A",
      "series": "S2",
      "reference": "REF-011",
      "aliases": [
        "R011"
      ],
      "condition": "used"
    },
    {
      "id": "DEMO-012",
      "brand": "Demo B",
      "series": "S2",
      "reference": "REF-012",
      "aliases": [
        "R012"
      ],
      "condition": "new"
    },
    {
      "id": "DEMO-013",
      "brand": "Demo A",
      "series": "S2",
      "reference": "REF-013",
      "aliases": [
        "R013"
      ],
      "condition": "used"
    },
    {
      "id": "DEMO-014",
      "brand": "Demo B",
      "series": "S2",
      "reference": "REF-014",
      "aliases": [
        "R014"
      ],
      "condition": "used"
    },
    {
      "id": "DEMO-015",
      "brand": "Demo A",
      "series": "S2",
      "reference": "REF-015",
      "aliases": [
        "R015"
      ],
      "condition": "new"
    },
    {
      "id": "DEMO-016",
      "brand": "Demo B",
      "series": "S2",
      "reference": "REF-016",
      "aliases": [
        "R016"
      ],
      "condition": "used"
    },
    {
      "id": "DEMO-017",
      "brand": "Demo A",
      "series": "S2",
      "reference": "REF-017",
      "aliases": [
        "R017"
      ],
      "condition": "used"
    },
    {
      "id": "DEMO-018",
      "brand": "Demo B",
      "series": "S2",
      "reference": "REF-018",
      "aliases": [
        "R018"
      ],
      "condition": "new"
    },
    {
      "id": "DEMO-019",
      "brand": "Demo A",
      "series": "S2",
      "reference": "REF-019",
      "aliases": [
        "R019"
      ],
      "condition": "used"
    },
    {
      "id": "DEMO-020",
      "brand": "Demo B",
      "series": "S2",
      "reference": "REF-020",
      "aliases": [
        "R020"
      ],
      "condition": "used"
    }
  ]
}
```

## 戻し方
- 変更前に検索設定、テーマファイル、商品属性の変更範囲を記録する。
- コードは対象の差分だけを元に戻す。検索アプリを外した後に標準検索が動くことを確認する。
- 商品属性を書き換えた場合は、バックアップから戻し、件数と型番の一致を確認する。
- 本番の切り戻しを自動で実行しない。対象環境と影響を示して承認を得る。

## 資料全体の対象外
- SEOの順位、AIによる引用、売上の改善は保証しない。
- Timeseekの本番ストアへの接続や書き込みは含まない。
- 紹介リンクを使うことを条件にしない。資料を読むにも使うにも、登録や紹介リンクは要らない。

紹介先のツールを使う義務はない。契約済みなら新規契約を促さない。外部サービスへの接続、課金、本番反映、顧客データの送信は、店舗側の承認を得てからにする。

最後に、変更一覧、実行したテスト、未検証の条件、戻し方を提示する。「動くはず」は結果にしない。