要件定義が終わり、開発会社から「外部設計書を確認して、承認をお願いします」と分厚い資料が届いた。画面の絵や項目の一覧、処理の説明がびっしり並んでいて、どこを見て何を判断すればよいのか分からない。そもそも外部設計と内部設計は何が違い、発注側はどこまで口を出すべきなのか。外部設計を調べる発注担当者の多くが、ここで手が止まります。

先に結論を書くと、発注側が重点的に確かめるべきなのは、画面、帳票、操作、業務のルールなど、使う人から見える部分を決める外部設計です。内部設計は開発会社の専門の領域ですが、保守や引き継ぎに関わるので、受け取る成果物とレビューの仕方は契約の前に確かめておきます。この記事では、外部設計と内部設計の違いを整理したうえで、発注側が外部設計で確かめる観点と承認の進め方、内部設計で押さえておくことを解説します。

この記事のポイント

  1. 外部設計は使う人から見える部分、内部設計はシステムの中の作りを決める
  2. 発注側が承認するのは外部設計で、画面・帳票・操作・業務のルールを確かめる
  3. 正常な流れだけでなく、入力の誤りや権限、例外の扱いまで見る
  4. 内部設計は、受け取る成果物とレビューの仕方を契約で決めておく
目次
  1. 外部設計と内部設計の違い
  2. 外部設計は使う人から見える部分を決める
  3. 内部設計はシステムの中の作りを決める
  4. 違いを表で整理する
  5. 工程の略し方
  6. 外部設計で決め切らないと起きること
  7. 外部設計で発注側が確認すべきポイント
  8. 外部設計書を読む順番
  9. 画面は項目と操作の流れを見る
  10. 帳票と出力を見る
  11. 例外と権限を見る
  12. ほかのシステムとのつなぎを見る
  13. 承認の進め方
  14. 指摘の書き方
  15. 内部設計で押さえておくこと
  16. 外部設計についてよくある質問
  17. 総括:外部設計は発注側が承認する設計

外部設計と内部設計の違い

画面と帳票を利用者が見ている表側と、その裏で処理やデータの保管が動いている中側を、ついたてで分けて表したイラスト
外部設計は使う人から見える表側、内部設計はシステムの中側を決めます

まず、外部設計と内部設計がそれぞれ何を決める工程なのか、どんな成果物ができるのかを整理します。

外部設計は使う人から見える部分を決める

外部設計とは、システムを使う人から見える部分を決める工程です。どんな画面があり、画面にどの項目が並び、どんな順番で操作し、どんな帳票が出てくるのか。ほかのシステムとどんなデータをやり取りするのか、入力を誤ったときにどんな表示が出るのか、といったことを決めます。

要件定義で「何を実現するか」を決めたあと、それを使う人の目線で具体的な形にするのが外部設計です。使う人が直接触れる部分なので、発注側の確認と合意が欠かせません。

内部設計はシステムの中の作りを決める

内部設計とは、外部設計で決めた動きを実現するために、システムの中をどう作るかを決める工程です。処理をどういう単位に分けるか、データをどんな形で保管するか、プログラムをどう組み立てるか、といった技術的な内容を決めます。

使う人の目には触れない部分で、開発会社の専門の領域です。発注側が中身を細かく確かめる必要は基本的にありませんが、後で説明するように、保守や引き継ぎのために受け取るべきものはあります。

違いを表で整理する

項目 外部設計 内部設計
決めること 画面、帳票、操作の流れ、業務のルール、外部とのデータのやり取り 処理の分け方、データの保管の形、プログラムの組み立て
見る人の目線 使う人から見た動き 作る人から見た中身
主な成果物 画面の設計書、帳票の設計書、機能の一覧、外部とのつなぎの設計書 処理の設計書、データベースの設計書、プログラムの設計書
発注側の関わり 内容を確かめて承認する 成果物を受け取り、必要に応じて説明を受ける

会社によっては、外部設計を基本設計、内部設計を詳細設計と呼ぶこともあります。呼び方の組み合わせは会社ごとに少しずつ違うので、どの工程でどの書類ができ、どれを発注側が承認するのかを、最初に開発会社と確かめておくと混乱しません。要件定義と基本設計の違いや、設計書の読み方は要件定義と基本設計・仕様書の違いで整理しています。

