---
generated_at: 2026-02-24 22:45:00
metrics:
  claims_total: 35
  claims_with_evidence: 30
  claims_without_evidence: 5
confidence_derived: 0.86
---

# 根拠レポート：インフラ設計書

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.86**
  - 根拠あり：30 / 35、根拠なし：5
- 優先レビュー（高）
  1. **サーバースペック推奨値**：具体的なスペック要件はコードから特定不可
  2. **バックアップ設計**：バックアップ方針はコードに明示されていない
  3. **監視項目詳細**：監視項目の具体的な閾値はコードに定義なし
  4. **可用性設計のSLA**：SLA要件はコードから特定不可
  5. **ネットワーク構成のポート**：デフォルトポート以外の設定例はコードに明示なし

## 2) 参照した情報（Evidence一覧）

- E-01: `package.json` (root)
- E-02: `packages/medusa/package.json`
- E-03: `packages/core/framework/package.json`
- E-04: `packages/core/framework/src/config/config.ts`
- E-05: `packages/core/framework/src/telemetry/index.ts`
- E-06: `packages/core/framework/src/logger/index.ts`
- E-07: `packages/modules/cache-redis/package.json`
- E-08: `packages/modules/event-bus-redis/package.json`
- E-09: `packages/modules/workflow-engine-inmemory/package.json`
- E-10: `packages/modules/providers/file-s3/package.json`
- E-11: `packages/modules/providers/payment-stripe/package.json`
- E-12: `packages/modules/providers/notification-sendgrid/package.json`
- E-13: `packages/modules/providers/analytics-posthog/package.json`
- E-14: `packages/modules/auth/package.json`
- E-15: `packages/admin/dashboard/package.json`
- E-16: `integration-tests/.env.test`
- E-17: `integration-tests/http/medusa-config.js`
- E-18: `CLAUDE.md` (プロジェクト説明)

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

| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | Node.js 20以上が必要 | E-02, E-03 (`"engines": {"node": ">=20"}`) | ○ |
| C-02 | Express.js ^4.21.0を使用 | E-02, E-03 (dependencies) | ○ |
| C-03 | PostgreSQLがメインDBとして使用される | E-04, E-16, E-17 (DATABASE_URL設定) | ○ |
| C-04 | Redisがキャッシュ・イベントバス・ワークフローに使用 | E-04, E-07, E-08 (redis関連モジュール) | ○ |
| C-05 | MikroORMをORMとして使用 | E-03 (mikro-orm依存) | ○ |
| C-06 | ioredis ^5.4.1を使用 | E-03, E-07, E-08 (dependencies) | ○ |
| C-07 | BullMQ 5.13.0をジョブキューとして使用 | E-08 (dependencies: "bullmq": "5.13.0") | ○ |
| C-08 | Stripeを決済プロバイダーとして使用 | E-11 (stripe ^15.5.0) | ○ |
| C-09 | SendGridを通知プロバイダーとして使用 | E-12 (@sendgrid/mail ^8.1.6) | ○ |
| C-10 | AWS S3をファイルストレージとして使用可能 | E-10 (@aws-sdk/client-s3 ^3.556.0) | ○ |
| C-11 | PostHogをアナリティクスとして使用可能 | E-13 (posthog-node ^5.11.0) | ○ |
| C-12 | JWT認証を使用 | E-02, E-03 (jsonwebtoken ^9.0.2) | ○ |
| C-13 | OpenTelemetryによるトレーシング対応 | E-03, E-05 (opentelemetry関連モジュール) | ○ |
| C-14 | Admin DashboardはReact SPAである | E-15 (react ^18.3.1, react-dom) | ○ |
| C-15 | Yarn 3.2.1がパッケージマネージャー | E-01 ("packageManager": "yarn@3.2.1") | ○ |
| C-16 | 30以上のモジュラーコマースパッケージ | E-18 (CLAUDE.md記載), E-02 (dependencies) | ○ |
| C-17 | ワーカーモードはshared/worker/serverの3種類 | E-04 (workerModes配列) | ○ |
| C-18 | jwtExpiresInのデフォルトは1日 | E-04 (`http.jwtExpiresIn = http?.jwtExpiresIn ?? "1d"`) | ○ |
| C-19 | 認証プロバイダーとしてGitHub/Googleをサポート | E-02 (@medusajs/auth-github, @medusajs/auth-google) | ○ |
| C-20 | connect-redisでセッション管理 | E-03 ("connect-redis": "5.2.0") | ○ |
| C-21 | connect-dynamodbもセッションストアとして使用可能 | E-03 ("connect-dynamodb": "^3.0.5") | ○ |
| C-22 | compressionミドルウェアを使用 | E-02, E-03 ("compression": "^1.8.0") | ○ |
| C-23 | corsミドルウェアを使用 | E-03 ("cors": "^2.8.5") | ○ |
| C-24 | multerでファイルアップロード処理 | E-02 ("multer": "^2.0.2") | ○ |
| C-25 | RBACはフィーチャーフラグで有効化 | E-02, E-17 (MEDUSA_FF_RBAC) | ○ |
| C-26 | cron-parserによるスケジュール管理 | E-09 ("cron-parser": "^4.9.0") | ○ |
| C-27 | TypeScript 5.6.2+を使用 | E-01 ("typescript": "^5.6.2") | ○ |
| C-28 | Jest 29.7.0をテストフレームワークとして使用 | E-01 ("jest": "^29.7.0") | ○ |
| C-29 | Vitest 3.0.5をAdmin Dashboardのテストに使用 | E-01 ("vitest": "^3.0.5") | ○ |
| C-30 | Turboをビルドツールとして使用 | E-01 ("turbo": "^1.6.3") | ○ |
| C-31 | 推奨サーバースペック: 2vCPU/4GB RAM以上 | **根拠なし** | △ |
| C-32 | PostgreSQLのバックアップは日次フルバックアップ推奨 | **根拠なし** | △ |
| C-33 | Redisのバックアップ保持期間は7日以上推奨 | **根拠なし** | △ |
| C-34 | APIサーバーのデフォルトポートは9000 | **根拠不明** | △ |
| C-35 | ファイルストレージのバックアップ保持期間は90日以上推奨 | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）

