软件需求规格说明书如何写

14
第14章 需求规格说明书
2 需求规格说明文档 需求规格说明文档常见的写作风格
形式化描述：如果说图形化模型比自然语言表达的精 确度更高的话，则形式化描述比图形化模型更高一些。 对于逻辑性很强，精度要求很高的场合，形式化规格 描述是一种不错的选择。 优点：严谨、精确。 缺点：编写和阅读的人都会感到很困难。 建议：形式化规格语言为主，辅以图形化模型和自然 语言。一般很少采用，即时采用也是在局部。
业务环 节： 税收管理员 业务名称 户籍管理
编 写 人： 张三 审 核 人： 李四 批 准 人： 王五
编写日期： 2008-2-20 审核日期： 2008-3-10 批准日期： 2008-3-20
XX地税信息中心 ABC软件公司税务事业部
17
第14章 需求规格说明书
2 需求规格说明文档 示例-目录 1.概述 2.开业登记管理 2.1.业务规范 2.2.操作岗位 2.3.业务处理流程图 2.4.业务处理流程描述 2.4.1.前臵条件 2.4.2.基本流程 2.4.3.分支流程 2.4.4.后臵条件 2.5.特殊需求说明 2.6.相关业务环节 2.7.业务表单
2 需求规格说明文档 示例-概述
需求规格说明文档常见的模板
1 概述 税收管理员户籍管理包括开业登记管理、停业登 记管理、登记变更管理、非正常户管理、非正常解除管 理、纳税人跨区迁移管理、外来报验管理、巡查管理、 验、换证管理九部分内容。户籍管理部分以税收管理员 为核心，论述了其在户籍管理中执行的全部职责。
13
第14章 需求规格说明书
2 需求规格说明文档 需求规格说明文档常见的写作风格 图形化模型：图形化模型在表述时能够给读者提供更强的视觉效 果，同时能够使问题更加聚焦。在日常交流中，我们经常会绘制 一些非标准的示意图，以便更好地进行沟通。 优点：可视化、聚焦性，易于理解。 缺点：编写和阅读的人都需要能够正确地理解模型，所以一般 SRS不可能完全采用复杂模型。 建议：图形化模型为主，辅以自然语言，需要的地方少量使用形 式化规格描述。RUP(Rational Unified Process)统一开发过程推 荐该方法，需求管理会更加方便。对双方的技术性要求比较强。
有问题 送达回证
否 录入岗
是否由于纳税 人原因造成 是 是否涉及变更 登记内容
否
直接修改 是 是
是否涉及税务 登记证件修改
是
否 通知纳税人到大厅 录入岗做相应修改 结束 结束
21
第14章 需求规格说明书
2 需求规格说明文档
需求规格说明文档常见的模板
示例-内容 税种鉴定核查、征收方式核查
税务机关内部 税收管理员
第14章 需求规格说明书
2 需求规格说明文档 示例-内容 2.4.2 基本流程
需求规格说明文档常见的模板
税务登记核查、财产税登记核查 （5）如果税收管理员实地核查结果与纳税人填报的信息不一致，并且通 过税收管理员调查，不一致的原因是由于纳税人填报错误造成的，并且变 更内容不涉及变更登记内容，税务机关有权直接修改的，税收管理员将不 一致信息反馈给录入岗。 （6）如果税收管理员实地核查结果与纳税人填报的信息不一致，并且通过 税收管理员调查，不一致的原因是由于税务机关内部原因造成的，并且变更 内容不涉及到税务登记证件修改的，税收管理员将不一致信息反馈给录入岗。 （7）如果税收管理员实地核查结果与纳税人填报的信息不一致，并且通过 税收管理员调查，不一致原因是由于税务机关内部原因造成的，并且变更 内容涉及到税务登记证件修改的，税收管理员将不一致信息反馈给录入岗 由录入岗修改，修改之后将信息反馈给税收管理员。由税收管理员打印《税 务事项通知书》通知纳税人到税务机关重新打印税务登记证。 （8）税收管理员将文书送达纳税人之后将文书销号。
税种鉴定、征收方 式核查任务 税收管理员
实地核查
否
是否存在问题
是
将信息反馈综合科 进行修改
将核查结果录入系 统
22
第14章 需求规格说明书
2 需求规格说明文档 示例-内容
需求规格说明文档常见的模板
2.4 业务处理流程描述 2.4.1 前臵条件 (1) 纳税人已申请办理税务登记、财产税税源登记、 税种鉴定、征收方式鉴定。 (2) 税务机关已受理纳税人税务登记。 (3) 登记录入岗已录入完成纳税人的财产税税源登 记、税种鉴定、征收方式鉴定。 (4) 税务机关已批准纳税人开业并为纳税人分配了 税收管理员。
23
第14章 需求规格说明书
2 需求规格说明文档 示例-内容 2.4.2 基本流程
需求规格说明文档常见的模板
税务登记核查、财产税登记核查 （1）税务机关批准纳税人开业并为纳税人分配税收管理员之后， 系统自动发送税务登记核查任务、财产税税源登记核查任务给 税收管理员。 （2）税收管理员根据系统发送的核查任务与纳税人的实际经营 情况进行实地核查。 （3）如果税收管理员实地核查结果与纳税人填报的信息完全一 致，则税收管理员直接结束任务。 （4）如果税收管理员实地核查结果与纳税人填报的信息不一致， 并且通过税收管理员调查，不一致的原因是由于纳税人填报错 误造成的，并且变更内容涉及变更登记内容的，需要税收管理 员向纳税人发放《税务事项通知书》、《文书送达回证》告知 纳税人到税务机关进行更正。 24
3
第14章 需求规格说明书 本课主要讨论问题
1 需求规格说明书概述 2 需求规格说明文档 3 模板选择与裁剪 4 需求规格说明书文档的写作 5 优秀的需求规格说明书文档的特性 6 应用示例
4
第14章 需求规格说明书
1 需求规格说明书概述 需求获取收集了需求信息，需求分析活动深入理解了需求信息 并建立了能够满足用户需求的软件解决方案。需求规格说明（需求 描述）是将需求获取、需求分析的结果进行文档化的过程。在软件 开发过程中，将分析的结果文档化是不可或缺的任务，也称为编写 规约活动。 基本用例模型
15
第14章 需求规格说明书
2 需求规格说明文档 需求规格说明文档常见的模板 示例-简单的范例
XX地税征管信息系统-需求规格说明书-户籍管理
16
第14章 需求规格说明书
2 需求规格说明文档 示例-封面
ABC软件有限公司 密级：限项目内使用
需求规格说明文档常见的模板
ABC-LOGO
xx地税税收征管信息系统 需求规格说明书
第14章 需求规格说明书
1 需求规格说明书概述
需求规格说明书撰写的素材（面向对象）
基本用例模型 用例模型
业务规则
顺序图
活动图
CRC模型 类模型(分析) 用户界面 流程图
需求规格 说明书
用户界面原型
基本用户界面 原型
8
第14章 需求规格说明书
1 需求规格说明书概述
撰写需求规格说明书-重要基础



