商品CSVの不足・差分検査の実装資料

# Claude Code実装指示：E1 商品CSVの不足・差分検査

この指示文だけで完結する。別に渡す資料はない。要件の境界を守ったまま、既存のコードへ最小の変更で次の実装を加える。
商品の一覧ファイル（CSV）を読み取り、必須の項目が空の行を見つけて、行番号と項目名つきの確認レポートを手元に作る処理を一つだけ用意する。外部には送らない。本番の商品も変えない。

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

## 進め方
1. 処理を置く作業フォルダでClaude Codeを開き、下の指示文を渡す。CLAUDE.mdと既存の処理を読ませ、未コミットの変更は残す。
2. 監査として、商品CSVの列と必須項目を書き出し、null（未確認）と0や空文字を区別する読み取り方を決める。
3. 最小変更にとどめる。CSVを読み、必須項目の欠損を行番号と項目名で返す処理を一つ作る。結果はローカルのファイルに書く。
4. 架空データの2件で欠損を検知し、同じ入力を2回処理して報告が増えないことを確かめる。受け入れテストの4項目を実行する。
5. 差分を確認する。元のCSVは変えない。外部送信や本番更新のコードが入っていないことも確かめる。
6. 進捗を更新する。変更一覧、実行したテスト、未検証の条件、戻し方を報告に書く。

## 守ること（対象外・境界）
- 元のCSVファイルを上書きしない
- サンプルに個人情報を入れない
- 同じ入力を繰り返しても報告を増やさない
- Makeやn8nで組む場合も、テンプレートがこの仕様に合うかを検証する

## 納品物
- 入力の決め方：列の名前、必須の項目、値の形（必須の項目は登録上required_fields）
- 出力の決め方：空だった行番号と項目名、前回との違い
- うまく読めなかったときの扱いと、人が確認してから進める手順
- 受け入れテストの実行結果
- 導入手順と戻し方

## 前提
- 商品CSVの列の並びと必須の項目を、店側で先に決める
- 通知先や本番の更新を加える場合は、別に承認を取る
- 架空データ（synthetic fixtures）で手元の確認を先に済ませる

## 受け入れテスト
1. E1-AT1 必須項目が欠けた行（DEMO-002のreferenceとprice）を、行番号と項目名で報告する。（実行状態: 未実行／必要な環境: 手元のパソコンと架空データの商品2件）
2. E1-AT2 priceがnullの商品を0円に変換せず、未確認として扱う。（実行状態: 未実行／必要な環境: 手元のパソコンと架空データの商品2件）
3. E1-AT3 同じCSVを2回処理しても、報告の件数と内容が変わらない。（実行状態: 未実行／必要な環境: 手元のパソコンと架空データの商品2件）
4. E1-AT4 処理の中に外部送信と在庫の書き換えがない。（実行状態: 未実行／必要な環境: 処理のコードを読んで確認する（実行は要らない））

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

## 架空データ
実店舗のデータではない。下のJSONをそのまま検証用のデータにする。
```json
{
  "data_kind": "synthetic",
  "contains_real_customer_data": false,
  "note": "架空の商品2件。priceは通貨の最小単位の整数で、nullは未確認を表す。",
  "required_fields": [
    "id",
    "title",
    "reference",
    "price",
    "currency"
  ],
  "expected_report": [
    {
      "row": 2,
      "id": "DEMO-002",
      "missing": [
        "reference",
        "price"
      ]
    }
  ],
  "items": [
    {
      "id": "DEMO-001",
      "title": "サンプル商品1",
      "reference": "REF-001",
      "price": 100000,
      "currency": "JPY"
    },
    {
      "id": "DEMO-002",
      "title": "サンプル商品2",
      "reference": null,
      "price": null,
      "currency": "JPY"
    }
  ]
}
```

## 戻し方
- 処理は元のCSVを読むだけにする。出力は別のファイルに書き、消せば戻る状態を保つ。
- 自動化サービスのシナリオを止めるときは、実行履歴を残したまま無効化する。
- 通知先や本番更新を後から加えた場合は、その部分だけを先に止める。
- 本番の切り戻しを自動で実行しない。対象環境と影響を示して承認を得る。

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

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

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