---
generated_at: 2026-02-24 22:15:00
metrics:
  claims_total: 35
  claims_with_evidence: 33
  claims_without_evidence: 2
confidence_derived: 0.94
---

# 根拠レポート：2-商品エクスポートCSV

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.94**
  - 根拠あり：33 / 35、根拠なし：2
- 優先レビュー（高）
  1. **想定データ件数**：具体的な数値の根拠なし
  2. **利用画面URL**：画面設計書との整合性要確認
  3. **動的カラムの完全な列挙**：実行時のみ確定するカラムあり

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

- E-01: `packages/medusa/src/api/admin/products/export/route.ts` - APIルート定義
- E-02: `packages/core/core-flows/src/product/workflows/export-products.ts` - ワークフロー定義
- E-03: `packages/core/core-flows/src/product/steps/export-products.ts` - CSVエクスポートステップ
- E-04: `packages/core/core-flows/src/product/helpers/normalize-for-export.ts` - データ正規化ヘルパー
- E-05: `integration-tests/http/__tests__/product/admin/product-export.spec.ts` - 統合テスト
- E-06: `docs/code-to-docs/帳票一覧/帳票一覧.csv` - 帳票一覧

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | ファイル名は`{timestamp}-product-exports.csv`形式 | E-03 行30 | ○ |
| C-02 | バッチサイズのデフォルトは50件 | E-03 行13, 36-38 | ○ |
| C-03 | CSVインジェクション対策が有効 | E-03 行68 | ○ |
| C-04 | 非同期・バックグラウンドで実行される | E-02 行59-61 | ○ |
| C-05 | APIは202ステータスを返す | E-01 行20 | ○ |
| C-06 | MIMEタイプは"text/csv" | E-03 行33 | ○ |
| C-07 | 通知チャネルは"feed"で"admin-ui"テンプレート使用 | E-02 行68-69, 92-93 | ○ |
| C-08 | バリアント単位で1行が出力される | E-04 行17-35 | ○ |
| C-09 | Product Idカラムが出力される | E-04 行74, E-05 行278 | ○ |
| C-10 | Product Handleカラムが出力される | E-04 行74, E-05 行284 | ○ |
| C-11 | 商品画像が動的カラムで出力される | E-04 行41-47, E-05 行279-280 | ○ |
| C-12 | 商品タグが動的カラムで出力される | E-04 行49-55, E-05 行287-288 | ○ |
| C-13 | セールスチャネルが動的カラムで出力される | E-04 行57-63 | ○ |
| C-14 | カテゴリが動的カラムで出力される | E-04 行65-71 | ○ |
| C-15 | Variant Idカラムが出力される | E-04 行152, E-05 行303 | ○ |
| C-16 | Variant Titleカラムが出力される | E-04 行152, E-05 行319 | ○ |
| C-17 | 価格カラムは通貨コードで出力される | E-04 行130-132, E-05 行314-316 | ○ |
| C-18 | リージョン価格は[通貨コード]形式で出力される | E-04 行123-127, E-05 行707 | ○ |
| C-19 | オプション名・値が動的カラムで出力される | E-04 行139-149, E-05 行309-312 | ○ |
| C-20 | Product Metadataは出力から除外される | E-04 行87 | ○ |
| C-21 | Product Optionsは出力から除外される | E-04 行95 | ○ |
| C-22 | Product Type/Collectionは出力から除外される（IDのみ出力） | E-04 行90-91 | ○ |
| C-23 | Variant Price Setは正規化後に除外される | E-04 行156 | ○ |
| C-24 | Variant Optionsは正規化後に除外される | E-04 行157 | ○ |
| C-25 | リージョン情報を価格カラム名生成に使用 | E-03 行25-28, E-04 行15 | ○ |
| C-26 | リージョン未発見時にMedusaErrorをスロー | E-04 行117-120 | ○ |
| C-27 | 失敗時に通知が送信される | E-02 行63-77 | ○ |
| C-28 | 成功時にダウンロードリンク付き通知が送信される | E-02 行86-105 | ○ |
| C-29 | ファイル削除はコンペンセーションとして実装されている | E-03 行92-99 | ○ |
| C-30 | 価格カラムは通貨コード降順でソートされる | E-04 行108 | ○ |
| C-31 | beautifyKey関数でカラム名がPascal Case風に変換される | E-04 行171-173 | ○ |
| C-32 | prefixFields関数でプレフィックスが付加される | E-04 行162-169 | ○ |
| C-33 | バリアントのない商品も1行として出力される | E-04 行19-21 | ○ |
| C-34 | 想定データ件数は数百〜数千商品 | **根拠なし** | △ |
| C-35 | 利用画面は商品一覧画面と商品エクスポート画面 | **根拠不足** | △ |

## 4) 不足情報（Unknown / Missing）
- **想定データ件数（C-34）**：具体的なパフォーマンステストや要件定義書がないため、一般的なEC運用想定として記載
  - 候補：負荷テスト結果 / パフォーマンス要件定義書 / 実運用データ統計
- **利用画面URL（C-35）**：画面設計書との突合が必要
  - 候補：画面設計書 / Admin Dashboardソースコード / ルーティング設定

## 5) リスクフラグ（レビュー観点）
- **0: 低リスク** - 静的CSVカラム定義（ソースコードのnormalizeForExport関数で確実に確認可能）
- **1: 中リスク** - 動的CSVカラム定義（画像、タグ、価格、オプションは実行時に決定）
- **0: 低リスク** - 処理フロー（ワークフロー定義とステップ定義で明確）
- **1: 中リスク** - パフォーマンス要件（実測データがないため）
- **0: 低リスク** - セキュリティ考慮事項（CSVインジェクション対策はコードで確認済み）
- **1: 中リスク** - リージョン価格ロジック（リージョンが存在しない場合のエラー処理）

## 6) レビュアーチェックリスト（最小）
- [ ] CSVカラム定義が統合テストの期待値と一致するか確認（product-export.spec.ts参照）
- [ ] 動的カラム（画像、タグ、価格、オプション）の出力順序が仕様通りか確認
- [ ] リージョン価格のカラム名生成ロジックが正しいか確認（スペース→アンダースコア変換）
- [ ] 画面設計書との利用画面URLの整合性を確認
- [ ] パフォーマンス要件が実運用に適切か確認
- [ ] インポート機能との互換性が維持されているか確認（csv-normalizer.tsの期待するカラム名と一致するか）
