開発の基本概念

基本設計 きほんせっけい

外部設計基本設計書画面設計要件定義詳細設計
基本設計について教えて

簡単に言うとこんな感じ!

家を建てる前に「リビングはこの広さ、窓はここ、キッチンはこっち」と間取り図を決める作業だよ。システムなら「どんな画面があって、どのボタンを押すと何が起きるか」を、使う人の目線で決めるんだ。発注側がいちばんしっかり見るべき設計書ってこと!


基本設計とは

基本設計は、要件定義で決めた「何を実現するか」を、システムとしてどんな形にするかに置きかえる工程です。画面や帳票(印刷物やPDF)の様式、ほかのシステムとのデータのやり取りなど、システムの外から見える部分を具体的に決めます。そのため「外部設計」とも呼ばれます。

基本設計書は、このあとの詳細設計(プログラムの中身の設計)や製造、テストのよりどころです。要件定義が「料理の注文」なら、基本設計は「盛りつけの見本写真」です。見本なら直すのは簡単ですが、料理ができてからでは作り直しです。

発注側にとって、基本設計書のレビュー(読んで確かめること)と承認は、プロジェクトでいちばん大事な関わりどころのひとつです。ここでずれを見つければ紙の修正ですみますが、テストの段階で見つかると作り直しの費用も日数もふくらみます。

アプリの画面を設計するイメージのイラスト

基本設計で決めること

設計の領域決めることの例成果物の例
画面画面の一覧、項目の並び、入力のチェック、画面の移り変わり画面一覧、画面遷移図、画面レイアウト
帳票請求書・一覧表などの様式、出す項目、集計のしかた帳票レイアウト
機能機能の一覧と処理の概要、業務の流れとの対応機能一覧、業務フロー
データどんな情報を持つかER図、データ項目の一覧
外部とのつなぎ連携先、受け渡すデータ、形式、タイミングインターフェース定義書
非機能性能、権限、ログの方式方式設計書

工程の呼び名や区切りは会社やベンダーによって少しずつ違うので、契約の前に「どの文書をどこまで作るか」を一覧で確かめるのが確実です。


開発の流れの中の位置づけ

要件定義何を実現するか 基本設計外から見える形 詳細設計中の作り 製造 テスト設計どおりか 総合テストは基本設計書と照らして確かめる

ウォーターフォール型の開発では、あとの総合テストで「基本設計書のとおりに動くか」を確かめます。基本設計書は完成品を受け入れるときの物差しにもなります。

基本設計書って分厚くて専門用語だらけ…。全部読まないとダメ?

全部を同じ熱量で読まなくて大丈夫だよ!おすすめは画面と帳票から読むこと。現場の人に画面の絵を見せて「この順番で入力できる?」と聞くと、ずれがすぐ見つかるんだ。

細かいデータの定義は、ベンダーに「業務でどう困る可能性がある?」と説明してもらおう。分からない言葉のまま承認するのだけは避けてね。

承認したあとで「やっぱりここ変えたい」となったら?

変えられるけど、正式な変更として費用や納期を見直して合意する流れになるよ。小さな変更の積み重ねはスコープクリープのもとになるから、変更は記録して変更管理の手順に乗せよう!


歴史と背景

  • 1970年:W.W.ロイスの論文が、工程を順に進める開発の進め方として知られるようになる(のちに「ウォーターフォール」と呼ばれる)
  • 1980〜90年代:日本の大手ベンダーを中心に、基本設計・詳細設計という工程と設計書の形式が定着する
  • 1994年:工程と作業の呼び名をそろえる「共通フレーム」の最初の版が公表される(のちに IPA が改訂を引き継ぐ)。発注側とベンダーの言葉を合わせる土台になる
  • 2000年代〜:アジャイル開発が広まり、分厚い設計書を先に書ききるやり方が見直される
  • 現在:画面の試作(プロトタイプ)を見せながら合意する進め方が広がる。「外から見える形を先に合意する」考え方は変わらない

詳細設計・アジャイルとのちがい

観点基本設計(外部設計)詳細設計(内部設計)アジャイルでは
対象画面・帳票・連携・データプログラムの部品と処理次に作る分だけ決める
主なレビュアー発注側と現場開発チームプロダクトオーナー
文書基本設計書詳細設計書動く画面、ストーリー

アジャイルでも設計がないわけではなく、動く画面を短い間隔で見せて合意を積み上げます。


実務のポイント

  • 要件定義の項目が、基本設計のどこに書かれたか対応表をもらったか(抜け漏れの確認)
  • 画面と帳票を、実際に使う現場の人に見てもらったか
  • エラーや入力ミスのときの動きが書かれているか
  • 社内の言葉(「得意先」「顧客」など)の呼び方がそろっているか
  • 性能や止めてよい時間など、非機能要件が方式に落ちているか
  • 承認の期限と承認者、承認後の変更の手順を決めたか
  • 設計と製造で契約(準委任・請負)を分けるか確かめたか

関連する規格・RFC

規格内容
ISO/IEC/IEEE 12207ソフトウェアのライフサイクルの工程(プロセス)の国際規格。日本では JIS X 0160
ISO/IEC 25010ソフトウェアの品質の物差し(品質モデル)。非機能の設計の観点に使う

参考文献・外部リンク


関連用語

シス担のミカタ メールマガジン

セキュリティの速報とシステムの最新情報をメールで受け取る

登録すると、次の配信からお届けします。配信はメールの下のリンクから、いつでも解除できます。個人情報の取り扱い