JA

アプリの要件定義書:アプリの仕様書とは何か、なぜ承認するのか

最初に承認する1ページの仕様書:Deployflixブログ記事のカバー画像

アプリの要件定義書、つまりアプリの仕様書とは、誰かが作り始める前にまとめた、アプリの短い書面のプランです。誰が使うのか、それぞれが見る画面、保存する情報、連携するサービス、今回は見送るもの、ビルドにかかる費用の上限が書かれています。あなたはそれを読み、質問し、変更し、本当にほしいアプリが書かれていると確認できたときに初めて承認します。

先に承認するのは、仕様書が間違いを見つけるのに最もコストのかからない場所だからです。ページの1行を動かすのはタダです。ビルドが終わってから、講師が保護者全員の電話番号を見られることや、授業料を分割で支払えないことに気づけば、作り直しになります。

ソフトウェアの仕様書とは、わかりやすく言うと何ですか?

ソフトウェアにおける仕様書(大きなプロジェクトでは要件定義書、またはSRS(ソフトウェア要求仕様書)と呼ばれることが多い)は、アプリを必要とする人と、それを作る人との間の取り決めです。コードがどう動くかではなく、アプリが何をすべきかを書きます。お店、クラブ、学校なら、具体的でわかりやすい言葉で書かれていれば、たいてい1ページで十分です。

仕様書の良し悪しを確かめる方法は簡単です。別々の作り手が読んで、ほぼ同じアプリを作れるでしょうか?ページに生徒は成績を見られると書いてあれば、それは願望です。生徒は電話番号でログインし、自分のテストの点数を科目別に、クラス平均と並べて見られると書いてあれば、それは誰かが作れて、あなたが確認できる要件です。

1ページのアプリ要件定義書には、何を書きますか?

クラス、出席、授業料を管理するアプリがほしい学習塾を例にしましょう。役に立つ1ページの仕様書には、次の要素があります。

仕様書の項目書かれる内容学習塾の例
誰が使うかログインする人の種類と、それぞれができることオーナー、講師、生徒、保護者。授業料の合計を見られるのはオーナーだけ
ロール別の画面各ロールが見るページと、そこでできること講師:今日の授業、出席の記録、テストの点数の入力。保護者:出席、点数、支払うべき授業料
保存するデータアプリが保存する記録と、それぞれの中身生徒、クラス、授業ごとの出席、テストと点数、授業料の分割払いと領収書
連携連携する外部サービスと、その方法決済ゲートウェイでの授業料のオンライン決済と、分割払いごとの領収書
今回は見送るものこのバージョンでやらないこと時間割の重複チェックなし。昨年の記録の取り込みなし
費用の上限ビルドにかかる費用の上限作業後の見積もりではなく、承認前に示される上限額

ロール別の画面は、多くの人が読み飛ばす部分ですが、最も重要です。アプリは実際には、1つのデータを共有する複数のアプリです。オーナーの画面、講師の画面、保護者の画面。ロールごとに画面を読むことで、講師は出席を記録できるのに、誰もその間違いを直せない、といったことに気づけます。

今回は見送るものの行も同じくらい重要です。手に入らないものが何かを教えてくれるからで、ビルド後にがっかりする原因はたいていここにあります。短く正直な除外リストは、弱い仕様書ではなく、よい仕様書の証です。

Deployflixにアプリを説明すると、Deployflixが書く仕様書はこの形になります。誰がアプリを使うか、画面、保存するデータ、今回は見送るもの、ビルドにかかる費用の上限を、あなたが書いた言語でまとめます。説明にはっきりしない点があれば、プランを作る前に質問します。仕様書が手順のどこに位置するかは使い方でご覧いただけます。

アプリの仕様書は、どう読み、どう質問すればよいですか?

仕様書を契約書のように上から下まで読むのではなく、あなたのビジネスの1日のように読みましょう。

  1. 各ロールになったつもりで、実際の1日をたどる。何をタップし、何を見て、何を入力するでしょうか?ほかのすべてのロールについても同じことをします。
  2. 1つの記録を最初から最後まで追う。生徒、注文、予約を1つ選びます。誰がそれを作り、誰が変更し、誰が削除でき、最終的にどこに行き着くでしょうか?
  3. うまくいかない場合を探す。予約のキャンセル、返金、入力ミス、支払いの失敗、会員の退会。仕様書にうまくいく場合しか書かれていなければ、うまくいかないときにどうなるかを質問しましょう。
  4. 印刷する数字や言葉をすべて確認する。請求書の形式、授業料の分割払い、税金の行、領収書番号は、今のやり方と一致しているべきです。請求書にGST、VAT、売上税などの税金を記載する必要がある場合は、詳細を会計士に確認してください。
  5. あいまいな点はすべて質問する。管理する、追跡する、簡単、レポートといった言葉には、決めるべきことが隠れています。どのレポートで、何を表示し、誰のためのものかを質問しましょう。

承認する前に、どんな抜け漏れを探すべきですか?

うまくいかない仕様書の多くは、間違っているのではなく、不完全なのです。よく見られる抜け漏れは次のとおりです。

誰が何を見られるか

ロールは名前を付けるのは簡単ですが、あいまいなままにもなりがちです。各ロールが何をできるかだけでなく、何を見られるかを確認しましょう。講師は授業料を見られますか?保護者が別の子どもの点数を見られますか?スタッフが顧客リストをダウンロードできますか?アプリが個人情報を保存するなら、誰がそれを見られるかを今のうちに決めておきましょう。

編集、キャンセル、取り消し

どの記録も、いつかは修正が必要になります。誰が入力を編集・キャンセルできるか、元の値が残るかどうかが仕様書に書かれているか確認しましょう。

