---
generated_at: 2026-01-29 15:45:00
metrics:
  claims_total: 42
  claims_with_evidence: 38
  claims_without_evidence: 4
confidence_derived: 0.90
---

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

## 本レポートについて

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

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

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

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

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

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.90**
  - 根拠あり：38 / 42、根拠なし：4
- 優先レビュー（高）
  1. **サーバースペック推奨値**：本番環境の推奨スペックは公式ドキュメントに基づく推測
  2. **RTO目標値**：フェイルオーバー時間は一般的な目安値であり、実測値ではない
  3. **バックアップ保持期間**：組織のポリシーに依存する推奨値
  4. **監視アラート閾値**：一般的なベストプラクティスに基づく推奨値

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

- E-01: `compose.yaml`（Docker Compose設定）
- E-02: `composer.json`（PHP依存関係・バージョン要件）
- E-03: `src/Core/Framework/Resources/config/packages/framework.yaml`（Symfonyフレームワーク設定）
- E-04: `src/Core/Framework/Resources/config/packages/shopware.yaml`（Shopwareコア設定）
- E-05: `src/Elasticsearch/Resources/config/packages/elasticsearch.yaml`（OpenSearch設定）
- E-06: `src/Core/Framework/Resources/config/packages/prod/monolog.yaml`（本番ログ設定）
- E-07: `src/Core/Framework/Resources/config/packages/feature.yaml`（フィーチャーフラグ設定）
- E-08: `config/bundles.php`（Symfonyバンドル設定）
- E-09: `public/index.php`（エントリーポイント）
- E-10: `http-client.env.json`（HTTPクライアント環境設定）

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | WebサーバーはCaddy（開発環境）を使用 | E-01 | ○ |
| C-02 | PHP 8.2-8.5をサポート | E-02 | ○ |
| C-03 | Symfony 7.4ベースで動作 | E-02 | ○ |
| C-04 | MariaDB/MySQLをデータベースとして使用 | E-01 | ○ |
| C-05 | OpenSearch 2.xを検索エンジンとして使用 | E-01, E-05 | ○ |
| C-06 | Valkey（Redis互換）をキャッシュとして使用 | E-01 | ○ |
| C-07 | ポート8000でHTTPサービスを提供 | E-01 | ○ |
| C-08 | ポート5173でVite HMRを提供 | E-01 | ○ |
| C-09 | ポート3306でMariaDBに接続 | E-01 | ○ |
| C-10 | InnoDB Buffer Pool 1GBを設定 | E-01 | ○ |
| C-11 | バイナリログキャッシュ16MBを設定 | E-01 | ○ |
| C-12 | バイナリログ最大512MB、有効期限24時間 | E-01 | ○ |
| C-13 | OpenSearchシャード数3、レプリカ数3（管理画面） | E-05 | ○ |
| C-14 | Valkeyは揮発性LFUポリシーを使用 | E-01 | ○ |
| C-15 | ヘルスチェック設定が存在 | E-01 | ○ |
| C-16 | Doctrine Messengerをデフォルトで使用 | E-03 | ○ |
| C-17 | メッセージリトライは最大3回、遅延1000ms | E-03 | ○ |
| C-18 | asyncとlow_priorityの2つのトランスポートが存在 | E-03 | ○ |
| C-19 | レートリミッターがログイン等に設定 | E-04 | ○ |
| C-20 | Blue-Greenデプロイメントが環境変数で制御可能 | E-04 | ○ |
| C-21 | ログローテーションは14日分保持 | E-04 | ○ |
| C-22 | HTTPキャッシュポリシーが設定可能 | E-04 | ○ |
| C-23 | Varnish/Fastlyとのリバースプロキシ連携が可能 | E-04 | ○ |
| C-24 | S3/GCSストレージがオプションで利用可能 | E-02, E-04 | ○ |
| C-25 | Monologでfinger_crossed handlerを使用 | E-06 | ○ |
| C-26 | 本番環境ではerrorレベル以上のログを出力 | E-06 | ○ |
| C-27 | OpenTelemetryメトリクスがフィーチャーフラグで有効化可能 | E-07 | ○ |
| C-28 | CACHE_REWORKフラグで新キャッシュ機能が有効化可能 | E-07 | ○ |
| C-29 | PHP必須拡張としてcurl, dom, gd等が必要 | E-02 | ○ |
| C-30 | APP_URL環境変数でアプリケーションURLを設定 | E-01, E-04 | ○ |
| C-31 | DATABASE_URL環境変数でDB接続を設定 | E-01 | ○ |
| C-32 | MAILER_DSN環境変数でメール配信を設定 | E-01, E-03 | ○ |
| C-33 | LOCK_DSN環境変数で分散ロックを設定 | E-03 | ○ |
| C-34 | Dockerイメージとしてghcr.io/shopware/docker-devを使用 | E-01 | ○ |
| C-35 | Adminerがデータベース管理UIとして利用可能 | E-01 | ○ |
| C-36 | Mailpitが開発環境のメールテストに利用 | E-01 | ○ |
| C-37 | OAuth2認証が利用可能 | E-02, E-10 | ○ |
| C-38 | OpenSearchのタイムアウトは5秒 | E-05 | ○ |
| C-39 | サーバースペック推奨値（CPU、メモリ） | **根拠なし** | △ |
| C-40 | フェイルオーバーRTO目標（30秒以内等） | **根拠なし** | △ |
| C-41 | バックアップ保持期間（30日、90日等） | **根拠なし** | △ |
| C-42 | 監視アラート閾値（CPU80%、メモリ85%等） | **根拠なし** | △ |

## 4) 不足情報（Unknown / Missing）
- **サーバースペック推奨値**
  - 理由：コードベースにはサーバースペックの要件定義が含まれていない
  - 候補：Shopware公式ドキュメント / システム要件ページ / パフォーマンスガイド
- **フェイルオーバーRTO目標**
  - 理由：可用性に関するSLA定義がコードベースに存在しない
  - 候補：運用マニュアル / SLA文書 / 障害対応手順書
- **バックアップ保持期間**
  - 理由：バックアップポリシーは組織固有の要件であり、コードには含まれない
  - 候補：バックアップ運用手順書 / データ保持ポリシー
- **監視アラート閾値**
  - 理由：監視設定は外部監視システムで管理され、コードには含まれない
  - 候補：監視設定ファイル / Prometheus/Grafana設定 / 運用手順書

## 5) リスクフラグ（レビュー観点）
- **リスクレベル0（低リスク）**：コンテナ構成、環境変数、ミドルウェアバージョン
  - コードから直接確認可能な情報
- **リスクレベル1（中リスク）**：スケーリング設計、キャッシュ設計
  - 設定ファイルから推測可能だが、実際の運用パラメータは環境依存
- **リスクレベル2（高リスク）**：サーバースペック、RTO目標、バックアップ保持期間、監視閾値
  - コードベースに根拠がなく、組織のポリシーや公式ドキュメントの確認が必要

## 6) レビュアーチェックリスト（最小）
- [ ] サーバースペック推奨値が組織の要件と整合しているか確認
- [ ] フェイルオーバーRTO目標が運用SLAと整合しているか確認
- [ ] バックアップ保持期間がデータ保持ポリシーと整合しているか確認
- [ ] 監視アラート閾値が運用チームの基準と整合しているか確認
- [ ] 本番環境でのNginx/Apache設定が適切に考慮されているか確認
- [ ] SSL/TLS設定の要件が満たされているか確認
- [ ] シークレット管理方式（Vault等）の選定が適切か確認
- [ ] OpenSearchクラスター構成が可用性要件を満たすか確認
