商品ページの条件付き情報表示の実装資料

# Claude Code実装指示：B1 商品ページの条件付き情報表示

この指示文だけで完結する。別に渡す資料はない。要件の境界を守ったまま、既存のコードへ最小の変更で次の実装を加える。
保証、付属品、状態、動画を、商品ごとに登録された事実だけから商品ページに表示する。「ある」「ない」「分からない」の三つを分けて扱い（登録上の値はtrue、false、unknown）、分からないものは分からないまま出す。分からないものを「保証あり」に寄せない。

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

## 進め方
1. 店舗のテーマを置いた作業フォルダでClaude Codeを開き、下の指示文を渡す。CLAUDE.mdと変更対象のテーマファイルを読ませ、既存の未コミット変更は残す。
2. 監査として、商品ごとの保証、付属品、状態、動画がどこに登録されているかを調べ、「なし」と「未登録」を判定できる項目を書き出す。
3. 最小変更にとどめる。商品テンプレートの表示部分だけを変え、true、false、unknownで分岐する。unknownは「未確認」と表示し、保証ありに寄せない。
4. 架空データの3商品で表示を確かめ、受け入れテストの4項目を実行する。実行できない項目は未実行（not_run）と記録する。
5. 差分を確認する。変更ファイルの一覧を作り、本番テーマへ書き込んでいないことを確かめる。
6. 進捗を更新する。変更一覧、実行したテスト、未検証の条件、戻し方を報告に書く。「動くはず」を結果にしない。

## 守ること（対象外・境界）
- 全商品に鑑別や保証を一律に表示しない
- 動画がない商品では空の枠と再生ボタンを出さない
- 付属品なしと登録不明を別の表示にする
- 対象テーマの複製で確認し、本番テーマへ直接書き込まない

## 納品物
- 商品ごとの4項目の決め方：保証、付属品、状態、動画（登録項目名はwarranty_status、accessories_status、condition、video_url）
- 表示の決まり（PCとスマホの表示例）
- 変更したファイルの一覧と差分
- 受け入れテストの実行結果
- 導入手順と戻し方

## 前提
- 店のデザイン設定（テーマ）の構成と、商品ごとに登録できる項目（metafield）の中身を先に確認する
- 本番のテーマ、外部との接続（API）、契約が必要な作業は、着手前に確認する
- 架空データ（synthetic fixtures）で手元の確認を先に済ませる

## 受け入れテスト
1. B1-AT1 保証が不明の商品（DEMO-001）で、保証ありの表示や文言が出ない。（実行状態: 未実行／必要な環境: 複製したテーマと架空データの3商品）
2. B1-AT2 付属品なし（DEMO-001）、付属品あり（DEMO-002）、登録不明（DEMO-003）で表示が違い、不明は「未確認」と出る。（実行状態: 未実行／必要な環境: 複製したテーマと架空データの3商品）
3. B1-AT3 スマホ幅（360px）で価格と問い合わせの導線が読める。（実行状態: 未実行／必要な環境: 複製したテーマを、幅360pxのスマホ用ブラウザで表示）
4. B1-AT4 テーマを切り戻すと変更前の表示に戻る。（実行状態: 未実行／必要な環境: 複製したテーマ（切り戻しの手順をそのまま試す））

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

## 架空データ
実店舗のデータではない。下のJSONをそのまま検証用のデータにする。
```json
{
  "data_kind": "synthetic",
  "contains_real_customer_data": false,
  "note": "架空の商品3件。DEMO-003は付属品の登録がない場合の例。",
  "status_values": {
    "accessories_status": [
      "listed",
      "known_none",
      "unknown"
    ],
    "warranty_status": [
      "known",
      "known_none",
      "unknown"
    ]
  },
  "items": [
    {
      "id": "DEMO-001",
      "condition": "used",
      "accessories_status": "known_none",
      "warranty_status": "unknown",
      "video_url": null
    },
    {
      "id": "DEMO-002",
      "condition": "used",
      "accessories_status": "listed",
      "accessories": [
        "外箱"
      ],
      "warranty_status": "known",
      "warranty_text": "この例の保証条件",
      "video_url": null
    },
    {
      "id": "DEMO-003",
      "condition": "used",
      "accessories_status": "unknown",
      "warranty_status": "known_none",
      "video_url": null
    }
  ]
}
```

## 戻し方
- 変更前に対象テーマ、設定、データの変更範囲を記録し、複製テーマで作業する。
- コードは対象の差分だけを元に戻す。テーマ全体を古い版で上書きしない。
- 商品データを更新した場合は、バックアップ、整合確認、反映の承認を経てから戻す。
- 本番の切り戻しを自動で実行しない。対象環境と影響を示して承認を得る。

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

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

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