要件定義書とは？現代の開発における重要性と最新の手法を解説

「要件定義書を作成するSEは、花形SEである」と言っても、過言では有りません。それだけに、「要件定義書は大切な存在である」と言えます。

そこで今回は、要件定義書に関連する、以下の事項を解説します。

システム開発において「要件定義書」は、プロジェクトの方向性を決める極めて重要なドキュメントです。特に、近年ではクラウド環境の普及やアジャイル開発の広まりにより、要件定義の進め方も変化しています。

本記事では、要件定義書の基本から、最新のトレンドに合わせた作成方法まで詳しく解説します。

要件定義書とは？

要件定義書とは、開発するシステムの機能や非機能要件を明文化し、関係者全員が共通認識を持てるようにするためのドキュメントです。従来はウォーターフォール開発の初期フェーズで作成するのが一般的でしたが、最近ではアジャイル開発においてもスプリントごとに要件を細かく定義するケースが増えています。

要件定義書の役割

• 開発の方向性を決める - 要件が明確になることで、開発のスコープが決まり、計画が立てやすくなります。
• ステークホルダー間の認識を統一する - クライアント、開発チーム、運用担当者が共通理解を持てるようになります。
• 開発リスクを低減する - 後から「こんな機能は聞いていない」といったトラブルを防げます。

最新の要件定義手法

従来の要件定義書の作成方法に加え、最新の開発環境に適応した手法が求められています。

クラウド環境に対応した要件定義

クラウド環境では、オンプレミスと異なり、スケーラビリティやセキュリティ要件が重要になります。そのため、以下の点を明確に定義することが推奨されます。

• データの保存場所（AWS、GCP、Azure など）
• 負荷分散・可用性の確保
• APIの利用方針（REST, GraphQL など）

アジャイル開発における要件定義

アジャイル開発では、従来の「要件定義書」をスプリントごとに細かく更新する形式が主流です。そのため、次のような要素を定義します。

• ユーザーストーリーを活用した要件管理
• JIRAやConfluenceなどのツールを用いたドキュメント化
• スプリントごとの要件変更を許容するフレームワーク

なお、ウォーターフォール・モデルに関しては、以下の記事で詳細に解説しています。

Beエンジニア

ウォーターフォールとは？新人SE＆未経験でも分かり易く解説！

https://www.pmi-sfbac.org/waterfall-model

ソフトウェア開発の手法にはさまざまなものがありますが、その中でも歴史が長く、今なお利用されるのが「ウォーターフォールモデル」です。本記事では、ウォーターフォールモデルの基本概念、開発プロセス、メリット・デメリット、そして実際の活用例について詳しく解説します。ウォーターフォール型開発とは？ウォーターフォールモデルは、ソフトウェア開発において古くから用いられている開発手法の一つです。このモデルでは、開発プロセスが複数のフェーズに分けられ、それぞれのフェーズが完了してから次のフェーズへと進むのが特...

要件定義書は誰がいつ作るの?

要件定義書は、基本的にはSEが作成します。しかし、規模の大きい企業や部署においては、要件定義を専門に請け負う部門や担当者も存在します。

この要件定義書は、ソフトウェア開発工程において、主に「ウォーターフォール・モデル（Waterfall Model）」では、基本的に最も早い段階で作成します。

要件定義書の具体的な記載内容

要件定義書には、以下の内容を記載することが一般的です。

要件定義書は、顧客が求めるシステムを実現するために必要な情報を、過不足なく記述するものです。主に顧客へ向けて説明するための資料となります。

要件定義書は統一された書式や形式があるわけではありません。これは会社や部署ごと、場合によっては顧客から指定があることもあります。

基本的には以下に示す内容を記載することが一般的であり、これにより過不足なく必要な情報を記載できます。

システムの目的や背景

まず要件定義書には、なぜそのシステムを必要とするのか、「システムの目的や背景」を記載します。こちらは文章や挿絵などを使って、できるだけわかりやすく記載します。

