ITパスポート 2009年 秋期 問33

ソフトウェア詳細設計書に関する記述【ITパスポート 解説】

正解の理由

• ソフトウェア詳細設計書：プログラム単位で「どう作るか」を細かく書いた設計書。
• プログラミング：設計に基づいてコンピュータが実行するコードを書く作業。

解法ステップ

1. 問題文のキーワード「ソフトウェア詳細設計書」が何を意味するか確認する。
   → 「詳細設計」はコードに落とすための設計。
2. 各選択肢がどの開発工程（要件定義、基本設計、詳細設計、プログラミング、単体テスト、結合テストなど）に対応するかを当てはめる。
3. 「詳細設計」と「プログラミング」は前後関係が明確なので、それに合致する選択肢を選ぶ。
4. 最も妥当なのは「詳細設計に基づいてプログラミングが実施される」→ イ。

選択肢別の誤答解説

• ア: ソフトウェア詳細設計書には、システム結合テストのためのテスト仕様が含まれる。
  誤り。システム結合テスト（複数のサブシステムや外部システムをつなげて行うテスト）の仕様は、一般に「テスト仕様書」や「結合テスト仕様書」にまとめます。詳細設計は主にモジュール内部の作り方やインタフェース仕様を記載します。単体テストの項目が含まれることはありますが、結合テスト全体の仕様までは含めないのが普通です。
• イ: ソフトウェア詳細設計書に基づいてプログラミングが実施される。
  正解。詳細設計はプログラミングの直接の指針となる文書で、コードに落とすための具体的な仕様が書かれます。
• ウ: ソフトウェア詳細設計書は、システム要件定義の終了を契機として作成が開始される。
  誤り。システム要件定義（何を実現するかを決める工程）の終了後すぐに詳細設計が始まるとは限りません。一般的には要件定義→基本設計（外部設計）→詳細設計、という工程で進みます。基本設計で機能の構成や外部仕様を固めてから、詳細設計で内部設計を行います。
• エ: ソフトウェア詳細設計書は、将来のメンテナンス用として、単体テストが完了した後で完成させる。
  誤り。詳細設計書はプログラミング前に完成させるべき文書です。単体テスト（モジュールごとのテスト）で使う情報は詳細設計書に含まれることが多く、単体テスト完了後に初めて詳細設計書を作るのは順序が逆になります。メンテナンス用に更新することはありますが、完成時期の記述としては不適切です。

よくある誤解

1. 「詳細設計＝テスト仕様書」だと思う誤解
   → 詳細設計は主に実装（プログラミング）向けの仕様です。テスト仕様は別に作るのが一般的です。ただし、単体テスト項目（モジュールの入力や期待値）は詳細設計に記載されることがあります。
2. 「要件定義が終わったらすぐ詳細設計」だと思う誤解
   → 実務では要件定義の次に基本設計（外部設計）を行い、その上で詳細設計に入ります。段階を踏むことで全体の整合性を保ちます。
3. 「詳細設計はドキュメント化不要。プログラミングだけで良い」
   → アジャイルなどで設計書を軽くする場合もありますが、特に大きなシステムや保守が必要なシステムでは詳細設計は重要です。コードだけでなく文書化しておくと後の保守が楽になります。

補足コラム

• 要件定義（何を作るか）
  ↓
• 基本設計 / 外部設計（どう見えるか、システム全体の構成）
  ↓
• 詳細設計（どのモジュールがどう動くか。ここでプログラミングの材料が揃う）
  ↓
• プログラミング（コードを書く）
  ↓
• 単体テスト（モジュール単位の動作確認）
  ↓
• 結合テスト・システムテスト（モジュール間やシステム全体での検証）

FAQ