應用程式需求文件:規格是什麼及為何要核准

您先核准的單頁規格:Deployflix 部落格文章封面

應用程式需求文件(也就是應用程式規格)是在任何人開始建置前,先寫好的簡短方案:包括誰會使用、每種使用者會看到哪些畫面、會保存哪些資訊、會連接哪些服務、目前不包含哪些項目,以及建置費用上限。您可以閱讀、提出疑問並修改,直到內容確實符合您想要的應用程式,才進行核准。

要先核准,是因為規格是找出錯誤成本最低的階段。在頁面上移動一行文字不花任何錢。若等建置完成後才發現家教老師能看到每位家長的電話號碼,或費用不能分期支付,就得重新建置。

用簡單的話來說,什麼是軟體規格?

在軟體領域,規格(大型專案中通常稱為需求文件,或稱 SRS,也就是軟體需求規格)是需要應用程式的人與建置方之間的共識。它說明應用程式必須做什麼,而不是程式碼如何做到。對商店、俱樂部或學校來說,只要內容具體且文字淺顯,一頁通常就夠了。

檢驗規格的方法很簡單:兩位不同的建置者讀完後,能做出大致相同的應用程式嗎?如果頁面只寫著學生可以查看成績,那只是一個願望。如果寫的是學生用手機號碼登入後,可以依科目查看自己的考試成績,旁邊並列班級平均成績,這才是能實際建置、也能驗收的需求。

單頁應用程式需求文件應該包含什麼?

以一間需要管理課程、出缺勤和費用的補習班為例。一份實用的單頁規格應包含以下部分:

規格項目內容補習班範例
誰會使用每種登入角色,以及各自可以做什麼負責人、老師、學生和家長;只有負責人能查看費用總額
各角色的畫面每個角色會看到哪些頁面,以及能在其中做什麼老師:查看今天的課程、登記出缺勤、輸入考試成績。家長:查看出缺勤、成績和待繳費用
儲存的資料應用程式會儲存哪些紀錄,以及每筆紀錄包含什麼學生、課程、每堂課的出缺勤、考試與成績、分期繳費和收據
整合會連接哪些外部服務,以及如何連接透過支付閘道線上繳費,每期款項都有一張收據
目前不做這個版本不會做什麼不檢查課表衝堂;不匯入去年的紀錄
費用上限這次建置的最高費用核准前就顯示最高金額,而不是完工後才提出預估

大家通常會快速略讀「各角色的畫面」,但這其實是最重要的部分。一個應用程式其實是多個共用同一套資料的應用程式:負責人的畫面、老師的畫面和家長的畫面。依角色逐一閱讀各個畫面,您才會發現老師雖然能登記出缺勤,卻沒有人能更正其中的錯誤。

目前不包含這一項同樣重要。它清楚說明您不會得到哪些功能,而這通常正是建置完成後產生失望的原因。簡短而坦白的排除項目,代表規格寫得好,而不是規格不夠完整。

當您向 Deployflix 描述應用程式時,它會依照這個架構撰寫規格:誰會使用、有哪些畫面、會保留哪些資料、目前不包含什麼,以及建置費用最高是多少,並使用您原本輸入的語言。如果您的描述不夠清楚,它會先提問,再開始規劃。運作方式會說明規格位於整個流程的哪個階段。

如何閱讀應用程式規格並提出問題?

不要像讀合約一樣從頭到尾閱讀規格,而要把它當成企業實際運作的一天來看。

  1. 以每個角色的身分走過真實的一天。他們會點什麼、看到什麼、輸入什麼?接著對其他每個角色做同樣的檢查。
  2. 從頭到尾追蹤一筆紀錄。選一位學生、一筆訂單或一項預約。誰建立它、誰修改它、誰能刪除它,最後它會到哪裡?
  3. 查看不順利時的流程。例如預約取消、退款、輸入錯誤、付款失敗或會員離開。如果規格只描述一切順利的情況,就要問清楚出問題時會怎麼處理。
  4. 檢查每個會列印出來的數字和文字。發票格式、分期繳費、稅額項目和收據編號,都應符合您目前的作業方式。如果發票必須列出 GST、加值稅或銷售稅等稅項,請向您的會計師確認詳細內容。
  5. 任何模糊的地方都要問清楚。像是管理、追蹤、簡單和報表等詞,背後都藏著尚未決定的細節。請問清楚:是哪一份報表、要顯示什麼、給誰看?

核准前應該檢查哪些缺漏?

多數出問題的規格並沒有寫錯,而是寫得不完整。以下是最常見的缺漏。

誰能看到什麼

角色很容易命名,權限卻很容易寫得模糊。除了能做什麼,也要檢查每個角色能看到什麼。老師能看到費用嗎?一位家長能看到其他孩子的成績嗎?員工能下載客戶名單嗎?如果應用程式會保存個人資料,現在就決定誰能查看。

編輯、取消與復原