具体的には、以下の2点を記載します。

言い換えれば、「顧客の感じている課題」をいかにして抽出し、わかりやすく記載できるかは、SEとしての腕の見せどころと言えます。

システムの利用者や関連する人物

「システムの利用者」や「関連する人物」を洗いだして記載します。これは個人名などではなく、役職や役割の意味です（なお、社内資料などでは、担当者を整理したりします）。

これをおざなりにすると、以下のような問題が生じかねなません。

• 業務上の手続きに「もれ」が生じかねない
• 「誰が利用するか」を正しく想定しなければ、
  
  • システムに過不足が生まれかねない
  • ドキュメント（操作説明書や保守運用説明書）に過不足が生まれかねない
  • 教育・訓練の期間や、移行期間に過不足が生まれかねない

また場合によってはシステム化することで影響を受ける社員などが、それに反発をすることもあります。こうした例の多くは、ベンダー側（要はSEの所属する会社側）の不手際により、関連する社員への説明が不足している場合に起こります。

要件定義書に関連する人物をもれなく記載し、該当する社員に理解を得ることで、こうした問題を軽減できる効果も期待できるのです。

機能要件

• システムの概要（システム構成図、業務フロー）
• ユーザーが利用する機能一覧
• 画面設計（ワイヤーフレームの添付推奨）
• データベース設計（ER図、テーブル定義）

機能要件 - システム構成図

機能要件は主に「システム構成図」と「処理フロー図」を作成します。システム構成図とは、下記に挙げる内容を示した「システムの全体像を示した概念図」です。

機能要件 - 業務フロー図

業務フロー図は、顧客が業務を遂行するための工程や作業を図に示したものです。ポイントは「業務フロー図」を、システム導入の前と後で「両方作成すること」です。

大規模なシステムなどでは何十ページにも業務フロー図が及ぶこともあるため、片方のみに留めることも多くあります。

ユーザーが利用する機能一覧（サンプル）

システムの種類によって異なりますが、一般的なWebアプリケーションの機能要件としてよく使われるものを掲載しています。

画面設計（ワイヤーフレームの添付推奨）

画面設計では、システムのユーザーインターフェース（UI）を定義し、ユーザーがどのように操作するのかを明確にします。特に、ワイヤーフレームを活用することで、画面のレイアウトや構成を視覚的に把握しやすくなり、開発チームやクライアントとの認識のズレを防ぐことができます。

ワイヤーフレーム作成におすすめのツール

• Figma（クラウドベースでリアルタイム編集可能）
• Adobe XD（デザインとプロトタイピングに最適）
• Balsamiq（シンプルなワイヤーフレーム作成に向いている）

画面設計を適切に行うことで、ユーザビリティの向上だけでなく、開発チーム全体の効率も向上します。ワイヤーフレームの作成がまだの方は、早い段階で設計を進めることをおすすめします。

データベース設計

データベース設計は、システムで扱うデータを適切に管理し、効率的に運用するための設計プロセスです。具体的には、データの格納方法やテーブルの構成、リレーション（関連性）、インデックスの最適化などを決定し、パフォーマンスと整合性を考慮したデータベースの構築を行います。

適切なデータベース設計を行うことで、システムの動作速度を向上させ、将来的な拡張や変更にも柔軟に対応できるようになります。詳細な設計手順やベストプラクティスについては、以下の記事で詳しく解説しています。

Beエンジニア

駆け出しSE向け！データベース設計書の基本と実務活用

https://www.pmi-sfbac.org/basic-db-design-documents

🚀 「データベース設計書って何？どう作ればいいの？」エンジニアとして開発を進めるうえで、データの管理は非常に重要です。しかし、いざプロジェクトに入ると、「データベース設計書を書いて」と言われて戸惑う駆け出しSEは少なくありません。「そもそもデータベース設計書って必要なの？」「どんな項目を記載するべき？」「実務ではどう活用するの？」本記事では、データベース設計書の基本から、「これだけ押さえればOK！」という実務で役立つ書き方を解説します。 初心者でも逃げ出さないように、図やアイコンを交えてわか...