お金

アプリで決済を受け付ける場合、仕様書には決済の流れを記載しましょう。顧客が使える支払い方法(カードや地域の決済方法)、支払いの対象、一部のみの支払いを認めるか、支払い後に顧客が受け取るもの、未払い時や決済失敗時の対応を明確にします。返金ルールは事業者が決めることなので、ご自身のルールを書き出してください。決済代行サービスでは通常、取引額に対する一定割合の手数料がかかり、多くの国では固定手数料も加わります。利用するサービスの料金ページを確認しましょう。Deployflixのアプリは、RazorpayやCashfreeなどの決済代行サービスを通じて支払いを受け付けます。国際決済サービスにも近日対応予定です。現在連携できるサービスは、連携ページで確認できます。

メッセージとリマインダー

リマインダーを期待している場合は、メール、アプリ内、その他の方法など、どうやって相手に届けるかを書きましょう。仕様書に手段が書かれていなければ、その機能はないものと考えてください。

既存のデータ

スプレッドシートや古い台帳を、新しいアプリに移す必要があることはよくあります。その取り込みが仕様書に含まれているのか、今回は見送るリストに入っているのかを確認しましょう。

端末と言語

スマホ、店舗カウンターのパソコン、それとも両方で使いますか?英語に加えて、スペイン語、アラビア語、フランス語などにも対応する必要がありますか?こうした条件によって画面の設計が変わるため、構築前に決めておきましょう。Deployflixは指定した言語でアプリ内の文言を作成し、自体も41言語で利用できます。

なぜ、何かを作る前に仕様書を承認するのですか?

アプリを変えるより、一文を変えるほうが安く済むからです。ビルドの前なら、保護者のロールや授業料の分割払いを追加するのはページの編集にすぎません。ビルドのあとでは、同じ変更でも、すでに完成した画面、データ、権限に影響することがあります。

承認しておけば、完成したアプリを照らし合わせる基準もできます。ビルドが終わったら仕様書を開き、各ロール、各画面、各データを1つずつチェックしましょう。足りないものがあれば、正当に指摘できます。

仕様書では、実行を決める前に費用も明確になります。ビルド費用の上限が仕様書に記載されていれば、その金額を確認したうえで判断できます。Deployflixでは承認前にこの上限を表示し、実際のビルドで使用した分だけをお支払いいただきます。詳しくは料金ページで説明しています。

アプリができたあとの変更は、どう計画しますか?

アプリが完成することはめったにありません。新しいコース、2つ目の拠点、授業料の新しい集め方。どれも最初のビルドと同じくらい丁寧に扱う価値があります。

変更は、それ自体を小さな仕様書として計画しましょう。何が変わるのか、どのロールと画面に影響するのか、どんなデータが追加・変更されるのか、何が変わらないのか、費用はいくらかかるのか。同じ質問をしながら読み、作業が始まる前に承認します。以前のバージョンは残しておきましょう。そうすれば、変更がうまくいかなくても、動いていたバージョンに戻せます。

Deployflixも変更をこのように扱います。何を変えたいかを伝えると、Deployflixがその変更を次のバージョンとして計画し、承認されるまで何も作られません。以前のバージョンはすべて保存されます。組織では、セキュリティページで説明しているとおり、ロールで許可された人だけが承認できます。

使えるアプリ仕様書のテンプレート

仕様書を自分で書く場合は、次の見出しをコピーして、それぞれをわかりやすい文で埋めましょう。

  • アプリを一文で:誰のためのもので、どんな役割を果たすか。
  • ロール:利用者の種類ごとに、何を見られて何ができるか。
  • ロール別の画面:ロールごとの画面と、それぞれの画面で何をするか。
  • 保存するデータ:記録の種類ごとに、含まれる項目。
  • 連携:決済、独自ドメイン、アプリストア、コードの保管場所、その他つながるもの。
  • ルール:料金、上限、期限、キャンセル、返金。
  • 今回は見送るもの:このバージョンでやらないこと。
  • 費用の上限と承認:かかる費用の上限と、誰が承認するか。

ロール、画面、データの具体例は、学習塾のクラス管理システムENやクリニック予約アプリENをご覧ください。アイデアを試す創業者なら、スタートアップのMVPウェブアプリENのように、ロール1つ、画面数枚、見送るもののはっきりしたリストで、仕様書をさらに短くできます。

質問

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

主に長さと形式の違いです。大きなプロジェクトの要件定義書は、番号付きの要件が何ページにもわたることがあります。小規模事業者のアプリ仕様書は、同じ内容(誰が使い、何をし、何を保存するか)を1ページに、わかりやすい言葉でまとめます。

アプリの仕様書は誰が書くべきですか?

中身を出すのは、ビジネスを知っている人です。ロール、日々の業務、ルールなど。作り手はそれを整理された仕様書にできますが、それが正しいかどうかを判断できるのはあなただけです。

承認したあとに、仕様書を変更できますか?

はい。変更として扱いましょう。何が違うのかを説明し、更新されたプランを読み、もう一度承認します。比べたり元に戻したりできるよう、以前のバージョンは残しておきましょう。

アプリの仕様書は、どれくらいの長さにすべきですか?

大事なことが推測に任されない程度に長く、全部を読み通せる程度に短く。小規模事業者のアプリなら、ほとんどの場合1ページが適切です。それよりずっと長くなるなら、段階的に作ることを検討しましょう。

アプリを説明する

必要なことを自分の言葉で書いてください。Deployflixが費用を含む1ページのプランを書き、あなたが承認してから作り始めます。