1.0ハイブリッドテクノロジーズhttps://hybrid-technologies.co.jp/blogHT Blog Adminhttps://hybrid-technologies.co.jp/blog/author/ht_admin_blog/rich600338<blockquote class="wp-embedded-content" data-secret="qHv4dbIwwo"><a href="https://hybrid-technologies.co.jp/blog/knowhow/20230401/">アプリ開発における仕様書の概要と種類とは？要求書を書くときのポイントを解説</a></blockquote><iframe sandbox="allow-scripts" security="restricted" src="https://hybrid-technologies.co.jp/blog/knowhow/20230401/embed/#?secret=qHv4dbIwwo" width="600" height="338" title="“アプリ開発における仕様書の概要と種類とは？要求書を書くときのポイントを解説” — ハイブリッドテクノロジーズ" data-secret="qHv4dbIwwo" frameborder="0" marginwidth="0" marginheight="0" scrolling="no" class="wp-embedded-content"></iframe><script type="text/javascript"> /* <![CDATA[ */ /*! This file is auto-generated */ !function(d,l){"use strict";l.querySelector&&d.addEventListener&&"undefined"!=typeof URL&&(d.wp=d.wp||{},d.wp.receiveEmbedMessage||(d.wp.receiveEmbedMessage=function(e){var t=e.data;if((t||t.secret||t.message||t.value)&&!/[^a-zA-Z0-9]/.test(t.secret)){for(var s,r,n,a=l.querySelectorAll('iframe[data-secret="'+t.secret+'"]'),o=l.querySelectorAll('blockquote[data-secret="'+t.secret+'"]'),c=new RegExp("^https?:$","i"),i=0;i<o.length;i++)o[i].style.display="none";for(i=0;i<a.length;i++)s=a[i],e.source===s.contentWindow&&(s.removeAttribute("style"),"height"===t.message?(1e3<(r=parseInt(t.value,10))?r=1e3:~~r<200&&(r=200),s.height=r):"link"===t.message&&(r=new URL(s.getAttribute("src")),n=new URL(t.value),c.test(n.protocol))&&n.host===r.host&&l.activeElement===s&&(d.top.location.href=t.value))}},d.addEventListener("message",d.wp.receiveEmbedMessage,!1),l.addEventListener("DOMContentLoaded",function(){for(var e,t,s=l.querySelectorAll("iframe.wp-embedded-content"),r=0;r<s.length;r++)(t=(e=s[r]).getAttribute("data-secret"))||(t=Math.random().toString(36).substring(2,12),e.src+="#?secret="+t,e.setAttribute("data-secret",t)),e.contentWindow.postMessage({message:"ready",secret:t},"*")},!1)))}(window,document); //# sourceURL=https://hybrid-technologies.co.jp/blog/wp-includes/js/wp-embed.min.js /* ]]> */ </script> https://hybrid-technologies.co.jp/blog/wp-content/uploads/2023/01/people_who_develop_apps-scaled-thumbail-min.jpg312312アプリ開発に欠かせない書類の一つが仕様書です。アプリ開発の成功は仕様書の完成度にあるともいわれています。とはいえ、初めてアプリ開発に携わる場合、そもそも仕様書がどのようなものかわからないという方もいるでしょう。本記事では、アプリ開発の仕様書の概要、記載すべき情報、目的と重要性、種類、書き方などについて解説します。 ハイブリッドテクノロジーズの 開発サービスはこちら アプリ開発における仕様書とは？ アプリ開発に欠かせない仕様書とは、開発するWebシステムに必要な要求事項をすべてまとめた書類です。Webシステムを開発する過程では、成果物として完成するまでにさまざまな文書が作成されますが、その中でもプロジェクトのゴールを明確に示す仕様書は非常に重要です。具体的にどのような機能が必要であるか、どのページからどのページに遷移させるかなど、目指すアプリの姿を記したものです。その仕様書を開発にかかわるメンバー全員で共有することで、共同作業でありがちな認識のズレを防ぐことができます。 アプリ開発の企画プロセスとは？費用相場や発注元が知るとメリットがあるプログラミング言語の知識を解説 アプリ開発で仕様書を作成する目的・重要性 仕様書を作成する重要な目的は、開発者とクライアントの認識の齟齬をなくすことです。アプリを開発する際には、仕様の抜け漏れが生じないように、関係者間で認識のズレがないか注意することが大切です。 仕様書は、クライアントとの契約締結時の重要な書類でもあり、アプリの開発目的やイメージ、納期や予算、操作性などが具体的に記されています。満たすべき要求事項である仕様が曖昧であると、認識齟齬が生じてしまうため、開発において仕様書は必要不可欠な存在といえるでしょう。 仕様書があることで、開発者とクライアントは考え方や開発方法をすり合わせることができるので、開発者側の勝手な思い込みや相互の認識のズレをなくす手立てになります。仕様書がないと、開発途中で仕様変更が起きやすく、それに伴い工数が増えてしまいます。しかし、仕様書を作成することで、開発の際に追加費用や、追加で開発のすり合わせを実施する工数が発生するリスクを抑えられることは重要なポイントです。 仕様書と設計書の違い アプリ開発に欠かせない書類には、設計書もあります。仕様書と似たような言葉で混同しがちですが、その違いを把握しておきましょう。 アプリ開発における仕様書とは、アプリに求める姿を明確に示した書類です。一方、設計書とは求めるアプリのイメージを完成させるためにどのように実現するかを記載した書類になります。言い換えると、完成イメージを明確にしたものが仕様書で、完成までの制作工程を示したものが設計書です。 また、仕様書は発注者が作成しますので、誰にでもわかりやすい表現が使われている場合が多いですが、設計書はエンジニアが開発作業で使用するため、開発者側が専門用語を使い、手順などを細かく記載しているのが特徴です。 ただし、Webシステムに限りませんが、開発現場では仕様書と設計書が混同して使われていることがあります。 開発工程で作成される仕様書の種類 複数の工程にスタッフが携わるシステム開発では、仕様書は1種類だけではありません。 システム開発は、要件定義、基本設計、詳細設計という3つのフェーズにわかれますが、各段階で仕様書が必要です。それぞれ目的や記述する内容が異なり、発注側が作成するものもあります。 例えば、ウォーターフォール（Waterfall）型と呼ばれる日本で主流のシステム開発では、要件定義から計画立案まで行う上流工程ごとに仕様書があります。代表的なものとしては、要求仕様書、外部仕様書、内部仕様書などが挙げられます。要件定義以降はテスト仕様書も一緒に作成されることが多いです。 要求仕様書 要求仕様書とは、開発するアプリやシステムなどの機能、特徴、特性などをまとめたものです。技術的な要件を記載するのではなく、どんな課題を抱えていて、その課題を解決するために、このような仕様のアプリを求めている、など要求事項（アプリの目的、予算、納期など）を仕様として記述します。なお作成前に社内で要求事項についてコンセンサスを取っておく必要があります。 開発を希望するアプリに何を求め、どのようなゴールを達成したいのかを決定するのは、当然ですが、発注側のクライアントです。すなわち、要求仕様書は、要求定義フェーズで作成するものなので、クライアントの責任において作成します。 一方で、要件定義の段階で、クライアントではなく、開発会社側のSEがまとめる場合もあります。システムによっては、要求仕様書を作成しないで、要件定義書としてまとめて作成することもあるのです。しかし、その場合でも、具体的なアプリの目的、予算、納期などの要求事項はクライアント側が提示しなければなりません。 外部仕様書 外部仕様書は、要求仕様書を受けて開発者が機能やシステム構造を具体化した文書で、基本設計書とも呼ばれます。このフェーズでは、具体的にユーザーインターフェース（画面レイアウトを含む）、帳票、入出力データの種類など、機能面における要求がまとめられています。 外部仕様書の作成者は開発会社です。とはいえ、開発会社にすべてを任せてしまうのではなく、クライアントも外部仕様書の作成に積極的に関わりましょう。外部仕様書は外側から見えるシステムの機能の仕様についてまとめるため、発注側の意向を反映させる最後の機会といえます。 内部仕様書（詳細仕様書） 内部仕様書は、開発者が外部仕様書の内容をもとに機能の詳細を具体的に記載したもので、機能仕様書や技術仕様書に細分化されます。外部仕様書と異なり、システムの内部のデータ処理など、クライアントやユーザーに見えない部分についての仕様書です。基本的にシステム開発の担当者やプログラマー向けの文書なので、開発会社の責任で作成されます。外部設計で決めた機能を実装しやすいように分かりやすく記載する必要があります。 機能仕様書 機能仕様書（FSD）とは、ソフトウェアの開発で用いられる、アプリ開発に必要な要件をまとめるためのフォーマットです。要求仕様書の内容を実現するために、アプリ機能、動作環境、対応プログラミング言語について定義しています。クライアント側と開発側の認識齟齬の有無を確認するために用いられますので、開発会社のエンジニアがクライアントの要望を聞き取り作成します。 機能仕様書を作成する際に、記述漏れや見落としがあると、アプリ開発に支障が出てしまうため、構造的に要件を記述することが肝心です。そのためには、文と文の主従関係が分かりやすいように、書き方は箇条書きがおすすめです。主文でまず仕様を明確に記載してから、必要な情報を補足文で追加すると、簡潔な機能仕様書が完成します。 ただし作成するにあたって、デバイスやプラットホームについての知識に加えて、ソフトウェア開発の経験が必要となるケースも少なくありません。さらに、機能仕様書は、詳細にわたる記述が求められるため、作成時間が思いの外かかるケースもあります。 技術仕様書 機能仕様書をもとに、プログラムの実装を記載した仕様書で、プログラマーの間での認識の ズレがないように統一するために用いるものです。具体的には、プログラミングの土台となるデータ構造の設計、関係データベースの設計、機能のアルゴリズム、開発ツールなどを記載します。ただし、機能すべてについて作成する必要はなく、複雑な機能のみ作成します。 技術仕様書は、開発会社のエンジニアとクライアントが共同で作成する機能仕様書と違い、エンジニアがプログラマーと相談しながら進めていくのが一般的です。そのため技術仕様書ではクライアント側が協力できることはありません。また、技術仕様書はクライアント側に開示されることは、一般的にはありませんが、開発したアプリを自社で適切に運用していくために、開発会社に技術仕様書の提供を求めることもできます。 システム開発では、認識齟齬をなくすために、技術仕様書を作成し、定義や手法を明確にさせてから開発を進めることが重要です。 その他の仕様書 仕様書には、その他に、見積仕様書、購入仕様書、確定仕様書などがあります。それぞれどんな内容の文書か見ていきましょう。 購入仕様書 購入仕様書とは、簡単に言うと、物品購入について買い手が記載した説明書のことです。つまり、希望するアプリやシステムなどについて、発注者が受注者に要求する文書になります。要求する機能についてのみわかりやすく記載し、手段などの要求は受注者に任せるのが一般的です。また、懸案事項は明確にしますが、「詳細は協議で決定」というように記載すると、制作後に起こるトラブルを回避しやすくなるでしょう。 見積仕様書 見積仕様書は、売り手が製品の説明と見積金額を提示する書類です。購入仕様書に記載されている発注者の要望を考慮に入れながら、実現できる仕様と金額を記載します。発注者は発注先を決める際に、複数の取引先の見積仕様書を比較検討することができます。 確定仕様書 発注者が見積仕様書を比較検討して選んだ受注者に対して、制作を希望するために、最終提案内容を提示する文書のことです。内容は契約書とあまり変わりませんが、価格や仕様、数量など、項目は契約書よりも細かく記載します。 プログラム仕様書 プログラムの目的や定義、構成などを記載した文書です。製品を開発する技術者に周知するために仕様についてまとめたものです。 仕様書の種類と作成者 アプリ開発では初期の段階で複数の仕様書が作成されますが、各仕様書の作成者を確認しておきましょう。以下の表にまとめました。 仕様書の種類 […]