アプリの仕様書の書き方|外注・開発前にまとめておく項目

アプリの仕様書の書き方と外注前にまとめておく項目を解説する記事のアイキャッチ。打合せテーブルの手描きの画面の流れとスマホ

当サイトの記事は編集部が国土交通省・IPA・デジタル庁などの公的機関の情報、規格や業界団体の公開情報を調べて独自に執筆しています。記事内にIT・Webエンジニアの転職サービスへの案内(広告)を含みます。

自社のアプリを作ることになり、開発会社に頼む前に『まずは仕様書をまとめてください』と言われた。でもITに詳しくないので、何から書けばいいのか分からない。そんな方も多いはずです。

結論から言うと、アプリの仕様書は「誰が使う」「何ができる」「どの画面」「どこまで作る(今回やらない事)」の4つを書けば、最初の打合せには十分です。細かい設計は開発会社と一緒に詰めていけば大丈夫です。

この記事を読めば、アプリの仕様書に書く項目と、外注前に決めておくことが分かります。

目次

アプリの仕様書とは?要件定義書・設計書との関係

先に結論

アプリの仕様書は、作りたいアプリの中身を、作る人に伝えるための文書です。発注する側が書くのは「何をしたいか」まで。「どう作るか」は開発会社が設計書にまとめます。

アプリの仕様書という言葉は、場面によって指す物が少しずつ違います。発注前に発注側がまとめるメモのような物から、開発会社が作る詳しい設計書まで、幅広く呼ばれているんです。

『結局、自分はどこまで書けばいいの?』と迷いますよね。まずは、誰がどの文書を書くのかを見てみましょう。

文書主に書く人書く中身
発注前の仕様のまとめ発注側アプリで何をしたいか、誰が使うか
要件定義書発注側と開発会社アプリに必要な機能や守るべき決まり
設計書(画面・データなど)開発会社画面の項目や動き、データの持ち方
テスト仕様書開発会社何をどう確かめるか

デジタル庁のDS-100では、要件定義書の機能要件として、機能・画面・帳票・データ・外部インタフェースに関する事項を定めるとしています。アプリでも、要件定義書には同じような項目が並ぶと考えておくとイメージしやすいですよ。

要件定義書の中身や作り方は、要件定義書とは?で詳しく紹介しています。

アプリの仕様は4つで書けば伝わる

ここが大事

発注側がまとめる仕様は「誰が使う」「何ができる」「どの画面」「どこまで作る(今回やらない事)」の4つです。特に「今回やらない事」を書いておくと、見積もりのずれや作り直しがぐっと減ります。

ITに詳しくない方ほど、機能のアイデアをたくさん並べてしまいがちです。でも、作る人が一番知りたいのは「誰のために、どこまで作るのか」なんですよね。

そこで編集部では、アプリの仕様を4つに分けて書く表を作ってみました。

書くこと書く中身書き方の例
誰が使う使う人の種類と、使う場面店舗のお客さんが、来店前にスマホで予約する
何ができるアプリでできることの一覧空いている時間を見る、予約する、予約を取り消す
どの画面必要な画面と、その流れトップ、空き状況、予約の入力、予約の確認、完了
どこまで作る今回作る範囲と、今回やらない事支払いはアプリで扱わない。お知らせの配信は次の段階
アプリの仕様を誰が使う・何ができる・どの画面・どこまで作るの4つに分けて書く表の図解

「今回やらない事」がいちばん大事

『あれもこれも入れたい』と思うのは自然なことです。ただ、範囲が決まっていないと、開発会社は一番大きな範囲で見積もるしかありません。

例えばこんな書き方にしておくと、話がぐっと早くなります。

「今回は予約の受付だけを作る。支払い、ポイント、お知らせの配信は、使われ方を見てから次の段階で考える。」

範囲を外した物も書いておくと、後から『入っていると思っていた』という食い違いを防げますよ。

4つを埋める時の自分への質問

『表を見ても、何を書けばいいか浮かばない』という時は、自分に質問してみるのが近道です。答えをそのまま書けば、それが仕様のたたき台になります。

書くこと自分への質問の例
誰が使う一番よく使うのは誰? その人はどこで、いつ開く?
何ができる今、電話や紙でやっている作業のうち、アプリに任せたい物はどれ?
どの画面使う人は、開いてから終わるまでに何回画面を切り替える?
どこまで作る最初の版で無くても困らない機能はどれ?

