軟體需求說明書主要描述軟體産品的功能,為設計、開發和測試以及産品相關人員的提供參考。軟體需求說明書采用什麼樣的形式能夠把功能描述清楚,如何讓使用人員盡快了解産品的功能,采用什麼樣的編寫方式,是軟體需求分析人員需要考慮的問題。經過最近的摸索和積累,個人覺得編寫需求文檔不一定要長篇大論,要多用表格和流程圖,并且至少包括以下内容:
一、目的
即使用場景描述,先用幾句話簡要概括做該軟體是用來解決什麼問題。不要一開始就描述功能,至少讓設計人員大緻了解該功能的使用目的。
二、涉衆
軟體是讓誰來使用,列舉所有可能使用到此功能的使用者或者角色。
三、功能清單
菜單樹,展示具體包含的子功能和上下級關系。由于不同類型使用者關注的重點可能不同,是以最好應給出各子功能中對應的預設使用者權限。
四、資料字典
清單描述功能涉及的字段名稱、資料類型、取值範圍、預設值、備注資訊等。
五、流程圖
描述使用者使用的正常流程和異常流程,如果涉及到狀态轉換最好給出狀态遷移圖。
六、UI
展示所涉及界面布局和原型,不必描述具體提示内容資訊,可以在字元串資源表中去定義。