---
generated_at: 2026-02-24 10:30:00
metrics:
  claims_total: 25
  claims_with_evidence: 24
  claims_without_evidence: 1
confidence_derived: 0.96
---

# 根拠レポート：31-カテゴリ編集画面

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.96**
  - 根拠あり：24 / 25、根拠なし：1
- 優先レビュー（高）
  1. **権限による表示制御**：認証処理の詳細実装が未確認
  2. **APIエンドポイント**：実際のAPI実装との整合性確認推奨
  3. **i18nキー**：翻訳ファイルとの整合性確認推奨

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

- E-01: `packages/admin/dashboard/src/routes/categories/category-edit/category-edit.tsx`
- E-02: `packages/admin/dashboard/src/routes/categories/category-edit/components/edit-category-form/edit-category-form.tsx`
- E-03: `packages/admin/dashboard/src/hooks/api/categories.tsx`
- E-04: `packages/admin/dashboard/src/routes/categories/category-detail/category-detail.tsx`
- E-05: `docs/code-to-docs/画面機能マッピング/画面機能マッピング.csv`
- E-06: `docs/code-to-docs/画面一覧/画面一覧.csv`
- E-07: `docs/code-to-docs/画面一覧/画面遷移図.md`

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | 画面種別がモーダル/ドロワー形式である | E-01 (RouteDrawer使用) | ○ |
| C-02 | URLが/categories/:id/editである | E-06 (画面一覧.csv) | ○ |
| C-03 | nameフィールドが必須で最低1文字 | E-02 (Zodスキーマ 15-16行目) | ○ |
| C-04 | handleフィールドが必須で最低1文字 | E-02 (Zodスキーマ 17行目) | ○ |
| C-05 | descriptionフィールドが任意 | E-02 (Zodスキーマ 18行目 z.optional()) | ○ |
| C-06 | statusがenum(active/inactive)である | E-02 (Zodスキーマ 19行目) | ○ |
| C-07 | visibilityがenum(public/internal)である | E-02 (Zodスキーマ 20行目) | ○ |
| C-08 | useUpdateProductCategoryでAPI呼び出し | E-02 (42行目), E-03 (111-131行目) | ○ |
| C-09 | 成功時にトースト通知を表示 | E-02 (54行目 toast.success) | ○ |
| C-10 | 失敗時にエラーをトーストで表示 | E-02 (58行目 toast.error) | ○ |
| C-11 | is_activeはstatus === "active"で変換 | E-02 (49行目) | ○ |
| C-12 | is_internalはvisibility === "internal"で変換 | E-02 (50行目) | ○ |
| C-13 | カテゴリ詳細画面から遷移する | E-07 (画面遷移図) | ○ |
| C-14 | 保存後にモーダルを閉じる | E-02 (55行目 handleSuccess) | ○ |
| C-15 | KeyboundFormでキーボード対応 | E-02 (66行目) | ○ |
| C-16 | useDocumentDirectionでRTL対応 | E-02 (30行目) | ○ |
| C-17 | react-hook-formでフォーム管理 | E-02 (3行目 import, 31行目 useForm) | ○ |
| C-18 | Zodでバリデーション | E-02 (5行目 import, 39行目 zodResolver) | ○ |
| C-19 | useParamsでカテゴリID取得 | E-01 (10行目) | ○ |
| C-20 | useProductCategoryでデータフェッチ | E-01 (13-15行目) | ○ |
| C-21 | エラー時に例外をスロー | E-01 (19-21行目) | ○ |
| C-22 | 関連機能が商品カテゴリ管理である | E-05 (画面機能マッピング.csv 57行目) | ○ |
| C-23 | キャンセルボタンでモーダルを閉じる | E-02 (191-195行目 RouteDrawer.Close) | ○ |
| C-24 | 更新成功時にクエリキャッシュを無効化 | E-03 (122-126行目) | ○ |
| C-25 | 権限による表示制御がある | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）
- 権限制御の詳細実装
  - 認証ミドルウェアの実装確認が必要
  - 候補：`packages/admin/dashboard/src/providers/` / `packages/medusa/src/api/middlewares/`

## 5) リスクフラグ（レビュー観点）
- 0: 低リスク - フォームフィールド定義、バリデーション
- 0: 低リスク - API呼び出し処理
- 1: 中リスク - 権限制御（認証は存在するが詳細未確認）
- 0: 低リスク - 画面遷移

## 6) レビュアーチェックリスト（最小）
- [ ] EditCategorySchemaのバリデーションルールが業務要件と一致しているか
- [ ] is_active/is_internalの変換ロジックが正しいか
- [ ] トースト通知のi18nキーが翻訳ファイルに存在するか
- [ ] 権限制御が適切に実装されているか（認証ミドルウェア確認）
- [ ] APIエンドポイントのレスポンス形式が想定と一致するか
