基本設計 きほんせっけい
簡単に言うとこんな感じ!
家を建てる前に「リビングはこの広さ、窓はここ、キッチンはこっち」と間取り図を決める作業だよ。システムなら「どんな画面があって、どのボタンを押すと何が起きるか」を、使う人の目線で決めるんだ。発注側がいちばんしっかり見るべき設計書ってこと!
基本設計とは
基本設計は、要件定義で決めた「何を実現するか」を、システムとしてどんな形にするかに置きかえる工程です。画面や帳票(印刷物やPDF)の様式、ほかのシステムとのデータのやり取りなど、システムの外から見える部分を具体的に決めます。そのため「外部設計」とも呼ばれます。
基本設計書は、このあとの詳細設計(プログラムの中身の設計)や製造、テストのよりどころです。要件定義が「料理の注文」なら、基本設計は「盛りつけの見本写真」です。見本なら直すのは簡単ですが、料理ができてからでは作り直しです。
発注側にとって、基本設計書のレビュー(読んで確かめること)と承認は、プロジェクトでいちばん大事な関わりどころのひとつです。ここでずれを見つければ紙の修正ですみますが、テストの段階で見つかると作り直しの費用も日数もふくらみます。
基本設計で決めること
| 設計の領域 | 決めることの例 | 成果物の例 |
|---|---|---|
| 画面 | 画面の一覧、項目の並び、入力のチェック、画面の移り変わり | 画面一覧、画面遷移図、画面レイアウト |
| 帳票 | 請求書・一覧表などの様式、出す項目、集計のしかた | 帳票レイアウト |
| 機能 | 機能の一覧と処理の概要、業務の流れとの対応 | 機能一覧、業務フロー |
| データ | どんな情報を持つか | ER図、データ項目の一覧 |
| 外部とのつなぎ | 連携先、受け渡すデータ、形式、タイミング | インターフェース定義書 |
| 非機能 | 性能、権限、ログの方式 | 方式設計書 |
工程の呼び名や区切りは会社やベンダーによって少しずつ違うので、契約の前に「どの文書をどこまで作るか」を一覧で確かめるのが確実です。
開発の流れの中の位置づけ
ウォーターフォール型の開発では、あとの総合テストで「基本設計書のとおりに動くか」を確かめます。基本設計書は完成品を受け入れるときの物差しにもなります。
全部を同じ熱量で読まなくて大丈夫だよ!おすすめは画面と帳票から読むこと。現場の人に画面の絵を見せて「この順番で入力できる?」と聞くと、ずれがすぐ見つかるんだ。
細かいデータの定義は、ベンダーに「業務でどう困る可能性がある?」と説明してもらおう。分からない言葉のまま承認するのだけは避けてね。
歴史と背景
- 1970年:W.W.ロイスの論文が、工程を順に進める開発の進め方として知られるようになる(のちに「ウォーターフォール」と呼ばれる)
- 1980〜90年代:日本の大手ベンダーを中心に、基本設計・詳細設計という工程と設計書の形式が定着する
- 1994年:工程と作業の呼び名をそろえる「共通フレーム」の最初の版が公表される(のちに IPA が改訂を引き継ぐ)。発注側とベンダーの言葉を合わせる土台になる
- 2000年代〜:アジャイル開発が広まり、分厚い設計書を先に書ききるやり方が見直される
- 現在:画面の試作(プロトタイプ)を見せながら合意する進め方が広がる。「外から見える形を先に合意する」考え方は変わらない
詳細設計・アジャイルとのちがい
| 観点 | 基本設計(外部設計) | 詳細設計(内部設計) | アジャイルでは |
|---|---|---|---|
| 対象 | 画面・帳票・連携・データ | プログラムの部品と処理 | 次に作る分だけ決める |
| 主なレビュアー | 発注側と現場 | 開発チーム | プロダクトオーナー |
| 文書 | 基本設計書 | 詳細設計書 | 動く画面、ストーリー |
アジャイルでも設計がないわけではなく、動く画面を短い間隔で見せて合意を積み上げます。
実務のポイント
- 要件定義の項目が、基本設計のどこに書かれたか対応表をもらったか(抜け漏れの確認)
- 画面と帳票を、実際に使う現場の人に見てもらったか
- エラーや入力ミスのときの動きが書かれているか
- 社内の言葉(「得意先」「顧客」など)の呼び方がそろっているか
- 性能や止めてよい時間など、非機能要件が方式に落ちているか
- 承認の期限と承認者、承認後の変更の手順を決めたか
- 設計と製造で契約(準委任・請負)を分けるか確かめたか
関連する規格・RFC
| 規格 | 内容 |
|---|---|
| ISO/IEC/IEEE 12207 | ソフトウェアのライフサイクルの工程(プロセス)の国際規格。日本では JIS X 0160 |
| ISO/IEC 25010 | ソフトウェアの品質の物差し(品質モデル)。非機能の設計の観点に使う |
参考文献・外部リンク
- ユーザのための要件定義ガイド 第2版(IPA) — 要件定義から設計へのつなぎ方を発注側向けに解説
- 非機能要求グレード(IPA) — 性能や可用性などを決めるための物差し
- 情報システム・モデル取引・契約書(IPA) — 工程ごとに契約を分ける考え方のひな形
- デジタル社会推進標準ガイドライン(デジタル庁) — 政府システムの設計・開発の標準
関連用語
- 要件定義 — 基本設計の前に「何を実現するか」を決める工程
- 詳細設計 — 基本設計をもとにプログラムの中身を決める工程
- 基本設計・詳細設計(発注の視点) — 発注側から見た設計工程の関わり方
- 仕様書 — 設計の内容をまとめた文書
- ER図 — データの関係を表す図
- ウォーターフォール — 工程を順番に進める開発の進め方
- ユーザー受け入れテスト — 発注側が完成品を確かめるテスト
- RFP(提案依頼書) — 発注前にベンダーへ要件を伝える文書