基本設計と詳細設計はどう違う?発注側がレビューすべき範囲
システム開発の要件定義が終わると、開発会社は設計の工程に入ります。設計は一般に基本設計と詳細設計の二段階に分けられ、それぞれの段階で設計書が作られます。発注側にも設計書のレビューや承認を求められますが、分厚い資料を前に、どこまで読めばよいのか分からないという声をよく聞きます。
基本設計と詳細設計の違いを一言でいえば、基本設計はシステムを使う人から見える部分を決め、詳細設計はシステムの内部の作り方を決める工程です。発注側が責任を持ってレビューすべきなのは主に基本設計で、詳細設計は原則として開発会社の責任で進めるものです。
ただし、この二つの工程の呼び方と範囲は会社によって違います。外部設計と内部設計と呼ぶ会社もあれば、概要設計や方式設計といった言葉を使う会社もあります。名前だけで判断すると、発注側が確認すべき内容が、発注側の見ない設計書に入っていた、ということが起こりえます。
この記事では、基本設計と詳細設計の違い、会社によって異なる呼び方とその確かめ方、発注側が基本設計書でレビューすべき範囲、詳細設計にどこまで関わるかの判断、レビューの進め方を解説します。
基本設計と詳細設計で決めることの違い

基本設計と詳細設計の違いは、誰の視点で何を決めるかにあります。基本設計では、要件定義で決めた「何ができればよいか」をもとに、画面、帳票、他システムとのやり取りなど、システムの外側から見える仕様を決めます。詳細設計では、基本設計で決めた仕様を実現するために、プログラムの構成や処理の手順、データベースの細かな構造など、内側の作り方を決めます。
| 比べる点 | 基本設計 | 詳細設計 |
|---|---|---|
| 決めること | 画面、帳票、入出力の項目、他システムとの連携、操作の流れ | プログラムの部品の分け方、処理の手順、データベースの細かな構造 |
| 視点 | システムを使う人、連携する相手 | システムを作る人 |
| 主な読み手 | 発注側の担当者と開発会社 | 開発会社のエンジニア |
| 発注側の関わり | 内容をレビューし、承認する | 原則として開発会社に任せる。必要な部分だけ確認する |
| 確認する方法 | 主に総合テスト(システムテスト)や受入テスト | 主に単体テストや結合テスト |
この違いは、後の工程での手戻りの大きさにも関わります。基本設計で決めた画面の項目や業務の流れが、開発の終盤になって業務に合わないと分かると、その画面に関わる詳細設計、プログラム、テストをすべてやり直すことになります。一方、詳細設計の誤りは、多くの場合、開発会社のテストの中で見つかり、開発会社の中で修正されます。発注側が基本設計のレビューに力を入れるべき理由はここにあります。
基本設計の段階は、費用の面でも区切りになります。IPA(情報処理推進機構)が公開している「情報システム・モデル取引・契約書」の解説では、画面や帳票などのインターフェースを決定する外部設計のフェーズで確定見積が可能になると考え、外部設計が発注側に承認された後の要件追加や仕様変更は、変更管理の手続に沿って追加の見積もりを含めて扱うものとしています。基本設計を承認するということは、そこから先の変更には費用と期間の協議が必要になる、という線を引くことでもあります。
参考:情報システム・モデル取引・契約書(受託開発(一部企画を含む)、保守運用)〈第二版〉/IPA(情報処理推進機構)
呼び方と範囲は会社によって違う

