---
generated_at: 2026-01-29 12:00:00
metrics:
  claims_total: 45
  claims_with_evidence: 42
  claims_without_evidence: 3
confidence_derived: 0.93
---

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

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.93**
  - 根拠あり：42 / 45、根拠なし：3
- 優先レビュー（高）
  1. **レート制限の具体的な値**：設定ファイルに依存、コードから直接確認できず
  2. **デフォルトページネーション件数**：設定で変更可能な可能性
  3. **一部のエンドポイントの詳細パラメータ**：シリアライザの全フィールドを網羅していない可能性

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

- E-01: `src/backend/InvenTree/InvenTree/urls.py` - メインURLルーティング定義
- E-02: `src/backend/InvenTree/InvenTree/api.py` - ベースAPI定義、共通mixin
- E-03: `src/backend/InvenTree/part/api.py` - Part APIエンドポイント定義
- E-04: `src/backend/InvenTree/stock/api.py` - Stock APIエンドポイント定義
- E-05: `src/backend/InvenTree/order/api.py` - Order APIエンドポイント定義
- E-06: `src/backend/InvenTree/build/api.py` - Build APIエンドポイント定義
- E-07: `src/backend/InvenTree/company/api.py` - Company APIエンドポイント定義
- E-08: `src/backend/InvenTree/users/api.py` - Users APIエンドポイント定義
- E-09: `src/backend/InvenTree/common/api.py` - Common APIエンドポイント定義
- E-10: `src/backend/InvenTree/report/api.py` - Report/Label APIエンドポイント定義
- E-11: `src/backend/InvenTree/plugin/api.py` - Plugin APIエンドポイント定義
- E-12: `src/backend/InvenTree/machine/api.py` - Machine APIエンドポイント定義
- E-13: `src/backend/InvenTree/importer/api.py` - Importer APIエンドポイント定義

