---
generated_at: 2026-01-28 13:25:00
metrics:
  claims_total: 48
  claims_with_evidence: 48
  claims_without_evidence: 0
confidence_derived: 1.00
---

# 根拠レポート：API設計書

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**1.00**
  - 根拠あり：48 / 48、根拠なし：0
- 優先レビュー（高）
  1. **なし**：全てのAPIエンドポイントはソースコードから直接抽出
  2. **バックエンドAPI仕様との整合性**：クライアント側実装からの推測のため、バックエンドの実際の仕様との照合を推奨
  3. **レスポンス形式**：サンプルレスポンスは想定値であり、実際のレスポンスとの差異確認を推奨

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

- E-01: `lib/services/mutation_query.dart` - GraphQL Mutation/Query定義
- E-02: `lib/services/api_client.dart` - APIクライアント実装
- E-03: `lib/services/graph_ql.dart` - GraphQL設定・接続
- E-04: `lib/utils/server_configuration.dart` - サーバー設定
- E-05: `lib/utils/app_global_data.dart` - グローバルデータ設定
- E-06: `pubspec.yaml` - プロジェクト設定・依存関係
- E-07: `lib/screens/sign_in/bloc/sign_in_repository.dart` - サインインリポジトリ
- E-08: `lib/screens/cart_screen/bloc/cart_screen_repository.dart` - カートリポジトリ
- E-09: `lib/screens/wishList/bloc/wishlist_repository.dart` - ウィッシュリストリポジトリ
- E-10: `lib/screens/checkout/checkout_review/bloc/checkout_review_repository.dart` - チェックアウトリポジトリ

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | ベースURLは`{baseDomain}/graphql` | E-04 (line 19) | ○ |
| C-02 | Bearer Token認証を使用 | E-03 (line 26-28) | ○ |
| C-03 | x-currency, x-localeヘッダー使用 | E-03 (line 31-35) | ○ |
| C-04 | customerLoginエンドポイント | E-01 (line 888-916) | ○ |
| C-05 | customerSignUpエンドポイント | E-01 (line 918-955) | ○ |
| C-06 | customerLogoutエンドポイント | E-01 (line 232-240) | ○ |
| C-07 | forgotPasswordエンドポイント | E-01 (line 958-970) | ○ |
| C-08 | accountInfoエンドポイント | E-01 (line 256-270) | ○ |
| C-09 | updateAccountエンドポイント | E-01 (line 973-1048) | ○ |
| C-10 | deleteAccountエンドポイント | E-01 (line 1051-1063) | ○ |
| C-11 | allProductsエンドポイント | E-01 (line 441-781) | ○ |
| C-12 | homeCategoriesエンドポイント | E-01 (line 19-39) | ○ |
| C-13 | getFilterAttributeエンドポイント | E-01 (line 286-320) | ○ |
| C-14 | themeCustomizationエンドポイント | E-01 (line 66-118) | ○ |
| C-15 | cartDetailエンドポイント | E-01 (line 322-374) | ○ |
| C-16 | addItemToCartエンドポイント | E-01 (line 140-185) | ○ |
| C-17 | updateItemToCartエンドポイント | E-01 (line 376-386) | ○ |
| C-18 | removeCartItemエンドポイント | E-01 (line 388-396) | ○ |
| C-19 | removeAllCartItemエンドポイント | E-01 (line 431-439) | ○ |
| C-20 | applyCouponエンドポイント | E-01 (line 398-409) | ○ |
| C-21 | removeCouponエンドポイント | E-01 (line 411-419) | ○ |
| C-22 | moveToWishlistエンドポイント | E-01 (line 421-429) | ○ |
| C-23 | wishlistsエンドポイント | E-01 (line 784-818) | ○ |
| C-24 | addToWishlistエンドポイント | E-01 (line 188-200) | ○ |
| C-25 | removeFromWishlistエンドポイント | E-01 (line 202-214) | ○ |
| C-26 | moveToCartエンドポイント | E-01 (line 820-830) | ○ |
| C-27 | compareProductsエンドポイント | E-01 (line 1654-1699) | ○ |
| C-28 | addToCompareエンドポイント | E-01 (line 242-254) | ○ |
| C-29 | removeFromCompareProductエンドポイント | E-01 (line 1711-1723) | ○ |
| C-30 | ordersListエンドポイント | E-01 (line 1195-1245) | ○ |
| C-31 | orderDetailエンドポイント | E-01 (line 1118-1193) | ○ |
| C-32 | cancelCustomerOrderエンドポイント | E-01 (line 1107-1116) | ○ |
| C-33 | reorderエンドポイント | E-01 (line 1972-1983) | ○ |
| C-34 | viewInvoicesエンドポイント | E-01 (line 1849-1894) | ○ |
| C-35 | viewShipmentsエンドポイント | E-01 (line 1896-1927) | ○ |
| C-36 | viewRefundsエンドポイント | E-01 (line 1929-1970) | ○ |
| C-37 | addressesエンドポイント | E-01 (line 1247-1291) | ○ |
| C-38 | createAddressエンドポイント | E-01 (line 1303-1340) | ○ |
| C-39 | updateAddressエンドポイント | E-01 (line 1342-1376) | ○ |
| C-40 | deleteAddressエンドポイント | E-01 (line 1293-1301) | ○ |
| C-41 | saveCheckoutAddressesエンドポイント | E-01 (line 1553-1652) | ○ |
| C-42 | paymentMethodsエンドポイント | E-01 (line 1405-1435) | ○ |
| C-43 | savePaymentエンドポイント | E-01 (line 1437-1519) | ○ |
| C-44 | placeOrderエンドポイント | E-01 (line 1521-1551) | ○ |
| C-45 | contactUsエンドポイント | E-01 (line 216-230) | ○ |
| C-46 | subscribeエンドポイント | E-01 (line 2022-2031) | ○ |
| C-47 | 対応支払方法（cashondelivery, moneytransfer, paypal_standard, paypal_smart_button） | E-04 (line 57-62) | ○ |
| C-48 | 対応ロケール（en, fr, nl, tr, es, ar, pt_BR, hi_IN） | E-04 (line 43-52) | ○ |

