詳細設計
(しょうさいせっけい/Detailed Design)
- 起点・背景(海外)
- 1988年
- 更新
- 2026-11-12
一言でいうと
基本設計で決めた仕様を、処理の手順、モジュール(機能のまとまり)の分け方、データ構造など、実装に取りかかれる粒度まで具体化する工程です。たとえば注文の受付なら、在庫の確認、金額の計算、注文データの保存をどの部品がどの順で担い、失敗時にどう扱うかまで設計します。内部設計とも呼ばれます。
設計経験を採用要件の打ち合わせで扱う際は、処理手順・モジュール構成・データ構造のうち、実装できる粒度まで具体化してほしい対象を整理します。
提唱者と登場年
英語のDetailed Designは、米国国防総省が1988年に発行したソフトウェア開発の規格DOD-STD-2167Aに工程として規定されています。この規格では、構成要素を小さな単位(ユニット)に分けて設計上の要件を定め、段階の終わりに審査を行います。規格の工程区分は国内の詳細設計と一対一に対応するとは限らず、起点の一つとして示します。
国内では、独立行政法人情報処理推進機構が2020年12月に公開した「情報システム・モデル取引・契約書」第二版が、内部設計を「共通フレーム2013のシステム方式の確立、システム方式の評価及びレビューに相当するもの」と定義しています。何を詳細設計に含めるかは組織や契約によって異なるため、この定義も工程の対応関係を示したものにとどまります。
何を解決するか
実装する人によって作り方がばらつく状態を防ぎます。基本設計の段階では、画面や外部とのやり取りといった外から見える振る舞いは決まっていても、それを内部でどう分担して処理するかは決まっていません。詳細設計で処理の流れ、例外時の扱い、テーブルの項目と関係を文書にすると、複数の担当者が並行して実装しても部品どうしの前提がそろいます。
この工程は、設計する人と実装する人が分かれている体制を前提にしています。外部の開発会社や複数のチームに実装を分担させる場合ほど、文書の役割が大きくなります。
実際の進み方
基本設計書を入力に、モジュールやクラスの構成、処理ごとの手順、データベースのテーブル定義、エラー処理の方針を作成します。単体テストで確かめる観点も、この段階で洗い出すことができます。
レビューは主に開発側の内部で行い、基本設計との整合と、実装できる粒度になっているかを確認します。レビューを通った詳細設計書をもとに実装と単体テストへ進みます。
アジャイル開発や自社サービスの開発では、詳細設計書を別の工程として作らず、実装とコードレビューの中で詰める組織もあります。
導入でよくある失敗
- コードとほぼ同じ内容を文書に書き写し、実装後の修正に文書の更新が追いつかなくなる
- 設計者と実装者の間で質問の窓口を決めず、解釈の違いが単体テストの段階で表れる
- 基本設計の変更を詳細設計へ反映する手順が無く、文書どうしが食い違う
求人票にこの語がある場合に読み取れること
「詳細設計から実装まで」と書かれた求人は、仕様が決まった状態から開発に入る役割であることが多く、発注側との仕様調整は別の担当者が行う体制だと推定できます。受託開発やシステムインテグレーションの組織で主に使われる語です。自社開発の求人で使われている場合は、仕様を誰が決め、どこから担当するかを求人票に書き分けると、担当範囲が伝わります。レジュメで「詳細設計」を担当範囲に挙げている候補者には、設計書を自分で書いたのか、他者の設計書をもとに実装したのかを確認してください。質問の例は「例外時の扱いをどう決めましたか」「設計レビューで受けた指摘と、その後の変更を教えてください」です。
隣接手法との違い
| 用語 | 指すもの | 詳細設計との違い |
|---|---|---|
| 基本設計 | 利用者から見える仕様を決める工程 | 外から見える振る舞いが対象 |
| 単体テスト | 小さな単位が期待どおり動くかの確認 | 詳細設計で決めた内容を検証する側 |
| コードレビュー | 書かれたコードを他者が確認する活動 | 実装後の成果物が対象 |
基本設計と詳細設計は、決める対象・主な読み手・成果物が異なります。下の表は典型例で、工程の境界と名称は組織や契約で異なります。
| 比べる項目 | 基本設計 | 詳細設計 |
|---|---|---|
| 決める対象 | 画面や外部とのやり取りなど、利用者から見える振る舞い | 処理の手順、モジュールの分け方、データ構造など、内部での処理の分担 |
| 主な読み手(レビュー主体) | 発注側と開発側 | 主に開発側 |
| 成果物 | 基本設計書 | 詳細設計書(モジュールやクラスの構成、処理ごとの手順、テーブル定義、エラー処理の方針) |