需求规格说明书
国内对于需求说明书的格式并没有一套标准规范,每家公司有每家公司自己的需求说明书格式,在我从事的三家公司,我写过三种格式不同的需求说明书,这样造成的一个后果就是因为没有一套标准格式的需求说明书,假如去其他公司的话,又得抛弃原有的书写格式,重新习惯其他公司的需求说明书格式。
这样,对于一个有经验的需求分析师而言,在书写需求说明书这块,他就会和新人没有什么差别,无优势可言。
只有不断的总结,才能进步。
一、文档结构
1. 首页
先说需求说明书的首页,首页展示本公司的基本信息、需求说明书的标题,如XX产品需求规格说明书,和文档编号、编写人、模块名称、部门、保密等级、日期、版权说明等。
2. 修订页
修订页的作用是记录需求说明书版本的变更,在跟客户沟通需求的时候,需求可能会变更,每一次修订,都需记录下来,作为留痕。
修订页展示的内容包括编号、章节名称、修订内容简述、修订日期、修订前版本号、修订后版本号、修订人、批准人。
3. 目录
目录即是需求说明书正文的内容,包含了引言、项目概述、业务需求、附录。
(1)引言:展示编写目的、范围、定义和参考资料。
编写目的:说明编写这份软件需求说明书的目的,指出预期的读者范围。
范围:待开发的软件系统的名称;说明软件将干什么,如果需要的话,还要说明软件产品不干什么;描述所说明的软件的应用,尽可能精确地描述所有相关的利益、目的、以及最终目标。
定义:列出本文件中用到的专门术语的定义和缩写词的原词组。
(2)项目描述:如果是项目需求,简要描述一下项目的概况,如项目的背景,项目的周期等等。
产品描述:叙述该项软件开发的意图、应用目标、作用范围以及其他应向读者说明的有关该软件开发的背景材料。如果开发的系统与其他系统有对接,则还应该本系统与其他系统之间的关系,用方框图表示。
产品功能:系统包含的模块,并简要描述下各模块的功能。描述产品功能模块的作用是将系统的范围定义清楚,一共有多少个模块,以便甲乙两方明确本次项目的边界。
(3)业务需求:用户提出的需求
功能介绍:描述功能要达到的目标、所彩的方法和技术,还应清楚说明功能意图的由来和背景。
流程图:如果涉及到流程,除了文字以外,还需附上流程图
数据项描述:展示字段、字段类型(文本、日期、数值、枚举值等)、数据来源、备注,开发看到数据项描述能定义数据库表中的字段。
界面展示:原型图输出,用原型图方式呈现文字描述的功能,每张原型图下面可以备注功能的路径,以便开发明白该原型图在哪个模块的哪个菜单。
(4)附录:对一个实际的需求规格说明来说,若有必要应该编写附录。
附录包括有助于理解需求说明的背景信息、用户历史、背景、经历和操作特点、原始需求、需求调研记录等等。需要注意的是当包括附录时,需求说明必须明确地说明附录只作为参考,不作为正式的需求。
因为有时候一些原始需求,在需求沟通过程或者其他原因,可能会不做,原始的需求和正式要开发的需求不一定是相同的,所以要用文字说明附录不作为正式开发的需求,也不作为验收的标准。
最后,如果需求说明书需要用户签名,还需在后面写上用户公司名称、日期,以及本公司名称和日期。
以上是文档结构部分,为了使一份需求说明书看起来专业,还需注意细节部分。
二、文档细节
页眉页脚: 页眉注明是XX公司的需求说明书;页脚要编写页码,如第几页,但是首页不要页眉页脚。
字体字号:正文的字体建议用宋体,字号用5号。需求说明书不要出现3种字体。
行距:1.5倍行距
需求说明书可以向开发和用户展现需求分析师的实力,专业的需求说明书能体现需求分析师的专业水平,可以说需求说明书是需求分析师的一件“外衣”,专业的需求分析师写出的需求不仅是用户开发能看懂,而且整篇文档的结构完整,细节也相当注意。
相关阅读
非常清晰完整的需求文档,刚开始看的时候差点以为是内部的PRD文件来着。很有想法,推荐你也阅读一下,不论是方法论还是想法很多都可以
智能音箱虽有IoT梦想,更像是小资情怀, 不及儿童智能机器人那般刚需、打动人心。今年智能音箱意外成为国内科技圈最热门的风口之一,肇
我相信,SEO人员都太熟悉“百度指数”了。 因为不管打算做什么关键词,大家都会先把这个关键词丢到“百度指数”去搜索一下,看看是不是
撰写BRD是产品经理或者说想表达自己想法的人,尤其是需要宣讲和汇报工作的人必备的硬技能,今天这篇文章就教大家怎么来系统地写商业
需求来源于痛点,但需求并不等于痛点,我们需要判断的是痛点是否为可转化为用户需求。作者总结了几个判断维度,与君分享。在之前《需求