工程の略し方

工程表や打ち合わせの資料では、設計の工程が略して書かれることがあります。外部設計はED、基本設計はBDと書かれることが多く、内部設計はID、詳細設計はDDと書かれることがあります。ただし、略し方も会社によって違うので、分からない略語は遠慮せずに意味を聞いてください。

外部設計は、あとで行う総合的なテストと対になる工程でもあります。外部設計で決めたとおりに動くかを、テストで確かめる関係です。設計とテストの対応はシステム開発のV字モデルと発注側の確認点で解説しています。

外部設計で決め切らないと起きること

外部設計を十分に確かめずに承認すると、開発が進んで画面が動くようになってから、「この項目がない」「この順番では現場で使えない」といった指摘が次々に出てきます。この段階での変更は、すでに作ったものを作り直すことになるので、費用も期間も大きく膨らみます。

外部設計は、発注側が見た目と動きで確かめられる最後の大きな機会です。ここで時間をかけて確かめることが、後の手戻りをいちばん安く防ぐ方法になります。

外部設計で発注側が確認すべきポイント

キャスター付きのボードに印刷した画面の設計図を貼り、業務担当者たちが実際の業務の手順と照らし合わせながらマーカーで指摘を書き込んでいる様子
画面や帳票を、実際の業務の手順と照らし合わせて確かめます

ここからは、外部設計書を受け取った発注側が、何をどう確かめればよいかを整理します。技術的な正しさではなく、業務で本当に使えるかを見るのが発注側の役割です。

外部設計書を読む順番

分厚い外部設計書を最初のページから順に読むと、途中で要点を見失いがちです。発注側は、次の順番で読むと効率よく確かめられます。

  • 機能の一覧:要件定義で決めた機能が、すべて載っているか
  • 画面の一覧と画面の流れ:どの画面からどの画面へ進むか
  • 毎日使う画面の設計:項目と操作
  • 帳票と出力の設計
  • ほかのシステムとのつなぎの設計
  • そのほかの画面と、例外の扱い

最初に機能の一覧を要件定義書と見比べておくと、設計の段階で抜け落ちた機能がすぐに分かります。この照らし合わせは、情報システムの担当者が先に済ませておき、業務の担当者には毎日使う画面から見てもらう、という分け方が現実的です。

画面は項目と操作の流れを見る

画面の設計では、まず、業務で必要な項目がすべて並んでいるかを確かめます。今使っている帳票やExcelと見比べて、抜けている項目がないか、逆に使わない項目が並んでいないかを見てください。

次に、操作の流れを確かめます。実際の業務の1日を思い浮かべ、「朝いちばんに注文を入力する」「在庫を確かめる」「出荷を指示する」といった手順で画面をたどってみます。何度も画面を行き来しないとできない作業や、同じ内容を2回入力する場面があれば、それは指摘すべき点です。

帳票と出力を見る

帳票の設計では、取引先に送る書類や社内で配る一覧などが、今の形と同じ情報を持っているかを確かめます。取引先に指定の書式がある場合は、とくに注意が必要です。

あわせて、Excelやファイルで出力する必要があるデータも確かめます。月末の集計や、会計のシステムへの受け渡しなど、画面に出ていない使い方が業務の中にあることは少なくありません。

例外と権限を見る

外部設計書は、どうしても正常な流れを中心に書かれます。発注側が必ず確かめたいのは、正常でない場面の扱いです。

  • 入力を誤ったとき、どんな表示が出て、どう直せるか
  • 途中で操作をやめたとき、入力した内容はどうなるか
  • 在庫が足りない、承認が差し戻された、といった例外のときにどう動くか
  • 誰がどの画面を見られ、誰が登録や削除をできるか

現場の担当者に「いつもと違う対応をするのはどんなときか」を聞き、その場面が設計書に書かれているかを確かめると、抜けが見つかりやすくなります。

ほかのシステムとのつなぎを見る