哈尔滨工程大学计算机科学与技术学院 海量数据挖掘及网络数据集成研究组 王念滨 教授 博导
1
第 14 章
需求规格说明书
2
第14章 需求规格说明书 本课主要讨论问题
1 需求规格说明书概述 2 需求规格说明文档 3 模板选择与裁剪 4 需求规格说明书文档的写作 5 优秀的需求规格说明书文档的特性 6 应用示例
2.2 操作岗位
税收管理员岗
20
第14章 需求规格说明书
2 需求规格说明文档 示例-内容
实地核查
需求规格说明文档常见的模板
税务机关内部 税收管理员 纳税人
2.3 业务处理流程图
税务登记核查 财产税登记核查
税收管理员 产生税务登记核查 任务 核查是否有问 题 无 问 题 产生财产税登记核 查任务 结束 事项通知书
需求规格说明文档常见的模板
3.登记变更管理 3.1.业务规范 3.2.操作岗位 3.3.业务处理流程图 3.4.业务处理流程描述 3.4.1.前臵条件 3.4.2.基本流程 3.4.3.分支流程 3.4.4.后臵条件 3.4.5.特殊需求说明 3.4.6.相关业务环节 3.4.7.业务表单
18
第14章 需求规格说明书
19
第14章 需求规格说明书
2 需求规格说明文档 示例-内容 2 开业登记管理 2.1 业务规范
需求规格说明文档常见的模板
各类企业及企业在外地设立的分支机构和从事生产、经营的场所，个体 工商户和从事生产、经营的事业单位（从事生产经营的纳税人）自领取营业 执照之日起30日内持有关证件向生产、经营地或纳税义务发生地税务登记机 关申请办理税务登记。其它纳税人自依照税收法律、行政法规规定成为纳税 义务人之日起30日内向所在地税务登记机关申请办理税务登记。 税务机关核准纳税人开业之后，由税收管理员根据纳税人的实际经营情 况对纳税人填报的税务登记信息、社保登记信息、财产税税源登记信息、税 种鉴定信息以及征收方式做实地核查。如果发现纳税人填报的信息与纳税人 实际经营情况不一致，税收管理员有责任告知纳税人，令其到税务机关进行 登记信息变更。
2 需求规格说明文档 需求规格说明文档常见的写作风格 非形式化 – 自然语言 – 限制性文本 半形式化 – 结构化文本 • 伪码/结构化英语 – 模型语言 • 图、表… 形式化 – 形式化语言 • 数学语言：BNF，…
自然语言
图形化模型
形式化规格描述
12
第14章 需求规格说明书
2 需求规格说明文档 需求规格说明文档常见的写作风格 自然语言：就是使用结构合理的自然语言来描述需求，该显 示不管对于写的人还是看的人都是一个非常容易接受的方法。 以前的项目很多都是采用此方法。 优点：易于编写、易于阅读，不需要掌握特定的技巧； 缺点：不够严谨，歧义性强，表达能力弱（特别是对于复杂 问题的描述） 建议：一般以自然语言为主，辅以图形化模型，需要的地方 少量使用形式化规格描述。这样的组合方式是目前多数软件 系统采用的风格。
软件需求
Che cking Che Ckin Che cking g Che cking Che Ckin Che cking g Checking Checking Checking Checking Checking Settings Entry/ OpenShutter( 0.5 ); MeasureLight(); Checking Settings Entry/ OpenShutter( 0.5 ); MeasureLight(); DetermineExposureTime( Checking Checking Checking Checking Settings Entry/ OpenShutter( 0.5 ); MeasureLight(); DetermineExposureTime( Checking
用例模型 业务规则 CRC模型
类模型（分析） 用户界面 流程图 用户界面原型 基本用户界面 原型
顺序图
活动图
需求规格 说明书
5
第14章 需求规格说明书
1 需求规格说明书概述
需求规格说明书编写的重要性？ 在经过需求获取活动和需求分析活动的处理之后，软件系统的涉众和 需求工程师应该能够就软件的需求和解决方案达成共识。为了保证软件开 发的成功，这种共识还需要完整地传递给开发人员。需求规格说明书的编 写就是将需求及其软件解决方案进行定义和文档化，并传递给开发人员的 需求工程活动。 需求规格说明书的完成（撰写完成、验证完成）标志着软件需求阶段 告一段落。并将作为下一个阶段设计开发阶段的输入和重要依据。
需求获取 – 目标是得到用户需求——收集需求信息 需求分析 – 目标是更深刻的理解用户需求——界定能够让 用户满意的解决方案准则 需求规格说明 – 目标是定义用户需求——准确描述需求及其解 决方案
9
第14章 需求规格说明书
1 需求规格说明书概述
撰写需求规格说明书-主要活动
标准模版 模版结构 模版的选择 与裁剪 需求规格说 明文档模版
系统模型
知识
文档写作
软件需求规 格说明文档
知识 系Байду номын сангаас需求
图 需求规格说明活动流图
10
第14章 需求规格说明书 本课主要讨论问题
1 需求规格说明书概述 2 需求规格说明文档 3 模板选择与裁剪 4 需求规格说明书文档的写作 5 优秀的需求规格说明书文档的特性 6 应用示例
11
第14章 需求规格说明书
编写SRS 讲解SRS 需求（验证）评审会 需求文档发布（里程碑）
项目经理：老大，你看是否可以把今天当作需求冻结日。 用户方负责人：不行，等系统上线再考虑需求冻结吧！ 项目经理：….（你这是要我命啊！） 用户方负责人：你要冻结需求就是要我命。 6
第14章 需求规格说明书
1 需求规格说明书概述 需求规格说明书的作用？ （1）需求规格说明书文档可以成为各方人员之间有关软件 系统的协议基准。开发者和用户可以使用它作为合同协议 的重要部分，涉众也可以利用它在相互间达成一致。 （2）需求规格说明书文档可以成为项目开发活动的一个重 要依据。它可以成为软件估算和项目进度安排的基础，也 可以成为开发人员判断设计、测试等工作的进行是否正确 的依据。 （3）在需求规格说明书文档的编写过程中，可以尽早发现 和减少可能存在的需求错误，从而减少项目返工，降低项 目的工作量。 （4）需求规格说明书文档可以成为有效的智力资产。该智 利资产可以帮助新加入的团队成员快速融入项目，可以帮 助更好地将软件产品移交给新客户，也可以帮助开发者更 好地进行其他类似项目或者后续增强项目的开发。 7