基本設計と詳細設計という呼び方は広く使われていますが、業界で統一された名前ではありません。同じ工程を指して別の言葉を使う会社もあれば、同じ言葉で範囲の違う工程を指す会社もあります。
| よく使われる呼び方 | おおむね対応する工程 |
|---|---|
| 基本設計、外部設計、概要設計 | 使う人から見える仕様を決める工程 |
| 詳細設計、内部設計、プログラム設計 | 内部の作り方を決める工程 |
| 方式設計、アーキテクチャ設計 | システム全体の構成や技術の方式を決める工程。基本設計に含める会社も、独立した工程にする会社もある |
前述のモデル契約の解説でも、専門用語の多くには明確な定義がなく、同じ概念を異なる用語で表す場合も多いと指摘されています。そのうえで、上流工程を「概要設計、基本設計、詳細設計、論理設計」と区分する場合もあれば、モデル契約のように「要件定義、外部設計、内部設計」と区分する場合もある、という例が挙げられています。
公的な工程の枠組みとして、IPAは「共通フレーム2013」を公開しています。共通フレーム2013の開発に関するプロセスには、システム要件定義、システム方式設計、ソフトウェア要件定義、ソフトウェア方式設計、ソフトウェア詳細設計といった名前が並び、「基本設計」という工程名はありません。モデル契約では、外部設計を共通フレーム2013のシステム要件の定義や評価・レビューに、内部設計をシステム方式の確立や評価・レビューに相当するものとして定義しています。つまり、一般にいう基本設計と詳細設計は、公的な枠組みの名前とは一対一に対応していないということです。
発注側にとって大切なのは、名前の正しさではなく、自社が確認すべき内容がどの設計書に入っているかです。とくに次のような項目は、会社によって基本設計に入ることも、詳細設計に入ることもあります。
- データベースのテーブルや項目の一覧
- 入力チェックの細かな規則(桁数、必須かどうか、入力できる文字の種類)
- 他システムとの連携で受け渡すデータの形式
- エラーが起きたときの画面表示や通知
- 帳票の細かなレイアウト
これらは業務に直接関わるため、発注側が確認したい項目です。設計の工程に入る前に、開発会社から設計書の一覧と、それぞれの設計書に書かれる内容の説明を受けておきましょう。そのうえで、発注側がレビューする設計書と、開発会社に任せる設計書を合意しておくと、確認の漏れを防げます。
参考:共通フレーム2013第3部 共通フレームとガイダンス(ガイダンス部分抜粋)/IPA(情報処理推進機構)
参考:情報システム・モデル取引・契約書〈第二版〉ソフトウェア開発委託基本モデル契約書(ひな型)/IPA(情報処理推進機構)
発注側が基本設計書でレビューすべき範囲

モデル契約では、外部設計書を、要件定義書に基づいて画面や帳票などのユーザーインターフェース、他システムとの通信やデータの入出力などのインターフェースといった、ソフトウェアの入出力全般に関する仕様を定めた設計書と定義しています。また、外部設計書の点検期間内に、要件定義書と外部設計検討会での決定事項に適合しているかを点検し、双方の責任者が記名押印して確定させる形が示されています。発注側が基本設計書でレビューするのは、まさにこの入出力の仕様が、業務と要件定義に合っているかです。
| 設計書の主な内容 | 発注側が見る観点 | 確かめ方 |
|---|---|---|
| 業務の流れとシステムの関係 | どの業務のどの場面で、誰がシステムを使うか。システムの外で残る作業は何か | 現在の業務の手順と一つずつ突き合わせる |
| 画面の一覧と画面の遷移 | 必要な画面がそろっているか。業務の順番どおりに画面が移れるか | 代表的な業務を一件、画面をたどって最後まで処理してみる |
| 画面と帳票の項目 | 業務で使う項目が足りているか。不要な項目がないか。項目の名前が社内の呼び方と合っているか | 現在使っているExcelや帳票の項目と照合する |
| 入力の規則と計算の規則 | 金額の端数処理、締め日、税の計算など、業務のルールが正しく反映されているか | 過去の実際の取引で計算し、結果を比べる |
| 権限 | 誰がどの画面を見られ、どの操作ができるか | 社内の役職や担当ごとに、使える操作を表にして確認する |
| 他システムとの連携 | 連携する相手、受け渡すデータ、タイミング、失敗したときの扱い | 連携先の担当者や提供元にも内容を確認してもらう |
| 性能や運用の条件 | 利用者数、データ量、利用時間帯、バックアップ、障害時の対応 | 要件定義で決めた条件と一致しているかを確認する |
レビューで特に見落としやすいのは、例外的な業務です。通常の受注は問題なく処理できても、返品、取消、締め日をまたぐ修正、特定の取引先だけの特別な扱いなどが設計に含まれていないことがあります。現場の担当者に「年に数回しか起きないが、起きると困る処理」を挙げてもらい、それが設計書のどこで扱われているかを確認してください。
反対に、発注側が深入りしなくてよい部分もあります。画面の色やボタンの配置の細部、内部で使う技術の選び方などは、業務に支障がない限り開発会社の提案に任せてかまいません。レビューの時間は限られているため、業務への影響が大きい項目から順に確認していくことが大切です。
詳細設計にどこまで関わるか