非機能要件

要件定義書には、作成する機能そのもの以外にも、記載が必要な項目があります。

例えば、システム完成後に提供されるサービスとは別に、保守やメンテナンスに関わる要件として「1回/週のバックアップ」や「定期的なログファイルの世代管理」など、「非機能要件」と呼ばれるものがその一つです。

この非機能要件は、主に顧客の規模や、導入するシステムの構成に依存します。作成したシステムの納品時には、これらの項目を全て満たしていなければならず、非機能要件を正しく見積もることは、SEの役目となります。

移行・運用・保守要件

要件定義書には、移行要件や運用要件に、保守要件なども記載します。

移行要件とは、すでに顧客が使用しているシステムがある場合、それを開発したシステムへ移行する場合の仕組みやその手順、そのための教育内容などのことです。

新規システムの場合、顧客がはじめて使用するシステムですので、そのシステムの習熟には時間がかかります。

運用要件は、そのシステムを安定的に動作させるために、下記の内容を定義したものです。

保守要件も似ていますが、こちらは下記のポイントを目的とします。

Beエンジニア

2 Pockets

システム運用とは？運用設計書に必要な記載項目を分かり易く解説！

https://www.pmi-sfbac.org/basic-operation-design-documents

一般的に「IT業界」≒「プログラマ」or 「インフラエンジニア」と捉えられることは至極普通なことだと思います。その証拠にIT業界へ転職を考えている方のほとんどが、ネットの検索蘭へ「IT プログラマ エンジニア 年齢」等の単語を入力してこのサイトへたどり着いています。現在ではコロナ禍の影響もあり、何処の企業も積極的な設備投資を控えるようになりました。以前のような「システム導入」フェーズから、少しでも長くシステムを延命するために「システム維持」フェーズへ移行する企業が増えてきたように思います。システムを維持す...

Beエンジニア

【作業品質改善】運用設計に必須な作成ドキュメントとは？【属人化排除】

https://www.pmi-sfbac.org/work-quality-improvement-equation

以前、システム運用とは「サーバーやネットワークがトラブルで停止しないようにシステムの管理・運用を行うこと」と述べました。まぁ、あながち間違いではないのですが、業務改善のコンサルを依頼されるたびに思うのは「その定義を少し改める必要があるのではないか？」と感じている事です。非情にジレンマに苛まれますが「顧客第一主義目線」の改善提案では、9割がた不採用となってしまいます。そこで、企業側の意図を見定めるために目線を変えたアプローチを行ったところ、某上場企業の社長様まで参加した一大プロジェクトになったこ...

要件定義書の作成ツール

近年では、要件定義を効率的に管理するためのツールが多く利用されています。以下のツールを活用することで、リアルタイムでの共有や変更管理が容易になります。

• JIRA - アジャイル開発向けのタスク・要件管理ツール
• Confluence - ドキュメント作成・共有ツール
• Google Docs / Notion - 共同編集可能なドキュメント管理

この記事を読んだら、次は 「基本設計書とは？ ポイントを抑えて分かりやすく解説！」 を読むのがおすすめです！

Beエンジニア

基本設計書とは？ ポイントを抑えて分かりやすく解説！

https://www.pmi-sfbac.org/basic-design-documents

「SE（システム・エンジニア）」は、顧客目線が大切です。その上で、社内でシステムを実際に開発する「PG（プログラマー）」へ、開発する内容を伝えることも重要です。そのために作成するのが、今回解説する「基本設計書」です。そこで今回は、基本設計書に関連する、以下の事項を解説します。「基本設計書」とは何か?「基本設計書」は誰がいつ作るのか?「基本設計書」はどんな内容を書くのか?📌 基本設計書とは？基本設計書は、システムの全体像を定義し、開発チームや関係者が共通認識を持つために作成されるドキュメント で...