例えば「今は予約を電話で受けて、紙の台帳に書いている」と答えが出たら、それがそのまま「何ができる」の一行目になります。

今の作業のやり方を書き出しておくと、開発会社も業務の流れをつかみやすくなりますよ。

Webアプリ・スマホアプリの仕様書テンプレート

先に結論

Webアプリでもスマホアプリでも、仕様書のテンプレートの骨組みは同じです。違うのは、動かす場所と、配信や更新のやり方に関する項目です。

仕様書のテンプレートを用意しておくと、書き漏れが減ります。ここでは、発注前にまとめる仕様書の骨組みを紹介しますね。

章書く中身書き方のコツ
目的アプリを作る理由と、うまくいった状態「予約の電話を減らしたい」など困りごとから書く
使う人使う人の種類、人数の見込み、使う場面お客さん用と管理者用を分けて書く
できること機能の一覧と、優先順位「今回」「次の段階」に分ける
画面画面の一覧と、手描きの画面の流れ似たアプリの画面を参考に描いてもよい
データ登録する情報、ほかのシステムとのつながり今使っている台帳やシステムを書く
守ること個人情報の扱い、使える時間帯、使いやすさ分からない所は開発会社に相談すると書く
範囲と体制今回やらない事、担当者、希望の時期決まっていない事は「未定」と書く

画面の一覧や画面の流れの書き方は、画面設計書・画面仕様書の書き方でもっと詳しく紹介しています。

Webアプリとスマホアプリで足す項目

『Webアプリとスマホアプリで、仕様書の書き方は変わるの?』と思う方もいますよね。骨組みは同じで、次の項目を足すイメージです。

項目Webアプリスマホアプリ
動かす場所使うブラウザ、パソコンとスマホのどちらで見るか対応する端末の種類と、OSの版の考え方
配る方法URLを開くだけアプリの配信ストアへの登録
更新のやり方サーバー側を直せば全員に反映利用者に更新してもらう必要がある
端末の機能ほぼ使わないカメラ、位置情報、通知などを使うか

Webサイトの制作に近い場合は、Webサイト制作の仕様書・要件定義書の項目も参考になります。

外注する前に決めておくこと

先に結論

外注の前に決めておくのは「誰が決めるか」「何を渡してもらうか」「どう確かめるか」の3つです。仕様書の中身と同じくらい、進め方の取り決めが大事です。

アプリの外注でもめやすいのは、作り始めてから『思っていたのと違う』となる時です。仕様書を書いたら、次の順番で開発会社と詰めていきましょう。

外注前の進め方
  1. この記事の4つと、テンプレートの骨組みで仕様をまとめる
  2. 複数の開発会社に同じ仕様書を渡して、提案と見積もりをもらう
  3. 選んだ会社と、要件定義書の形に仕上げていく
  4. 画面の流れや見た目を、作り始める前に見せてもらう
  5. 何をもって完成とするか、確かめ方を決めておく

見積もりを比べる時は前提をそろえる

複数の会社から見積もりをもらう時は、同じ仕様書を渡すのがポイントです。渡す内容がばらばらだと、金額の差が中身の差なのか、前提の差なのか分からなくなってしまいます。

見積もりを比べる時の考え方は見積仕様書とは?、発注の仕様書の書き方は発注仕様書とは?でも紹介しています。

開発会社に渡す前のチェック
  • 使う人と使う場面が書いてある
  • 機能に「今回」「次の段階」の優先順位が付いている
  • 今回やらない事が書いてある
  • 画面の一覧と、ざっくりした流れがある
  • 決める人(窓口)が1人に決まっている
よくある失敗

打合せのたびに口頭で機能を足していくと、何が決まったのか誰も分からなくなります。追加や変更は、仕様書に書き足して版を上げる形にしておきましょう。

仕様書を作成するアプリやツールは?

仕様書は、ExcelやWord、文書を共有できるツールなど、ふだん使っている物で十分作れます。画面の流れは、紙に手描きして写真で渡す方法でも伝わりますよ。

道具選びの考え方は、仕様書の作成ツールで比べています。

アプリの仕様書でよくある相談

先に結論

よく見かけるのは「ITに詳しくない会社でも仕様書を書けるか」「素人でも仕様書を用意できるか」「仕様と違うアプリができた時どうするか」の3つです。どれも、4つの項目と取り決めを文書に残すことが助けになります。

よく見かける相談を、内容をまとめた形で紹介します。

相談1:ITに詳しくない会社でもスマホアプリの仕様書は書ける?