会計のシステム、取引先との受発注の仕組み、ネットショップの管理画面など、ほかのシステムとデータをやり取りする場合は、何のデータを、いつ、どの方向に渡すのかが書かれているかを確かめます。つなぎ先が社外の場合は、相手の都合で形式が決まっていることが多いので、相手の担当者に確認してもらうのが確実です。

承認の進め方

外部設計書の確認は、情報システムの担当者だけで行わず、実際にシステムを使う業務の担当者に参加してもらってください。業務を知っている人にしか気づけない抜けが、必ずあります。

確認の期間は、開発会社のスケジュールに合わせて短く済ませがちですが、分量に見合った日数をもらうよう交渉してください。画面の絵だけで分かりにくい場合は、画面を順にたどれる見本や、動く試作を見せてもらえるかを相談するのも有効です。指摘は、画面や項目ごとに一覧にまとめて渡し、どう直ったかを確かめてから承認します。

指摘の書き方

確認で見つけた点は、開発会社が迷わず直せる形で伝えることが大切です。どの画面の、どの部分を、なぜ、どうしてほしいのかをそろえて書きます。

伝わりにくい書き方 伝わる書き方
注文の画面が使いにくい 注文入力の画面で、取引先を選ぶと前回の注文内容が出るようにしてほしい。同じ取引先から同じ品目の注文が多く、毎回入れ直しているため
帳票が違う 出荷指示書に、倉庫の棚番号の欄を加えてほしい。倉庫の担当者が棚番号を見て商品を集めているため
権限をちゃんとしてほしい 単価の変更は、営業課長以上だけができるようにしてほしい。今は担当者ごとに単価を変えてしまう問題が起きているため

理由まで書いておくと、開発会社は「その理由なら、こちらの形のほうが良い」と別の案を返すこともできます。指摘には、必ず直してほしいものと、できれば直してほしいものの区別も付けておくと、費用と期間の相談がしやすくなります。

内部設計で押さえておくこと

内部設計の中身を発注側が細かく確かめる必要はありません。ただし、次の点は、契約の前に開発会社と決めておいてください。

  • 内部設計の成果物(処理やデータベースの設計書など)を、納品物として受け取るか
  • 成果物をどの形式で、いつ受け取るか
  • 内部設計のレビューを、開発会社の中でどう行うか

内部設計の成果物は、ふだんは読まなくても、保守を別の会社に引き継ぐときや、将来システムを作り替えるときに欠かせない資料になります。受け取っていないと、引き継ぎのたびに中身を調べ直す費用がかかります。

外部設計書を承認する前に確かめたいこと

  • 業務で必要な項目が画面にすべて並んでいるか
  • 実際の業務の手順どおりに画面をたどれるか
  • 帳票とファイル出力が、今の業務と取引先の求めに合っているか
  • 入力の誤り、途中でやめたとき、例外のときの動きが書かれているか
  • 誰がどの画面を見られ、何をできるかが決まっているか
  • ほかのシステムとのデータのやり取りが書かれているか

要件定義で決めたことが外部設計に正しく反映されているかを確かめるには、要件定義書レビューシートの観点がそのまま使えます。要件の抜け漏れと、設計で落ちやすい項目を照らし合わせられます。

外部設計についてよくある質問

Q. 外部設計を承認したあとに変更はできますか?
A. できますが、多くの場合、変更の手続きと追加の費用が必要になります。どの段階の変更がどのくらい費用に響くかは、契約の変更の取り決めによります。承認の前に確かめきれない部分があるなら、その部分を明記したうえで承認し、確定の時期を決めておく方法もあります。
Q. 外部設計書はどのくらいの分量になりますか?
A. システムの規模によりますが、画面や帳票の数だけ設計書ができるので、中規模の業務システムでも数十ページから百ページを超えることがあります。すべてを同じ重さで読む必要はなく、業務で毎日使う画面や、取引先に出す帳票から優先して確かめてください。
Q. 誰が確認に参加すべきですか?
A. 情報システムの担当者に加えて、そのシステムを毎日使う業務の担当者、帳票を受け取る部署や取引先とやり取りする担当者に参加してもらうのが理想です。全員が全ページを見る必要はないので、担当する画面や帳票を分けて確かめてもらうと効率的です。