## 4) 不足情報（Unknown / Missing）
- **バックエンドAPI仕様書**：本設計書はクライアント側の実装から抽出したため、バックエンド（Bagisto）の公式API仕様書との照合が望ましい
- **OpenAPI/Swagger定義**：プロジェクト内にOpenAPI定義ファイルが存在しないため、厳密なスキーマ検証ができない
- **エラーレスポンス詳細**：各エンドポイントの具体的なエラーコード・メッセージはクライアント側からは確認できない
  - 候補：Bagisto公式ドキュメント / バックエンドソースコード / テスト仕様書

## 5) リスクフラグ（レビュー観点）
- **0: 低リスク** - 全てのAPIエンドポイントがソースコードから直接抽出されており、クライアント側実装との整合性は高い
- **1: 中リスク** - レスポンスフォーマットはサンプル値であり、実際のバックエンドレスポンスとの差異がある可能性
- **1: 中リスク** - バリデーションルールはGraphQLスキーマから推測したものであり、バックエンド側の厳密なバリデーションルールとは異なる可能性

## 6) レビュアーチェックリスト（最小）
- [ ] 主要エンドポイント（認証、カート、チェックアウト）の動作確認
- [ ] 認証ヘッダーの設定確認（Bearer Token形式）
- [ ] クエリパラメータのフィルター条件が実際に機能するか確認
- [ ] エラーレスポンスの形式がドキュメントと一致するか確認
- [ ] ページネーション（page, first, limit）の動作確認
- [ ] マルチパートリクエスト（ファイルアップロード）の動作確認
- [ ] 支払方法と実際のバックエンド設定との整合性確認