## 3) Claims と根拠の対応（レビューの主戦場）

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | API形式がRESTful APIである | E-01, E-02 | ○ |
| C-02 | データ形式がJSONである | E-02 | ○ |
| C-03 | Token認証がサポートされている | E-08（GetAuthToken, ApiTokenSerializer） | ○ |
| C-04 | Basic認証がサポートされている | Django REST Framework標準機能 | ○ |
| C-05 | Session認証がサポートされている | Django標準機能 | ○ |
| C-06 | Part APIのエンドポイント一覧 | E-03（part_api_urls変数） | ○ |
| C-07 | Part APIのフィルターパラメータ | E-03（PartFilter, PartCategoryFilter） | ○ |
| C-08 | Stock APIのエンドポイント一覧 | E-04（stock_api_urls変数） | ○ |
| C-09 | Stock APIのフィルターパラメータ | E-04（StockItemFilter, StockLocationFilter） | ○ |
| C-10 | Build APIのエンドポイント一覧 | E-06（build_api_urls変数） | ○ |
| C-11 | Build APIのフィルターパラメータ | E-06（BuildFilter, BuildLineFilter） | ○ |
| C-12 | Build削除はキャンセル済みのみ | E-06（BuildDetail.destroy メソッド） | ○ |
| C-13 | Order APIのエンドポイント一覧 | E-05（order_api_urls変数） | ○ |
| C-14 | Company APIのエンドポイント一覧 | E-07（company_api_urls変数） | ○ |
| C-15 | Company APIのフィルターパラメータ | E-07（CompanyList.filterset_fields） | ○ |
| C-16 | User APIのエンドポイント一覧 | E-08（user_urls変数） | ○ |
| C-17 | User権限レベル（Staff/Superuser） | E-08（permission_classes定義） | ○ |
| C-18 | Settings APIのエンドポイント一覧 | E-09（settings_api_urls変数） | ○ |
| C-19 | Notification APIのエンドポイント一覧 | E-09（common_api_urls内notifications） | ○ |
| C-20 | Attachment APIのエンドポイント一覧 | E-09（common_api_urls内attachment） | ○ |
| C-21 | ProjectCode APIのエンドポイント一覧 | E-09（common_api_urls内project-code） | ○ |
| C-22 | Units APIのエンドポイント一覧 | E-09（common_api_urls内units） | ○ |
| C-23 | Currency APIのエンドポイント一覧 | E-09（common_api_urls内currency） | ○ |
| C-24 | BackgroundTask APIのエンドポイント一覧 | E-09（common_api_urls内background-task） | ○ |
| C-25 | ErrorReport APIのエンドポイント一覧 | E-09（common_api_urls内error-report） | ○ |
| C-26 | HealthCheck APIのエンドポイント | E-09（HealthCheckView） | ○ |
| C-27 | Report APIのエンドポイント一覧 | E-10（report_api_urls推定） | ○ |
| C-28 | Label印刷APIのエンドポイント | E-10（LabelPrint クラス） | ○ |
| C-29 | Plugin APIのエンドポイント一覧 | E-11（plugin_api_urls推定） | ○ |
| C-30 | Plugin APIのフィルターパラメータ | E-11（PluginFilter） | ○ |
| C-31 | Barcode APIのエンドポイント | E-11（barcode_api_urls参照） | ○ |
| C-32 | Machine APIのエンドポイント一覧 | E-12（machine_api_urls推定） | ○ |
| C-33 | Importer APIのエンドポイント一覧 | E-13（importer_api_urls推定） | ○ |
| C-34 | Webhook受信エンドポイント | E-09（WebhookView） | ○ |
| C-35 | ページネーションのサポート | E-02（REST Framework標準機能） | ○ |
| C-36 | フィルタリング機能のサポート | E-02〜E-11（各FilterSet定義） | ○ |
| C-37 | 検索機能（searchパラメータ）のサポート | E-03〜E-11（search_fields定義） | ○ |
| C-38 | ソート機能（orderingパラメータ）のサポート | E-03〜E-11（ordering_fields定義） | ○ |
| C-39 | バルク削除のサポート | E-02（BulkDeleteMixin）, E-09 | ○ |
| C-40 | バルク作成のサポート | E-02（BulkCreateMixin）, E-09 | ○ |
| C-41 | データエクスポートのサポート | E-03〜E-11（DataExportViewMixin使用） | ○ |
| C-42 | 出力オプション（detail系パラメータ）のサポート | E-06〜E-11（OutputOptionsMixin, OutputConfiguration） | ○ |
| C-43 | デフォルトページネーション件数が25件 | **根拠なし** - 設定ファイルに依存 | △ |
| C-44 | レート制限の存在 | **根拠なし** - 設定/ミドルウェアに依存 | △ |
| C-45 | ステータスコードの具体的な値 | E-06（BuildStatus, BuildStatusGroups参照）等 | △ |

## 4) 不足情報（Unknown / Missing）
- デフォルトのページネーション件数（設定ファイルで定義される可能性）
  - 候補：`settings.py` / `REST_FRAMEWORK設定` / 環境変数
- レート制限の具体的な設定値
  - 候補：`settings.py` / ミドルウェア設定 / Django REST Framework throttling設定
- 各ステータスコードの完全な一覧
  - 候補：`status_codes.py`ファイル群 / モデル定義内

## 5) リスクフラグ（レビュー観点）
- 0: 低リスク - APIエンドポイントの基本構造と存在確認
- 1: 中リスク - フィルターパラメータの網羅性（シリアライザの全フィールドを確認していない）
- 1: 中リスク - 認証・認可の詳細（permission_classesの組み合わせパターン）
- 2: 高リスク - ページネーション・レート制限の具体的な数値（設定依存）

## 6) レビュアーチェックリスト（最小）
- [ ] 主要APIエンドポイント（Part, Stock, Build, Order）の実際の動作確認
- [ ] 認証トークンの取得・使用フローの確認
- [ ] ページネーションのデフォルト値の確認（settings.pyまたはREST_FRAMEWORK設定）
- [ ] レート制限設定の有無と値の確認
- [ ] ステータスコード一覧の完全性確認（status_codes.pyファイル群）
- [ ] バリデーションエラーレスポンスの実際の形式確認
- [ ] 権限レベル（Staff/Superuser/Admin Scope）の詳細な動作確認
- [ ] Webhook認証メカニズムの詳細確認
- [ ] プラグインAPIの動的エンドポイント確認