詳細設計は、原則として開発会社の責任で進める工程です。モデル契約の解説でも、ソフトウェアのコンポーネント、インターフェース、データベースの詳細設計は開発会社が行うフェーズとして整理されています。発注側が詳細設計書をすべて読む必要はありません。
ただし、次のような場合には、詳細設計の一部を確認しておく意味があります。
| 状況 | 確認しておきたい内容 |
|---|---|
| 将来、保守を別の会社に移す可能性がある | 詳細設計書が納品物に含まれるか。第三者が読める内容と形式になっているか |
| 社内でデータを分析や他の用途に使いたい | データベースの構造と、項目の意味が説明されているか |
| 個人情報や機密情報を扱う | 情報の保存方法、アクセスの記録、削除の仕組み |
| 大量のデータや多数の利用者を想定している | 性能の条件を満たすための方式と、その確認方法 |
| 社内にIT担当者がいる | 担当者が理解できる範囲で、構成や技術の選び方に無理がないか |
詳細設計書を納品物に含めるかどうかは、契約の段階で決めておきます。詳細設計書を開発会社の社内資料として扱い、納品しない契約もあります。将来の保守や乗り換えを考えるなら、納品物の一覧に含めておくほうが安全です。
詳細設計の段階で開発会社から確認や承認を求められることもあります。モデル契約では、開発の過程で作られる中間資料について、開発会社が必要と認める部分を示して発注側の承認を書面で求めることができ、発注側が点検期間内に具体的な理由を示して異議を述べなければ承認したものとみなす、という規定例が置かれています。自社の契約に同じような規定がある場合、内容を確認しないまま期間が過ぎると承認したことになりかねません。承認を求められた資料は、何を承認することになるのかを開発会社に確かめ、判断できない部分はその旨を書面で伝えておきましょう。
レビューを形だけにしない進め方

設計書のレビューは、資料を受け取って目を通すだけでは不十分です。限られた時間で業務に合わない点を見つけるには、誰が、何を基準に、どう読むかを決めておく必要があります。
まず、レビューには実際にシステムを使う現場の担当者を参加させます。発注の窓口になった担当者だけでは、日々の業務の細かな手順や例外までは確認しきれません。全員が全体を読む必要はなく、担当する業務に関わる画面と帳票だけを読んでもらう分け方で十分です。
読み方は、設計書のページ順ではなく、業務の流れに沿って進めます。「この取引先から注文を受けて、出荷して、請求するまで」のように、実際の業務を一件決めて、設計書の画面や帳票をたどりながら処理を追いかけます。この方法なら、設計書の書き方に慣れていない担当者でも、足りない画面や項目に気づきやすくなります。
指摘は、種類を分けて記録します。
- 要件定義の内容と違っている点
- 要件定義では決めていなかったが、業務上必要な点
- 意味が分からず、説明を受けたい点
一つ目は開発会社が修正すべき指摘ですが、二つ目は要件の追加にあたる可能性があり、費用や期間への影響を確認する必要があります。三つ目は質問として回答をもらい、必要なら記述を分かりやすく直してもらいます。種類を分けずに指摘を渡すと、どれが追加の要望なのかが曖昧なまま設計が進み、後で費用の話が持ち上がったときに揉める原因になります。
レビューの期間も事前に決めておきます。設計書の量に対して期間が短すぎると、読み切れないまま承認することになります。現場の担当者の業務の予定を考慮して、無理のない期間をスケジュールに組み込んでもらいましょう。
契約の形によって、発注側の立場も変わります。モデル契約では、外部設計書の作成を、発注側が作成し開発会社が支援する準委任の形と、開発会社が作成する請負の形の両方が示されています。準委任の形であれば、設計書の内容に対する発注側の責任はより重くなります。自社の契約がどちらの形かを確かめたうえで、レビューにかける体制を決めてください。
まとめ

基本設計はシステムを使う人から見える仕様を決める工程、詳細設計は内部の作り方を決める工程です。発注側が責任を持ってレビューすべきなのは基本設計で、承認した後の変更には費用と期間の協議が必要になることが一般的です。
ただし、呼び方と範囲は会社によって違い、外部設計と内部設計、概要設計や方式設計といった言葉も使われます。公的な枠組みである共通フレーム2013にも「基本設計」という工程名はありません。名前で判断せず、設計の工程に入る前に設計書の一覧とそれぞれの内容を確認し、発注側がレビューする範囲を合意しておくことが大切です。
これから設計の工程に入るなら、まず開発会社に設計書の一覧を出してもらい、画面、帳票、入力と計算の規則、権限、連携の仕様がどの設計書に書かれるかを確かめてください。そのうえで、レビューに参加する現場の担当者と期間を決め、代表的な業務を一件たどる読み方で臨めば、限られた時間でも業務に合わない点を見つけやすくなります。
