**软件需求规格说明书(software requirements specification,SRS)**是对软件产品或组件必须满足的需求所作的结构化描述。它以足以支持开发和评估的精确程度,明确所需的行为、外部接口、质量属性和约束。在软件工程中,SRS 为利益相关方、开发人员、测试人员和维护人员提供共同的参考依据。它是软件文档的一种,但其核心目的在于规定必须满足的要求和预期结果,而不是解释已有的实现。
SRS 可以是一份传统文档、一组受管理的需求,也可以是一组相互链接并附有支撑模型的记录。它的权威性来自项目的评审和批准机制,而非文件格式或篇幅。
目的与范围
SRS 将利益相关方的需要转化为分配给软件的需求。利益相关方可能包括客户、最终用户、操作人员、管理员、维护人员、监管机构,以及负责交互系统的组织。
其主要目的包括:
- 就软件必须完成的工作形成一致认识。
- 界定软件与其环境之间的边界。
- 为估算、架构决策、实现和测试提供支持。
- 为验收和符合性评估提供依据。
- 明确呈现依赖关系、假设和尚未解决的问题。
- 支持分析拟议变更的影响。
SRS 是需求工程的产物。需求工程包括获取需要、分析冲突、编写需求、确认需求,以及管理需求的演变。仅仅写出文档,并不能证明需求是正确的。
与其他规格说明的关系
业务需求文档描述组织目标和期望成果。利益相关方需求表达特定利益相关方所需的能力和条件。系统需求规格说明书面向整个系统,可能涵盖硬件、软件、人员和操作规程。SRS 则描述在这一背景下分配给软件的需求。
设计说明描述如何实现这些需求。SRS 通常侧重于外部可观察的行为,而非内部结构,为软件架构和实现决策留出空间。这一区分并非绝对:兼容性、采购或运行方面的要求,可能确有必要指定某种平台、协议或技术。
SRS 可以成为合同的一部分,但其本身并不天然构成合同。它的法律作用取决于将其纳入其中的协议。
需求的主要类别
功能需求
功能需求规定行为,即软件在收到输入、发生事件或满足某些条件时必须做什么。它们可以描述计算、业务规则、工作流程、状态变化、错误处理,以及与其他系统的交互。
例如:
当获授权用户针对尚未发货的订单提交有效的取消请求时,系统应将该订单标记为已取消,并释放为其预留的库存。
规格说明中的相关内容必须直接或通过明确引用,定义“获授权”“有效”和“尚未发货”等术语。异常情况下的行为同样重要:如果取消流程没有处理订单已经发货,或更新库存时发生故障的情况,那么该流程就是不完整的。
质量需求
质量需求通常称为非功能需求,用于规定性能、可靠性、易用性、可维护性和安全性等属性。它们限定行为的质量,或对系统整体施加约束,而不只是增加一项功能。
要求某项服务“快速”并不能得到客观评估。可度量的性能需求应明确操作、工作负载、测量边界和阈值。例如:
在 WP-01 定义的工作负载配置下,以服务边界为测量点,至少 95% 的有效目录搜索应在两秒内返回完整响应。
工作负载配置和测试环境是解读这一需求不可或缺的部分。
安全需求可以涉及身份认证、访问控制、审计记录,以及对存储或传输中数据的保护。网页无障碍需求可以明确适用的准则和相关用户交互。“安全”或“无障碍”等宽泛目标,需要转化为更精确的要求,才能指导验收。
功能与非功能的区分虽有用,却并不完美。例如,身份认证既包含功能行为,也包含与安全相关的质量目标。
外部接口需求
接口需求描述软件与用户、硬件、通信服务及其他软件之间的交互。它们可以规定:
- 消息格式、数据类型、单位和允许值。
- 协议和交互顺序。
- 错误码、超时行为和重试规则。
- 用户界面行为和无障碍约束。
- 兼容性和接口版本要求。
应用程序编程接口规格说明可以通过引用纳入,而不必重复编写。被引用的版本必须能够明确识别,以确保需求保持稳定且能够得到明确解读。
数据需求与约束
数据需求可以涵盖数据校验、关系、保留、迁移、删除和完整性。数据库模式可以帮助表达这些要求,但在需求阶段,采用针对具体实现的模式并不总是合适的。
约束限制了可接受的解决方案。例如,与现有操作系统兼容、使用强制指定的通信协议,或符合适用标准。
假设与需求不同:假设描述的是规划或分析中被视为成立的条件。如果某项假设是正确运行的必要条件,就需要明确其责任归属及其影响。未经验证的假设不应在不知不觉中变成保证。
组织与表示
并不存在适用于所有项目的强制性 SRS 大纲。常见结构包括:
- **引言:**目的、范围、目标读者、术语和参考资料。
- **总体描述:**产品背景、用户、运行环境、假设和依赖关系。
- **具体需求:**功能、接口、数据相关要求、质量属性和约束。
- **支撑信息:**模型、验证信息、可追溯性记录,以及明确标识的未决问题。
单条需求通常具有唯一标识符、规范性陈述、理由、来源、优先级和验证方法。状态、责任归属和依赖关系也可以作为附加属性保存。
规范性需求必须能够与解释和示例区分开来。许多规格说明使用“应”(shall)来表示强制性要求,但其具体含义取决于文档中的术语约定。
自然语言是最常见的表示方式,通常辅以表格、图示和结构化模型。有限状态机可以澄清依赖状态的行为;决策表可以揭示业务条件的组合。在要求更严格的应用中,形式化方法可以用数学方式表达属性,并支持形式验证。形式上的精确并不能证明,所规定的行为就是利益相关方真正需要的行为。
有效规格说明的质量特征
一份有用的 SRS,在单条需求和整份规格说明两个层面都应具备相应的质量特征。
- **必要性:**每条需求都有助于满足某项已明确的需要或必须履行的义务。
- **无歧义性:**目标读者能够对其作出一致的解读。
- **单一性:**每条陈述表达一项要求,或一项内部紧密关联、能够作为整体进行评估的要求。
- **可行性:**能够在相关技术和项目约束内实现。
- **可验证性:**能够通过客观证据确定其是否得到满足。
- **一致性:**需求之间互不矛盾。
- **充分完整性:**在约定范围内,涵盖所需行为和相关条件。
- **可追溯性:**能够将需求与其来源及下游工作产物联系起来。
- **可修改性:**能够进行变更,而不造成不必要的重复或不一致。
这些特征相互关联,但不能相互替代。一条需求可能可以度量,却并无必要;也可能表述清晰,却在技术上不可行。完整性尤其难以确定:一份文档可能没有明显缺漏,却遗漏了某个利益相关方关注的整类问题。
“界面应当对用户友好”或“系统应支持所有未来格式”之类的表述,掩盖了解读上的问题。反过来,过多的细节也可能在没有真实需求依据的情况下,强加实现方案。
评审、验证与确认
需求评审检查需求陈述是否清晰、一致、可行,以及范围是否适当。所用方法包括利益相关方走查、场景分析、原型、接口评审和模型分析。
必须区分以下两个问题:
- **需求确认:**所规定的需求是否充分反映了利益相关方的需要和预期用途?
- **依据需求进行验证:**已实现的软件是否满足所规定的需求?
不同标准和组织使用的术语有所差异,但区分“规格说明是否恰当”与“实现是否符合规格说明”至关重要。软件可能满足 SRS,却未能解决原本要解决的问题。
软件测试是获取验证证据的一种方式;检查、分析和演示也可能适用。验收测试依据约定的准则,帮助确定交付产品是否可接受。有些要求,例如架构限制,不能仅通过端到端测试来确定是否得到满足。
可追溯性与变更管理
需求可追溯性将需求与其来源,以及相关设计元素、实现工作、测试和证据联系起来。它有助于回答诸如某条需求变更时必须修改哪些测试,或某项功能以哪项利益相关方需要为依据等问题。
一组经过评审和批准的需求可以成为基线。基线是一种明确标识的参考状态,并不意味着禁止未来变更。可以评估变更对范围、依赖关系、架构、成本、进度和验证的影响。
版本控制保存修订历史,而需求管理流程则明确批准权限、状态和关联关系。稳定的标识符使得需求即使在措辞或位置发生变化后,仍然能够被持续跟踪。
可追溯性链接只有得到维护才有用。完成一张追溯矩阵,本身并不能证明其中的链接正确,也不能证明需求恰当充分。
历史发展与标准
随着结构化分析、正式采购流程和计划驱动式软件开发的发展,SRS 文档逐渐得到重视。在客户和供应商需要为实现与验收确立明确依据的情况下,它为双方协调提供了支持。
IEEE 830,尤其是其 1998 年版,曾是一项有影响力的软件需求规格说明书推荐实践。它描述了理想的质量特征,并给出了文档结构示例。该标准后来被 ISO/IEC/IEEE 29148 取代,后者涵盖系统和软件领域的需求工程,包括过程及需求相关信息项。
这些标准并不意味着某一种文档大纲普遍适用。所需内容和形式化程度取决于系统复杂性、风险、合同安排以及更广泛的工程过程。
迭代开发与局限性
在敏捷软件开发中,需求可能分布在产品待办列表、用户故事、验收准则、接口定义和长期维护的系统文档中。这些工作产物合在一起,可以发挥 SRS 的许多作用,但一组简短的功能描述并不会自动构成一份连贯的规格说明。
授权、可用性和数据保留等横切需求适用于多项功能,因此需要有明确的记录位置。迭代项目可以维持稳定的系统级需求,同时逐步细化近期要开展的工作。
SRS 不能消除不确定性,也不能保证项目成功。利益相关方可能存在分歧,环境可能发生变化,重要需要也可能只有在使用过程中才会显现。前期细节过多可能导致内容过时;规格说明不足则可能使关键决策停留在隐含状态。适当的详细程度,取决于误解所带来的后果,以及证明最终软件可接受所需的证据。