软件需求说明书主要描述软件产品的功能,为设计、开发和测试以及产品相关人员的提供参考。软件需求说明书采用什么样的形式能够把功能描述清楚,如何让使用人员尽快了解产品的功能,采用什么样的编写方式,是软件需求分析人员需要考虑的问题。经过最近的摸索和积累,个人觉得编写需求文档不一定要长篇大论,要多用表格和流程图,并且至少包括以下内容。
一、目的
即使用场景描述,先用几句话简要概括做该软件是用来解决什么问题。不要一开始就描述功能,至少让设计人员大致了解该功能的使用目的。
二、涉众
软件是让谁来使用,列举所有可能使用到此功能的用户或者角色。
三、功能列表
菜单树,展示具体包含的子功能和上下级关系。由于不同类型用户关注的重点可能不同,所以最好应给出各子功能中对应的默认用户权限;
四、数据字典
列表描述功能涉及的字段名称、数据类型、取值范围、默认值、备注信息等;
五、流程图
描述用户使用的正常流程和异常流程,如果涉及到状态转换最好给出状态迁移图;
六、UI
展示所涉及界面布局和原型,不必描述具体提示内容信息,可以在字符串资源表中去定义;
七、相关影响
该功能对其他相关模块的影响,还有其他相关模块对此功能的影响;