基本設計書のレビュー

Home

📕Arrow icon of a page linkサンエムシステム 上流工程標準(Preview版)

⚖️Arrow icon of a page linkサンエムシステム上流工程 標準規格

📘Arrow icon of a page link要件定義 実践ガイド

📘Arrow icon of a page link基本設計 実践ガイド

📄Arrow icon of a page linkテンプレート集

Get Started

📄Arrow icon of a page link基本設計工程のルール

📄Arrow icon of a page link基本設計書の構成を決める

🚧Arrow icon of a page link基本設計のプロセスモデル

実践ガイド

文書情報
システム方式設計
外部仕様設計
運用設計
インフラ設計
移行計画
テスト方針・計画
開発プロセス・規約
レビュー・承認

基本設計書のレビュー

基本設計書の品質を体系的に検証し、設計上の問題や不整合を早期に発見・是正するためのレビュープロセスを定義します。

🎯 概要


  • 目的: 基本設計書の品質を体系的に検証し、設計上の問題や不整合を早期に発見・是正することで、後工程でのリスクを低減する
  • スコープ: 基本設計書の技術レビュー、セキュリティレビュー、品質レビュー、ステークホルダーレビューを対象とする。レビュー計画、実施、指摘事項管理、承認までのプロセス全体を含む
  • 推奨する実施タイミング: 各章の完成時、全体完成時、承認申請前の段階的なレビューを実施する
  • 関連するステークホルダー: プロジェクトマネージャー、設計担当者、アーキテクト、セキュリティ担当、QA担当、レビュアー、承認者

📥 重要な前提知識・インプット


  • 前提知識: レビュー技法の基本、設計ドキュメントの読解力、技術アーキテクチャの理解、セキュリティ・品質の基礎知識
  • インプット: 完成した基本設計書、要件定義書、非機能要件仕様書、レビューチェックリスト、プロジェクトの品質基準

📄 成果物の定義


  • ドキュメントテンプレート: 📄Arrow icon of a page link[テンプレ]レビュー履歴
  • 必須要素: レビュー記録表(レビューNo、実施日、レビュー種別、レビュー対象、レビュアー、指摘件数、ステータス)、指摘事項管理表(指摘ID、指摘内容、重要度、対応内容、対応者、対応日、ステータス)
✅ 品質基準・レビュー観点

品質チェックリスト:

チェック項目 チェック内容
レビュー計画の妥当性 適切なレビュー種別とタイミングが設定されている
レビュアーの適格性 各レビュー種別に対して適切な専門性を持つレビュアーがアサインされている
指摘事項の網羅性 技術、セキュリティ、品質、ビジネス要件の観点から漏れなく検証されている
対応状況の追跡 すべての指摘事項に対する対応状況が記録され、未対応項目が明確になっている

👁️‍🗨️ レビュー観点:

  • 設計の完全性: 要件定義で定義されたすべての要件が基本設計でカバーされているか
  • 技術的妥当性: 技術選定、アーキテクチャ設計、パフォーマンス設計が適切か
  • セキュリティ: セキュリティ要件が充足され、脆弱性リスクが適切に管理されているか
  • 整合性: 各章間、要件定義との間で矛盾や不整合がないか
  • 実現可能性: 設計内容が技術的・コスト的・スケジュール的に実現可能か
  • 保守性: 将来の変更や拡張に対応しやすい設計になっているか
🧪成果物のサンプル
# レビュー履歴

設計書がどのようなプロセスを経て検証され、改善されてきたかを記録し、その品質保証プロセスを可視化することを目的とします。

## レビュー記録テーブル

| レビューNo | 実施日 | レビュー種別 | レビュー対象 | レビュアー | 指摘件数 | ステータス |
|-----------|--------|------------|------------|----------|---------|----------|
| REV-001 | 2025-12-01 | 技術レビュー | 2章:システム方式設計 | 山田太郎(アーキテクト) | 5 | 完了 |
| REV-002 | 2025-12-05 | セキュリティレビュー | 5章:インフラ設計 | 佐藤花子(セキュリティ) | 3 | 完了 |
| REV-003 | 2025-12-08 | 品質レビュー | 全体 | 鈴木一郎(QAリード) | 7 | 対応中 |

## レビュー指摘事項の管理

- レビュー指摘事項詳細: [レビュー指摘事項一覧.xlsx](reviews/レビュー指摘事項一覧.xlsx)

**指摘事項の記録例**:

| 指摘ID | レビューNo || 指摘内容 | 重要度 | 対応内容 | 対応者 | 対応日 | ステータス |
|-------|-----------|---|---------|-------|---------|-------|--------|----------|
| ISS-001 | REV-001 | 2.1 | 冗長化構成の詳細が不足 || 冗長化の構成図を追加 | 田中 | 2025-12-02 | 完了 |
| ISS-002 | REV-001 | 2.3 | APIのバージョニング戦略が未定義 || バージョニングポリシーを追加 | 高橋 | 2025-12-03 | 完了 |
| ISS-003 | REV-002 | 5.2 | ネットワークセグメント分離が不十分 || セグメント構成を見直し | 伊藤 | 2025-12-06 | 完了 |
| ISS-004 | REV-003 | 4.1 | データモデルの正規化レベル要確認 || 正規化の根拠を追記 | 渡辺 | - | 対応中 |

**重要度の定義**:
- ****: 設計の根幹に関わる、対応必須の指摘
- ****: 品質向上のため対応が望ましい指摘
- ****: 参考情報、必要に応じて対応

## レビュープロセスフロー