- **サーバースペック要件**: コードベースに具体的なスペック要件の定義なし
  - 候補: Medusa公式ドキュメント / デプロイメントガイド / パフォーマンステスト結果

- **バックアップポリシー**: バックアップ方針・保持期間の定義がコードに存在しない
  - 候補: 運用マニュアル / インフラ運用ドキュメント / クラウドプロバイダー推奨設定

- **ネットワークポート設定**: デフォルトポートの明示的な定義が見つからなかった
  - 候補: Express.jsサーバー設定ファイル / 環境変数定義 / デプロイメント設定

- **監視閾値**: 監視項目の具体的な閾値設定がコードに存在しない
  - 候補: 監視設定ファイル / アラート定義 / SRE運用ドキュメント

- **SLA定義**: 可用性目標・復旧時間目標の定義なし
  - 候補: SLA文書 / サービスレベル定義書

## 5) リスクフラグ（レビュー観点）

| 項目 | リスクレベル | 説明 |
|---|---|---|
| サーバースペック推奨値 | 1: 中リスク | 一般的な推奨値として記載したが、実際のワークロードに応じた検証が必要 |
| バックアップ設計 | 2: 高リスク | 運用上重要だがコードから特定できないため、実際の運用方針との整合性確認が必要 |
| ネットワーク構成 | 0: 低リスク | 一般的なWebアプリケーション構成として妥当 |
| 監視設計 | 1: 中リスク | OpenTelemetry対応は確認済みだが、具体的な監視項目・閾値は環境依存 |
| セキュリティ構成 | 0: 低リスク | JWT認証、CORS、セッション管理などの実装はコードで確認済み |

## 6) レビュアーチェックリスト（最小）

- [ ] サーバースペック推奨値が実際のワークロードに適切か確認
- [ ] バックアップ設計が組織のRPO/RTO要件を満たすか確認
- [ ] ネットワーク構成（ポート番号、CORS設定）が実際の環境と一致するか確認
- [ ] 監視項目が運用要件を満たすか確認
- [ ] セキュリティ構成（JWT有効期限、シークレット管理）が組織のポリシーに適合するか確認
- [ ] 外部サービス連携（Stripe、SendGrid等）の契約・設定状況を確認
- [ ] 本番環境でのRedis設定が適切か（インメモリ実装ではないこと）確認
- [ ] フィーチャーフラグの有効/無効設定が意図通りか確認
