文档介绍：计算机软件需求说明编制指南
1 引言
目的和作用
本指南为软件需求实践提供了一个规范化的方法。本指南不提倡把软件需求说明(Software Requirements Specifications,以下简称SRS)划分成等级,避免把它定义成更小的需求子集。
本指南适用对象:
软件客户(Customers),以便精确地描述他们想获得什么样的产品。
软件开发者(Suppliers),以便准确地理解客户需要什么样的产品。
对于任一要实现下列目标的单位和(或)个人:
a. 要提出开发规范化的SRS提纲;
b. 定义自己需要的具体的格式和内容;
c. 产生附加的局部使用条款,如SRS质量检查清单或者SRS作者手册等。
SRS将完成下列目标:
a. 在软件产品完成目标方面为客户和开发者之间建立共同协议创立一个基础。对要实现的软件功能做全面描述,帮助客户判断所规定的软件是否符合他们的要求,或者怎样修改这种软件才能适合他们的要求;
b. 提高开发效率。编制SRS的过程将使客户在设计开始之前周密地思考全部需求,从而减少事后重新设计、重新编码和重新测试的返工活动。在SRS中对各种需求仔细地进行复查,还可以在开发早期发现若干遗漏、错误的理解和不一致性,以便及时加以纠正;
c. 为成本计价和编制计划进度提供基础。SRS提供的对被开发软件产品的描述,是计算机软件产品成本核算的基础,并且可以为各方的要价和付费提供依据。SRS对软件的清晰描述,有助于估计所必须的资源,并用作编制进度的依据;
d. 为确认和验证提供一个基准。任何组织将更有效地编制他们的确认和验证计划。作为开发合同的一部分,SRS还可以提供一个可以度量和遵循的基准(然而,反之则不成立,即任一有关软件的合同都不能作为SRS。因为这种文件几乎不包括详尽的需求说明,并且通常不完全的);
e. 便于移植。有了SRS就便于移值软件产品,以适应新的用户或新的机种。客户也易于移植其软件到其他部门,而开发者同样也易于把软件移植到新的客户;
。由于SRS所讨论的是软件产品,而不是开发这个产品的设计。因此SRS是软件产品继续提高的基础。虽然SRS也可能要改变,但是原来的SRS还是软件产品改进的可靠基础。
范围
本指南适用于编写软件需求规格说明,它描述了一个SRS所必须的内容和质量,并且在第6章中提供了SRS大纲。
2 引用标准
GB 8566 计算机软件开发规范
GB 8567 计算机软件产品开发文件编制指南
GB/T 11457 软件工程术语
3 定义
GB/T 11457所列术语和下列定义适用于本指南。
合同(contract)
是由客户和开发者共同签署的具有法律约束力的文件。其中包括产品的技术、组织、成本和进度计划要求等内容。
客户(customer)
指个人或单位,他们为产品开发提供资金,通常(但有时也不必)还提出各种需求。文件中的客户和开发者也可能是同一个组织的成员。
语言(language)
是具有语法和语义的通信工具,包括一组表达式、惯例和传递信息的有关规则。
分割(partitioning)
把一个整体分成若干部分。
开发者(supplier)
指为客户生产某种软件产品的个人或集团。在本指南中,客户和开发者可能是同一个组织的成员。
用户(user)
指运行系统或者直接与系统发生交互作用的个人或集团。用户和客户通常不是同一些人。
4 编写SRS的背景信息
SRS的基本要求
SRS是对要完成一定功能、性能的软件产品、程序或一组程序的说明。
对SRS的描述有两项基本要求:
a. 必须描述一定的功能、性能;
b. 必须用确定的方法叙述这些功能、性能。
SRS的环境
必须认识到SRS在整个软件开发规范(见GB 8566)所规定的有关阶段都起作用。正因为如此,SRS的起草者必须特别注意不要超出这种作用的范围。这意味着要满足下列要求:
a. SRS必须正确地定义所有的软件需求;
b. 除了设计上的特殊限制之外,SRS中一般不描述任何设计、验证或项目管理细节。
SRS的特点
无歧义性
当且仅当它对每一个需求只有一种解释时,SRS者是无歧义的。
a. 要求最终产品的每一个特性用某一术语描述;
b. 若某一术语在某一特殊的行文中使用时具有多种歧义,那么对该术语的每种含义作出解释并指出其适用场合。
需求通常是用自然语言编写的,使用自然语言的SRS起草者必须特别注意消除其需求的歧义性。提倡使用形式化需求说明语言。
完整性
如果一个SRS能满足下列要求,则该SRS就是完整的:
a. 包括