曾经有项目组拿着用户编写的原始需求就开始开发,随后状况不断,一次令人崩溃的研发过程。拿着用户编写的原始需求,编写我们自己的需求规格说明书,之所以重要,就在于用户编写的原始需求,是脱离了技术实现,编写的一份十分理想的业务需求。理想与现实总是有差距,我们之所以要编写自己的需求规格说明书,就是要本着实事求是、切实可行的态度,去描述用户的业务需求。那些不可行的需求被摒弃,或者换成更加可行的解决方案。这就是需求规格说明书的重要作用。
从理论上讲,需求规格说明书(Requirement Specification)分为用户需求规格说明书和产品需求规格说明书。用户需求规格说明书是站在用户角度描述的系统业务需求,是用于与用户签字确认业务需求;产品需求规格说明书是站在开发人员角度描述的系统业务需求,是指导开发人员完成设计与开发的技术性文档。但是,我认为,用户需求规格说明书与产品需求规格说明书的差别并不大。领域驱动设计所提倡的就是要让用户、需求分析员、开发人员站在一个平台,使用统一的语言(一种混合语言),来表达大家都清楚明白的概念。从这个角度将,需求规格说明书就应当是一个,不区分用户需求规格说明书和产品需求规格说明书。
那么需求规格说明书怎么写呢?不同的公司、不同的人、不同的项目,特别是在需求分析中采用不同的方法,写出来的需求规格说明书格式都是不一样的。在这里,我给大家一个,采用RUP统一建模的方式分析需求,编写需求规格说明书的模板,供大家参考。
1.引言
1.1 编写目的
如题,描述你编写这篇文档的目的和作用。但最关键的是,详细说明哪些人可以使用这篇文档,做什么。需求规格说明书是用来做什么的?毫无疑问,首先供用户与开发公司确认软件开发的业务需求、功能范围。其次呢,当然就是指导设计与开发人员设计开发系统。当然,还包括测试人员设计测试,技服人员编写用户手册,以及其它相关人员熟悉系统。描述这些,可以帮助读者确定,阅读这篇文档是否可以从中获得帮助。
1.2 业务背景
描述业务背景,是为了读者了解与该文档相关的人与事。你可以罗列与文档相关的各种事件,也可以描写与项目相关的企业现状、问题分析与解决思路,以及触发开发该项目的大背景、政策法规,等等。
1.3 项目目标(或任务概述)
就是项目能为用户带来什么利益,解决用户什么问题,或者说怎样才算项目成功。前面提到过,这部分对项目成功作用巨大。
1.4 参考资料
参考资料的名称、作者、版本、编写日期。
1.5 名词定义
没啥可说的,就是文档中可能使用的各种术语或名词的定义与约定,大家可以根据需要删减。
2.整体概述
这部分是对系统整体框架性地进行描述。
2.1 整体流程分析
绘制的整体行动图,及其对它的说明。
2.2 整体用例分析
绘制的整体用例图,以及对每个用例的用例说明。如果项目比较大,存在多个子系统,可以将用例图改为构件图,详细描述每个子系统及其相互的接口调用。
2.3 角色分析
一个用例图,描述系统中所有的角色及其相互关系。在随后的说明中,详细说明每个角色的定义及其作用。
这部分还可以根据项目需要编写其它的内容,如部署方案、网络设备、功能结构、软件架构、关键点难点技术方案,等等。
3.功能需求
3.1 功能模块(子系统)
一个一个描述系统中的每个功能模块(或子系统),即整体用例分析中的每个用例。这部分是需求规格说明书最主要的部分。
3.1.1 用例图
绘制该模块的用例图(详见
《功能角色分析与用例图》)。
3.1.2 用例说明
对用例图中的每个用例编写用例说明(详见
《用例说明》)。
3.1.3 领域模型
为用例绘制领域模型,并编写领域模型说明,对每个实体进行说明。对实体的说明包括对实体的定义、属性说明、行为说明、实体关系说明等等。如果实体间关系复杂,还要使用对象图说明实体关系的所有情况(如
《领域驱动设计》中的描述)。
4.非功能需求
这里描述的是软件对非功能需求的一般要求,即整体设计原则。那些与具体功能相关的非功能需求应该放在用例说明的“非功能需求”部分(详见
《非功能需求》)。
5.接口需求
如果项目涉及到与外部系统的接口,则编写这部分需求。
5.1 接口方案
详细描述采用什么体系结构与外部系统的接口。
5.2 接口定义
接口的中文名、英文名、功能描述、参数、返回值、使用者、使用频率,等等。
我们应当怎样做需求分析 我们应当怎样做需求调研:初识 我们应当怎样做需求调研:拜访 我们应当怎样做需求调研:研讨会 我们应当怎样做需求调研:需求研讨 我们应当怎样做需求调研:迭代 我们应当怎样做需求调研:需求捕获(上) 我们应当怎样做需求调研:需求捕获(下) 我们应当怎样做需求分析:功能角色分析与用例图 我们应当怎样做需求分析:业务流程分析(上) 我们应当怎样做需求分析:业务流程分析(下) 我们应当怎样做需求分析:用例说明 我们应当怎样做需求分析:查询报表分析 我们应当怎样做需求分析:子用例与扩展用例 我们应当怎样做需求分析:行动图和状态图 我们应当怎样做需求分析:业务领域分析 我们应当怎样做需求分析:原文分析法 我们应当怎样做需求分析:领域驱动设计 我们应当怎样做需求分析:非功能需求 我们应当怎样做需求确认:需求列表 我们应当怎样做需求确认:一个需求列表的实例 我们应当怎样做需求确认:快速原型法 我们应当怎样做需求确认:需求规格说明书 我们应当怎样做需求确认:评审与签字确认会 (续)
相关推荐
需求分析
这个过程包括了解现实世界中做实际工作的人们真正需要什么样的程序,然后将这些需求细化,并最终转化为需求说明书。这个说明书不是凭空产生的,而是从需求调研中得到或抽取出来的。 在进行前期准备时,首先要确定...
1. 编写需求调研计划书,需求调研计划书是我们需求调研的依据,促使我们在需求调研的时有序进行,保证我们调研工作的完整性,有效性。 2. 发送给客户负责人,并得到客户认可。 3. 整理需求调查表与用户交流之后要...
只有当我们明确了解系统的输入是什么样的,才能确保系统的正确性。 2. 输出定义:详细定义了系统的全部输出,包括目的地、精度、取值范围、出现频率、格式等。输出定义直接关系到系统的可维护性和可扩展性。 3. ...
它的主要目标是理解并明确软件系统应该做什么,以及它应该如何做。需求分析做得好,可以极大地提高软件项目的成功率,降低开发成本和时间。反之,如果需求分析不充分或者不准确,可能会导致项目延期、预算超支,甚至...
WHAT 定律是需求调研的第二步骤,它要求项目经理从各业务流程的要求入手,了解系统要做什么,实现什么。 WHAT 定律的引入可以让我们了解到系统的初步需求。 WHO 定律是需求调研的第三步骤,它要求项目经理了解什么...
最终,我们要看的是性价比 = 价值/成本,凭此推出我们应该先满足哪些需求。 对需求的价值判断,还是基于两点:这个需求满足的是核心用户的刚性需求。 核心用户是否核心用户,细分了看,什么样的用户(群体)算?...
系统需求则是技术层面的,详细描述了软件系统应该如何响应各种输入,执行什么样的处理,以及输出什么样的结果。 3. 需求开发的重要性 每个项目都必须有需求,这是因为只有明确的、经过认真分析的需求,才能确保软件...
用户需求通常指的是用户对软件系统外部行为的期望,例如用户希望软件具备什么样的功能,界面友好程度等。系统需求则更多地关注软件系统内部的特性,比如数据处理方式、存储要求等。这些需求都需要通过详细文档记录...
另一类客户,我们称之为设盲型,他们对网站设计缺乏基本的了解,甚至可能完全不知道自己想要什么样的设计。面对这样的客户,设计师需要采取更为系统和细致的引导方式。在这种情况下,设计师可以通过制作选择题而不是...
在任务维度中,我们需要了解用户完成这个需求需要做什么,我们解决这个需求我们需要做什么。任务维度需要注意任务的多样性和复杂度。 在目标维度中,我们需要了解用户的目标和我们的目标。用户的目标是为什么要做这...
因此我们得出下图:需求分布图我们要优先处理红色区域中的需求,接下来,如何判断一个需求的紧急性和重要性呢?紧急性比较好判断,时效性越强的需求越紧急。一旦错过截止时间,就一切都太迟了的需求。 关于重要性,...
软件的功能需求是整个需求分析最主要、最关键和最复杂的部分,它描述软件的各种可能的条件下,对所有可能输入的数据信息,应完成那些具体功能,产生什么样的输出。描述软件功能需求时应注意以下几点: 1. 功能需求...
1. **问题识别**:这个阶段主要是从整体系统角度出发,识别和理解用户对系统的需求,包括功能需求(系统需要做什么)、性能需求(达到什么样的性能标准)、环境需求(如操作系统、硬件配置)等,以及可靠性、安全性...
软件质量保证应该从需求分析阶段就开始,这是因为需求阶段奠定了整个项目的基石,明确了软件应该实现的功能和性能,这对保证软件质量至关重要。 **4. 成本估算方法** 选项 **A COCOMO模型** 正确。COCOMO...
3. 产品原则:产品原则是指对产品原则性的要求,在产品设计开发的过程中我们会遇到很多的选择,产品原则就是我们在做选择时的参考依据和边界。原则很多时候就是产品的特点:小巧轻便、经济实惠、性能强大、最大功耗...
【报告概述】 本报告《中国城市养老服务需求报告...通过深入研究,我们可以预见未来养老服务的创新方向,如科技应用、社区养老、智能化服务等,以满足多元化、个性化的养老需求,提升广大老年人的生活质量和幸福感。
事件表中记录 Who、When、Where、What、How,即谁在什么时间,什么地点,以什么样的方式,做了一件什么样的事,用户表里面记录了某个用户有什么样的属性特征,比如年龄、性别等。 事件模型有三个优点:1)抽象能力...
系统性思维要求我们不能孤立地看待每一个环节,而应该全面考虑整个系统内的用户体验、商家利益和平台运营之间的平衡。如果某一环节出现问题,整个系统都会受到影响。比如在团购初期,如果仅仅依赖低价策略吸引消费者...