每筆紀錄總有一天可能需要更正。請確認規格有說明誰能編輯或取消紀錄,以及是否會保留原本的值。

款項

如果應用程式會收款,規格就應列出付款流程:客戶可使用哪些付款方式(信用卡與當地付款方式)、付款項目、是否允許支付部分款項、付款後客戶會收到什麼,以及未付款或付款失敗時如何處理。退款規則屬於企業經營決策,請將您的規則寫清楚。金流服務通常按每筆交易金額的一定比例收費,在許多國家還會加收固定費用,請查看您使用的金流服務價格頁面。Deployflix 應用程式透過 Razorpay 或 Cashfree 等金流服務收款;國際金流服務即將推出。我們的整合頁面列出了目前可串接的服務。

訊息與提醒

如果您需要提醒功能,請註明要如何通知使用者:透過電子郵件、應用程式內通知,或其他方式。如果規格沒有提到通知管道,就應視為沒有這項功能。

您現有的資料

試算表和舊登記簿裡的資料,通常需要移到新的應用程式。請確認匯入這些資料是否包含在規格內,或被列在目前不包含的項目中。

裝置與語言

使用者會用手機、店內櫃台的電腦,還是兩者都會使用?除了英文,是否還需要西班牙文、阿拉伯文、法文或其他語言?這些選擇會影響畫面設計,因此應在建置前決定。Deployflix 會以您指定的語言撰寫應用程式中的文字,本身也支援 41 種語言。

為什麼要在開始建置前核准規格?

因為修改一句話,比修改一個應用程式便宜。在建置前,新增家長角色或分期繳費,只需要編輯頁面。建置完成後,同樣的變更可能會影響已完成的畫面、資料和權限。

核准規格後,您也有一份可用來驗收成品的依據。建置完成時,請開啟規格並逐項核對:每個角色、每個畫面、每項資料。只要有所遺漏,您都可以合理提出。

規格也會在您決定投入前確認費用。當建置費用上限寫在規格上,您就能看著明確的數字做決定。在 Deployflix,這個上限會在您核准前顯示,而您只需支付建置實際使用的費用,詳情請見價格方案頁面。

應用程式建置完成後,要如何規劃變更?

應用程式很少真正完工。新增課程、開設第二個據點,或採用新的收費方式:每項變更都值得像第一次建置一樣仔細規劃。

請把每次變更當成一份獨立的小規格來規劃:要改什麼、會影響哪些角色和畫面、要新增或修改哪些資料、哪些部分維持不變,以及最高費用是多少。用同樣的問題審閱,並在開始動工前核准。保留先前的版本,這樣如果變更出了問題,就能回到原本可正常運作的版本。

Deployflix 會這樣處理變更:您說明要改什麼,它會把變更規劃為下一個版本,並且只有在核准後才開始建置。所有先前版本都會保留。在組織中,只有角色權限允許的人才能核准,詳情請參閱安全性頁面。

可直接使用的應用程式規格範本

如果您要自行撰寫規格,可以複製以下標題,並用簡單的句子填寫各項內容:

  • 用一句話說明應用程式:它是為誰而做,以及要完成什麼工作。
  • 角色:每種使用者,以及他們可以看到和進行哪些操作。
  • 各角色的畫面:分別列出每個角色會看到的畫面,以及每個畫面能做什麼。
  • 儲存的資料:每種紀錄,以及其中包含的詳細資料。
  • 整合:付款、您的網域、應用程式商店、程式碼的存放位置,以及其他需要連接的服務。
  • 規則:費用、限制、期限、取消和退款。
  • 目前不包含:這個版本不會做什麼。
  • 費用上限與核准:最高費用是多少,以及由誰核准。

如需查看包含角色、畫面和資料的完整範例,請參考補習班班級管理系統EN或診所預約應用程式EN。正在測試想法的創辦人可以把規格寫得更短,只包含一個角色、幾個畫面,以及明確的排除項目,就像新創 MVP 網頁應用程式EN一樣。

常見問題

應用程式規格和需求文件有什麼不同?

主要差別在長度和正式程度。大型專案的需求文件可能包含多頁編號需求。小型企業的應用程式規格則用簡單的文字,在一頁內涵蓋相同內容:誰會使用、能做什麼,以及會保存哪些資料。

應用程式規格應該由誰撰寫?

熟悉企業運作的人負責提供內容:有哪些角色、日常工作流程和規則。建置者可以把這些內容整理成結構清楚的規格,但只有您能判斷內容是否正確。

核准後還能修改規格嗎?

可以。把它當成一次變更:說明不同之處、閱讀更新後的規劃,然後再次核准。請保留先前的版本,方便比較或還原。

應用程式規格應該多長?

要長到不必猜測任何重要細節,也要短到您願意完整讀完。對大多數小型企業應用程式來說,一頁最合適;如果篇幅長得多,可以考慮分階段建置。

描述您的應用程式

用自己的話寫下您的需求。Deployflix 會撰寫一份附有費用的單頁規格,並在您核准後才開始建置。