Home
Get Started
実践ガイド
外部仕様設計
バッチ処理仕様設計
UAC 仕様設計
データ仕様設計
インフラ設計
移行計画
テスト方針・計画
開発プロセス・規約
基本設計書 概要・目的
基本設計書の序盤で、システム全体像と本書の目的・位置づけを明示し、プロジェクト関係者全員が共通認識を持つための基盤を確立するセクションです。
🎯 概要
- 目的: 基本設計書の序盤で、システムの全体像と本書の目的・位置づけを示し、読者が以降の内容を正しく理解するための基盤を用意する。
- スコープ: システム概要(対象業務・課題・目的)、本書の目的と達成すること、対象読者をカバーする
- 推奨する実施タイミング: 基本設計の初期段階で作成し、設計の全体像が見えた時点で更新する
- 関連するステークホルダー: プロジェクトマネージャー、顧客担当者、システムアーキテクト、開発チーム全体
📥 重要な前提知識・インプット
- 前提知識: プロジェクトの背景、顧客の業務内容、要件定義で合意した内容の理解
- インプット: 要件定義書、提案書、契約書、プロジェクト計画書、顧客へのヒアリング結果
📄 成果物の定義
- ドキュメントテンプレート: 📄
[テンプレ]基本設計書 概要・目的
- 必須要素: システム概要、本書の目的、対象読者、前提条件・制約事項
✅ 品質基準・レビュー観点
✅ 品質チェックリスト:
| チェック項目 | チェック内容 |
|---|---|
| システム概要の明確性 | 対象業務、課題、目的が簡潔に記載されている |
| 本書の目的の明示 | 基本設計書で何を達成するか明記されている |
| 対象読者の特定 | 誰がこの文書を読むべきか列挙されている |
| 要件との整合性 | 要件定義書の内容と矛盾がない |
👁️🗨️ レビュー観点:
- 理解しやすさ: 初めて読む人でもシステムの全体像を把握できるか
- 要件との整合性: 要件定義で合意した内容と齟齬がないか
- ステークホルダーの網羅性: 関係者全員が対象読者に含まれているか
🧪成果物のサンプル
## 概要・目的
### システム概要
本システムは、[顧客名]様の[既存業務名]における[課題]を解決するため、[目的]を達成する[システム種別]である。
具体的には、[主要機能1]、[主要機能2]、[主要機能3]などの機能を提供し、[期待される効果]を実現する。
### 本書の目的
本書は、[システム名]のシステム方式および外部仕様を定義し、以下の目的を達成する。
- 要件の実現方式を明確にし、品質確保の基盤とする。
- [顧客名]-サンエム間で、システムの全体像と外部仕様に関する最終的な合意を形成する。
- 開発チーム内で、実装フェーズに進むための共通認識と具体的な指針を提供する。
### 対象読者
- 顧客担当者(業務部門、情報システム部門)
- プロジェクトマネージャー
- システムアーキテクト
- 開発リーダー、開発者
- テスト担当者
- 運用担当者
---
🔄 進め方・プロセス
📝 プロセス1: システム概要の記載
記載対象:
構築するシステムの全体像を簡潔に説明する。
具体例:
- 対象業務: どの業務領域を対象とするシステムか(例: 受注管理、在庫管理)
- 解決する課題: 現状のどのような課題を解決するのか
- システムの目的: 何を達成するためのシステムか
- 主要機能: システムが提供する主な機能(3〜5つ程度)
- 期待される効果: システム導入により得られる効果
記載原則:
- 簡潔性の確保: 専門用語を避け、誰が読んでも理解できる平易な表現を使う
- 要件定義との整合: 要件定義書で合意した内容と矛盾しないように記載する
- 読者を意識した粒度: 概要セクションでは詳細に立ち入らず、全体像の把握に必要な情報のみ記載する
文書化の推奨表現:
- 3〜5段落程度で簡潔にまとめる
- 箇条書きを活用して主要機能や期待効果を整理する
- 専門用語には必要に応じて補足説明を添える
📝 プロセス2: 本書の目的の明示
記載対象:
基本設計書が何を達成するための文書なのかを明確に示す。
具体例:
- 要件の実現方式を具体化する
- 顧客とサンエム間で、システムの全体像と外部仕様に関する合意を形成する
- 開発チームが実装フェーズに進むための具体的な指針を提供する
- 品質確保の基盤となる設計情報を文書化する
記載原則:
- 達成目標の明確化: 本書を通じて何を達成したいかを具体的に記載する
- ステークホルダーごとの価値: 顧客、開発チーム、運用チームなど、各ステークホルダーにとっての本書の価値を示す
- 後工程との連携: 後続の詳細設計・実装・テストにどう活用されるかを明記する
文書化の推奨表現:
- 箇条書きで3〜5項目程度列挙する
- 各項目は「〜を達成する」「〜を提供する」など、目的志向の表現にする
📝 プロセス3: 対象読者の特定
記載対象:
この基本設計書を読むべき関係者を列挙する。
具体例:
- 顧客担当者(業務部門、情報システム部門)
- プロジェクトマネージャー
- システムアーキテクト
- 開発リーダー、開発者
- テスト担当者
- 運用担当者
- 保守担当者
記載原則:
- 網羅性の確保: プロジェクトに関わる全ての主要ステークホルダーを列挙する
- 役割の明確化: 必要に応じて、各読者がどのような目的で本書を参照するかを補足する
- 漏れのない確認: プロジェクト体制図と照らし合わせ、主要な役割が漏れていないか確認する
文書化の推奨表現:
- 箇条書きで役割を列挙する
- 役割名は一般的な名称を使用し、個人名は記載しない
🚨 よくある失敗と予防策
🚧 実例収集後、追記予定
📚 参考資料・関連リンク
- 参考文献: 要件定義書、提案書、契約書
- 関連する他のガイド: 基本設計書とは?、基本設計のプロセス、基本設計書の完成条件
- ツール・テンプレート: 概要・目的セクションのテンプレート
テンプレートサイト: 📄テンプレート集