ITに全く詳しくない会社なのに、スマホアプリを出す予定が決まってしまった。仕様書の書き方を知りたい、という相談です。

専門用語で書く必要はありません。この記事の4つを、ふだんの言葉で書けば十分です。技術的な所は「分からないので相談したい」と書いておけば、開発会社が要件定義の中で一緒に決めてくれます。

似たアプリで「ここが使いやすい」と感じた画面があれば、どこが良いと思ったかを書き添えておくのもおすすめです。言葉で説明しにくいことも、ぐっと伝わりやすくなりますよ。

相談2:プログラミングの素人でも仕様書を用意できる?

プログラミングは素人だけれど、作りたいアプリの仕様書(設計図)がほしい、という相談もあります。

発注側が用意するのは、設計図ではなく「何をしたいか」のまとめで大丈夫です。設計図にあたる設計書は、作る側の仕事です。まずは4つの表を埋めて、作る人に見せてみてください。

相談3:仕様と違うアプリができた時はどうする?

外注したら仕様と違うアプリができた。お金を払う必要はあるのか、という相談も見かけます。

こういう時に頼りになるのが、仕様書と契約書です。何を作ると約束したか、何をもって完成としたかが文書に残っていれば、話し合いの土台になります。支払いの扱いは契約の内容によって変わるので、契約書を確かめたうえで、必要なら専門家に相談してみてください。

アプリの仕様をまとめる経験を仕事に活かす

使う人の困りごとを聞いて、作る人に伝わる文書にまとめる力は、システム開発の要件定義や社内SEの仕事とも共通しています。

今の仕事でアプリの発注を担当しながら経験を積むのも、立派な道です。そのうえで、ITの仕事に興味が出てきた方は、求人の仕事内容を比べてみると道が見えてきますよ。

打合せテーブルで、手描きのアプリの画面の流れを描いた紙とスマホ、ノートPCを並べている

IT・Webエンジニアの転職(PR)

仕様書を書く経験を活かせる職場を探すなら、求人も比べてみる

要件定義や設計を任されるか、発注側か開発側か、扱うシステムや働き方は会社によって大きく違います。担当したい工程や条件から、IT・Webエンジニアの求人を比べてみてください。

無料ITエンジニアの求人を探す

求人の条件・待遇は各求人票と応募先の案内でご確認ください。

仕様書と要件定義書・設計書の違いをもう一度確かめたい方は、仕様書とは?意味と目的、設計書・要件定義書との違いを見てみてください。

よくある質問

アプリの仕様書には何を書けばいいですか?

発注前なら「誰が使う」「何ができる」「どの画面」「どこまで作る(今回やらない事)」の4つが基本です。目的や守ることも書いておくと、開発会社が提案しやすくなります。

アプリの要件定義書と仕様書は違いますか?

発注前の仕様のまとめをもとに、発注側と開発会社が一緒に仕上げるのが要件定義書です。仕様書という言葉はもっと広く使われ、設計書まで含めて呼ぶこともあります。

Webアプリとスマホアプリで仕様書のテンプレートは変わりますか?

骨組みは同じです。スマホアプリでは、対応する端末、配信ストアへの登録、更新のやり方、カメラや通知などの端末の機能を足して書きます。

仕様書をまとめる時間がない時はどうすればいいですか?

まずは4つの表だけ埋めて、開発会社との打合せに持っていきましょう。足りない所は打合せで聞かれるので、その答えを書き足していけば仕様書が育っていきます。

設計書も発注側で書く必要がありますか?

いいえ、設計書は一般的に開発会社が作ります。発注側は、設計書の画面の流れや項目が、仕様書で伝えたことと合っているかを確かめましょう。

まとめ

この記事の要点
  • アプリの仕様書は、発注側が「何をしたいか」を伝える文書
  • 誰が使う・何ができる・どの画面・どこまで作るの4つで書く
  • 「今回やらない事」を書くと、見積もりのずれが減る
  • Webアプリとスマホアプリは骨組みが同じで、足す項目が違う
  • 追加や変更は仕様書に書き足し、版を上げて残す
仕様書ドットコム

仕様書ドットコム 編集部

仕様書の意味・種類・書き方から、システム開発の要件定義書・設計書・テスト仕様書、公共工事の標準仕様書・共通仕様書、住宅や発注の仕様書、仕様書を書く仕事のキャリアまでを、初めて仕様書に向き合う人が自分で判断できるように整理している情報サイトです。 公式サイト

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次