```mermaid
graph TB
    A[設計書作成] --> B[レビュー依頼]
    B --> C{レビュー種別}
    
    C -->|技術レビュー| D[アーキテクト確認]
    C -->|セキュリティレビュー| E[セキュリティ担当確認]
    C -->|品質レビュー| F[QA担当確認]
    
    D --> G[指摘事項登録]
    E --> G
    F --> G
    
    G --> H{指摘あり?}
    H -->|Yes| I[対応実施]
    H -->|No| J[レビュー完了]
    
    I --> K[対応内容レビュー]
    K --> L{承認?}
    L -->|Yes| J
    L -->|No| I
    
    J --> M[次工程へ]
```

## レビュー種別と実施タイミング

| レビュー種別 | 実施タイミング | 主なチェック項目 | 参加者 |
|------------|--------------|----------------|-------|
| 技術レビュー | 各章完成時 | ・技術選定の妥当性<br>・アーキテクチャの整合性<br>・パフォーマンス要件の充足 | アーキテクト、テックリード |
| セキュリティレビュー | インフラ設計完成時 | ・セキュリティ要件の充足<br>・脆弱性リスク<br>・認証認可の設計 | セキュリティ担当、インフラ担当 |
| 品質レビュー | 全体完成時 | ・ドキュメント品質<br>・テスト方針の妥当性<br>・非機能要件の充足 | QAリード、プロジェクトマネージャー |
| ステークホルダーレビュー | 承認前 | ・ビジネス要件との整合性<br>・コスト・スケジュール<br>・リスク評価 | プロダクトオーナー、事業責任者 |

---

🔄 設計の進め方・プロセス


📝 プロセス1: レビュー計画の策定

実施内容:

基本設計書の完成状況に応じて、適切なレビュー種別、タイミング、レビュアーを計画する。

具体例:

  • 技術レビュー: 各章(システム方式設計、データ設計など)の完成時にアーキテクトやテックリードによるレビューを実施
  • セキュリティレビュー: インフラ設計、セキュリティ仕様の完成時にセキュリティ担当者によるレビューを実施
  • 品質レビュー: 全体完成時にQA担当者によるドキュメント品質とテスト方針のレビューを実施
  • ステークホルダーレビュー: 承認申請前にプロダクトオーナーや事業責任者によるビジネス整合性のレビューを実施

計画のポイント:

  • 段階的なレビュー: 一度にすべてをレビューせず、章単位で段階的に実施することで早期に問題を発見
  • 適切なレビュアーの選定: 各レビュー種別に対して適切な専門性を持つレビュアーをアサイン
  • レビュー期間の確保: レビュアーが十分に検証できる時間を確保し、スケジュールに組み込む

文書化の推奨表現:

  • レビュー計画表を作成し、レビュー種別、対象、レビュアー、予定日を明記
  • レビュー観点やチェックリストを事前に準備し、レビュアーに共有
📝 プロセス2: レビューの実施と指摘事項の記録

実施内容:

計画に従ってレビューを実施し、レビュアーからの指摘事項を体系的に記録する。

具体例:

  • レビュー会議を開催し、基本設計書の内容をレビュアーと共に確認
  • レビュアーからの指摘事項を「指摘事項管理表」に記録(指摘ID、章、指摘内容、重要度、対応者を明記)
  • レビュー記録表に実施日、レビュアー、指摘件数、ステータスを記録

記録のポイント:

  • 指摘内容の具体化: 指摘内容を具体的に記録し、対応者が何を修正すべきか明確にする
  • 重要度の設定: 高(対応必須)、中(対応推奨)、低(参考)などの重要度を設定し、優先順位を明確化
  • トレーサビリティの確保: 指摘IDを付与し、どのレビューでどの指摘が出たかを追跡可能にする

文書化の推奨表現:

  • 指摘事項管理表に指摘内容、重要度、対応内容、対応者、対応日、ステータスを記録
  • レビュー記録表でレビュー全体のサマリーを管理
📝 プロセス3: 指摘事項への対応と再レビュー

実施内容:

記録された指摘事項に対して設計担当者が対応を実施し、対応内容をレビュアーが再確認する。

具体例:

  • 高重要度の指摘から優先的に対応し、設計書を修正
  • 対応内容を指摘事項管理表に記録し、対応日とステータスを更新
  • 対応完了後、レビュアーに再確認を依頼し、承認を得る

対応のポイント:

  • 迅速な対応: 指摘事項を放置せず、計画的に対応を進める
  • 対応内容の明確化: どのように修正したかを具体的に記録し、レビュアーが確認しやすくする
  • 未対応項目の管理: 対応中・未対応の項目を明確にし、進捗を可視化する

文書化の推奨表現:

  • 対応内容の欄に具体的な修正内容や追加した情報を記載
  • 対応完了時にステータスを「完了」に更新し、対応日を記録
📝 プロセス4: レビュー完了の記録

実施内容:

すべての指摘事項への対応が完了し、レビュアーからの承認を得た後、正式な完了手続きを実施する。

具体例:

  • すべての高・中重要度の指摘事項が「完了」ステータスになっていることを確認
  • レビュー記録表のステータスを「完了」に更新

承認のポイント:

  • 完了基準の明確化: どの条件を満たせばレビュー完了とするかを事前に定義(全指摘対応完了、など)

文書化の推奨表現:

  • レビュー完了報告書を作成し、レビュー実施状況、指摘件数、対応状況をサマリー

🚨 よくある失敗と予防策 


🚧 実例収集後、追記予定

📚 参考資料・関連リンク


  • 参考文献: レビュー技法ガイド、ソフトウェアインスペクション標準、プロジェクトの品質管理規約
  • 関連する他のガイド: 基本設計書 改訂履歴、品質チェックリスト、要件トレーサビリティマトリクス、テスト計画書
  • ツール・テンプレート: レビュー記録テンプレート、指摘事項管理表テンプレート、レビューチェックリスト


テンプレートサイト: 📄Arrow icon of a page linkテンプレート集