この記事の結論
要件定義とは、システム開発の最初に、作るシステムで何ができればよいか(機能要件)と、
要件定義書は、そこで決めたことを後から誰が読んでも同じ意味にとれるようにまとめた文書で、この後の設計と見積もりの土台になります。
画面の細かな形や他のシステムとのやり取りを決めるのは、次の工程の基本設計(外部設計)です。
IPA(情報処理推進機構)の
発注する側は、今の業務の流れ、困っていること、なくてはならない機能と後回しでよい機能の区別を用意しておくと、要件定義を短く確かなものにできます。
株式会社bundlyze(バンドライズ)は、
要件定義とは
要件定義とは、作るシステムに求めることを、作り始める前に決めて書き残す工程です。
システム開発は、大まかに「何を
ここで決めるのは、作り方ではなく、できること・守ることです。
| 決めること | 例 |
|---|---|
| 業務の流れ | 問い合わせを受けてから、見積もり、受注、請求までの流れ |
| 機能 | 案件を登録する、担当者を割り当てる、請求書を出す |
| 画面と帳票 | 一覧の画面、入力の画面、出力する書類 |
| 使う人と権限 | 誰が見られて、誰が直せるか |
| 守ること | 動く時間帯、データの保管、止まったときの扱い |
表の上の4つのように「何が
権限は、誰がどの画面を使えるかを機能要件に、顧客の情報を外に出さないといった守り方を非機能要件に分けて書くと整理しやすくなります。
この2つの違いは、次の節で詳しく見ます。
機能要件と非機能要件の違い
機能要件は、システムが「何を
非機能要件は、それを「どんな
同じ「請求書を
| 機能要件 | 非機能要件 | |
|---|---|---|
| 問い | システムで何ができるか | どんな条件で、どこまで確かに動くか |
| 例 | 案件を登録する、担当者を割り当てる、請求書をPDFで出す | 平日の朝から夜まで止めない、画面が数秒で開く、データを何年残す、外から見られない |
| 誰が気づきやすいか | 現場の人。毎日の作業に出てくる | 気づかれにくい。止まったとき、遅いとき、漏れたときに初めて話題になる |
| 決め忘れたとき | 足りない機能として、使い始めてすぐ分かる | 作った後に直すと大きな手戻りになりやすい |
要件定義で抜けやすいのは、非機能要件のほうです。
現場の人は機能の話は自分からしますが、
IPAのモデル契約書の解説でも、発注する側が機能要件と非機能要件を早く、はっきり決めることが欠かせないと書かれています(IPA:情報システム・モデル取引・契約書(第二版)、
非機能要件の決め方で発注する側と開発会社の理解がずれないように、IPAは、2009〜2018年度の事業で「非機能要求グレード」という
ユーザーと開発者の認識の行き違いを防ぐことを目的にしたもので、決める項目を6つの大項目ごとに階層に分けて示しています。
事業はすでに終わっていて、紹介ページは2023年8月時点の情報として残っています(IPA:システム構築の上流工程強化(非機能要求グレード)
中小企業の業務システムで全部の項目を埋める必要はありませんが、抜けがないかを見る一覧として使えます。
要件定義と基本設計の違い
要件定義は「何を
IPAのモデル契約書では、基本設計にあたる工程を「外部設計」と
| 工程 | 決めること | 主に決める人 | モデル契約書での契約の形 |
|---|---|---|---|
| 要件定義 | 業務の流れ、機能、守ること | 発注する側。開発会社が支える | 準委任 |
| 基本設計(外部設計) | 画面、帳票、他のシステムとのデータのやり取り | 発注する側と開発会社。業務に関わる部分は発注する側が判断する | 準委任か請負を選ぶ |
| 詳細設計(内部設計)から | プログラムの作り方 | 開発会社 | 請負にもできる |
見積もりの確かさも、工程によって変わります。
モデル契約書の解説では、要件定義書をもとにした見積もりは「概算見積」で、
要件定義の段階で出た金額は、まだ動く前提で受け止めます。
要件定義書に書く項目
要件定義書には、決めたことを、後から誰が読んでも同じ意味にとれるように書きます。
決まった書式はありませんが、業務システムなら、次の項目がそろっていると開発会社が見積もりと設計に使えます。
| 項目 | 書くこと | 発注する側が出すもの |
|---|---|---|
| 目的と範囲 | 何のために作るか、どの業務までを対象にするか | 困っていること、やめたい作業 |
| 業務の流れ | 誰が、何を受けて、何をして、誰に渡すか | 今の流れの図や箇条書き、例外の手順 |
| 機能 | システムでできること | なくてはならない機能と、後回しでよい機能の区別 |
| 画面と帳票 | どんな一覧や入力、出力する書類が要るか | 今使っているExcelや紙の帳票 |
| データ | 何を記録し、どれだけ残すか | 今の台帳や顧客リストの項目 |
| 使う人と権限 | 誰が使い、誰が何を見られて直せるか | 部署と役割の一覧 |
| 守ること(非機能要件) | 動く時間帯、速さ、データの保管、セキュリティ、止まったときの扱い、今のデータの移し方 | 止まると困る時間帯、守る必要がある社内の決まり |
| ほかのシステムとのつながり | 会計ソフトや今のシステムとのデータのやり取り | 使っているサービスとアカウントの持ち主 |
| まだ決まっていないこと | 後で決める事項と、決める期限の目安 | 判断を待っている事項 |
最後の「まだ
モデル契約書にも、未確定の事項が後で決まったときの扱いを定める条文があります。
決まっていないことを隠さず書くと、見積もりの前提がはっきりします。
要件定義書の見本
項目が分かっても、どの細かさで書けばよいかは迷うところです。
問い合わせを受けてから請求までを管理する、架空の小さな業務システムを例に、要件を1行ずつ書くとこうなります。
| 番号 | 区分 | 要件 | 優先度 | 確かめ方 |
|---|---|---|---|---|
| F-01 | 機能 | 問い合わせを、受けた日・相手・内容とともに登録できる | なくてはならない | 登録した内容が一覧に出る |
| F-02 | 機能 | 問い合わせごとに担当者を1人決め、一覧で担当者ごとに絞り込める | なくてはならない | 担当者で絞り込むと、その人の分だけが出る |
| F-03 | 機能 | 受注した案件から、請求書をPDFで出せる | なくてはならない | 金額と宛名が案件の内容と一致している |
| F-04 | 機能 | 対応が3日止まっている案件を、担当者に知らせる | 後回しでよい | 3日動きのない案件で、知らせが届く |
| N-01 | 非機能 | 平日の8時から20時は使える | なくてはならない | 止める作業はこの時間の外で行う |
| N-02 | 非機能 | 顧客の連絡先は、営業部と管理部の人だけが見られる | なくてはならない | ほかの部署の人のアカウントでは見えない |
| N-03 | 非機能 | データは毎日控えを取り、取引の記録は決めた年数残す | なくてはならない | 控えから戻す手順を、使い始める前に一度試す |
番号を振っておくと、打ち合わせや見積もりで「F-04は
優先度の列は、発注する側にしか埋められません。
確かめ方の列まで書いておくと、できあがったときの受け入れの確認にそのまま使えます。
発注する側がやること
発注する側がやることは、業務の中身と優先順位を決め、要件定義書を確かめて確定させることです。
モデル契約書の解説では、要件定義は発注する側の業務内容に大きく左右される作業なので、作業は発注する側が行い、開発会社がそれを支える形を前提にしています。
発注する側にしか決められないこと
開発会社は、作り方や技術の選び方については専門家です。
ただ、次のことは発注する側にしか決められません。
- 業務の中身。 例外の扱い、現場だけが知っている手順
- 優先順位。 最初に必要な機能と、後回しでよい機能
- 判断する人。 迷ったときに誰が決めるか
ここを開発会社に任せきりにすると、できあがってから「現場の
社内に開発の窓口役を置くか、外部の技術チームにどこまで任せるかは、社内にAIも使えるエンジニアを1人雇うか、外部に任せるかで比べています。
要件定義の前に、用意しておく3つのこと
完璧な資料は要りません。
次の3つがあれば、要件定義の打ち合わせは大きく短くなります。
- 今の業務の流れ。 誰が、何を受けて、何をして、誰に渡すか。手書きの図や箇条書きで構いません
- 困っていること。 「二重入力が
多い」 「誰が 対応中か分からない」など、 具体的な場面で書く - なくてはならない機能と、あればうれしい機能の区別。 全部を最初に作ろうとしないことが、予算と期間を守る近道です
今使っているExcelや紙の帳票、今のシステムの画面の写しがあれば、それも一緒に渡します。
項目の並びや、現場が書き足している欄から、業務の実態が見えます。
画面や帳票は、新しい形を考える前に、今あるものを見せるほうが早く伝わります。
「こう
画面の形は、困りごとが分かれば開発会社から提案できます。
決めたことを書き残し、確定させる
モデル契約書では、要件定義の打ち合わせ(要件定義検討会)は
決めたことは議事録に残し、できあがった要件定義書が打ち合わせで決めた内容と合っているかを両者で確かめ、責任者が記名押印して確定させる手順です。
ここで確定させた要件定義書が、その後の設計と見積もりの土台になります。
要件定義の期間は何で決まるか
要件定義の期間は、システムの大きさだけでなく、業務の例外の多さ、関わる部署の数、そして迷ったときにすぐ決められる人がいるかで変わります。
そのため、公的に示された一律の目安はありません。
期間を延ばしやすいのは、次のような場面です。
- 部署ごとにやり方が違い、どれに合わせるかが決まらない
- 判断する人が打ち合わせに出られず、持ち帰りが続く
- 今の業務の流れが、誰にも書き出されていない
逆に、用意しておく3つのことがそろい、判断する人が打ち合わせに出ていれば、同じ大きさのシステムでも短く済みます。
開発会社に期間を聞くときは、何日かかるかだけでなく、打ち合わせの回数と、それぞれで何を決めるかを聞いておくと、社内の予定も立てやすくなります。
私たちが自社の仕組みで最初に決めたこと
私たちが自社サイトのコラムの仕組みを作ったときも、作り方より先に、守ることを決めました。
- 下書きの記事は、本番のサイトに出さない
- スマホで、日本語が変なところで改行されない
- 公開する前に、決まった点検を毎回通す
この3つが決まっていたので、作り方は後からいくつも選べました。
業務システムでも同じで、
守ることは、確かめ方とセットで書いておくと、要件として使えるものになります。
私たちの場合は、次のように決めています。
| 守ること | 確かめ方 |
|---|---|
| 下書きを本番に出さない | 公開の手順の中で、下書きの印がついた記事を外す |
| スマホで変な改行をしない | 本番に出す前に、手元で表示とフォームの動き・改行を自動で点検する |
| パスワードや鍵を漏らさない | ソースコードやチャットに書かず、決まった保管場所にだけ置く |
業務システムでも、
私たちは、多業種に対応した予約管理システムを自社プロダクトとして、企画から運用まで開発しています。
bundlyzeは大阪市北区のグラングリーン大阪を拠点にしています。
全国からご相談いただけます。
打ち合わせはWeb会議でも、対面でも可能です。
この記事を書いた津嘉山は、業務システム開発とAWSを専門とするエンジニアです。
業務システムの要件定義から開発、保守運用までを経験しています。
作る側として要件を整理するときも、最初に確かめるのはこの「守る
契約の形にも気をつける
この段階では、何を作るかがまだ決まっていません。
そのため、IPAのモデル契約書では、要件定義を、できあがりを約束する形(請負)ではなく、
2020年12月に公開された第二版でも、要件定義は契約の中で独立した段階とされ、開発会社が発注する側の要件定義書づくりを支える「要件定義作成支援業務」として、
この工程と、その後の開発を分けて契約すると、要件が固まってから開発の見積もりを取れるので、金額の根拠がはっきりします。
見積もりの読み方は、業務システムの見積もりの読み方。
金額を比べる前に確かめることにまとめています。
依頼先をどう比べるかは、大阪でシステム開発を頼む前に。
業務システムの依頼先を選ぶ基準と、進め方で整理しています。
よくある失敗
- 決める人がいない。 現場の意見がまとまらず、要件が固まらないまま開発が始まる
- 全部を最初に入れる。 あればうれしい機能まで入れて、予算と期間が膨らむ
- 決めたことを書き残さない。 打ち合わせで決めたことが、後から「言った
・言わない」に なる - 現場の人が参加しない。 管理する人だけで決めて、実際に使う人の手順と合わない
- 守ることを書かない。 機能だけを決めて、止まったときの扱いやデータの保管があいまいなまま作り始める
よくある質問
機能要件と非機能要件は、何が違いますか?
要件定義書は、誰が書くものですか?
要件定義と基本設計は、何が違いますか?
RFP(提案依頼書)と要件定義書は、何が違いますか?
要件定義だけを頼めますか?
要件定義の期間は、何で決まりますか?
困りごとを書き出すところから始める
専門的な資料を作ることが目的ではありません。
まずは、今の業務で困っている場面を、3つ書き出してみてください。
それが、開発会社との最初の打ち合わせで一番役に立つ資料になります。
システムにするか迷っている段階なら、Excelでの業務管理が限界になったときの、7つのサインも参考にしてください。
業務システムについて、
いまの状況をお聞かせください
「何から
相談の前に、いまの見え方だけ知りたい場合は
4つのAIに10の質問をした記録と、サイトの点検の結果を、30分ほどでご説明します。費用はかかりません。
