软件工程：需求说明编制指南

软件工程：需求说明编制指南内容摘要：

内出现。 其他模型 队了上面提及的模型外。 对一些特殊的应用还有一些特别有用的模型。 例如，编译程序的说明可以使用属性文法，工资单系统可以使用表格。 要注意的是，对 SRS使用形式需求语言，通常含有使用特殊模型的意思。 警告 无论使用哪一类型的模型，都要： 在 SRS中 或在 SRS涉及到的一个文件中对它严格定义。 这个定义应该规定： a. 模型中的参数所要求的范围； b. 使用时的限定值； c. 结果的精确度； d. 负载的能力； e. 要求的执行时间； f. 缺省或失败时的响应。 必须注意，在需求的定义域内要保持一个模型定义。 每当一个 SRS使用一个模型时： a. 它意味着此模型提供一个十分有效和精确的方法说明需求； b. 并不意味着软件产品的实现必须基于这个模型。 一个模型用于解释文件所写的需求是有效的，但是对于实际软件的实现可能并不是最适宜的。 软件需求的注释 有关软件产品的所有需求，并不是同等重要的。 某些需求可能是基本的，例如是对于生命攸关的应用。 而另一些可能并不那么重要。 SRS中每一个需求必须进行注释，以便区别其重要的程度。 有这种方法注释需求，可以： a. 帮助客户对每一个需求给予更周密的考虑，通常可以在需求中澄清隐藏的假设； b. 帮助开发者做出正确的设计决定，并对软件产品不同部分作出相应的努力。 稳定性 注释需求的一种方法是使用稳定性量纲。 当一个需求在软件预期的生存期间内描述不改变的话，可以认为该需求是稳定 的，否则可以认为是易变的。 必要性等级 注释的另一种方法是把需求分成必须保证级、期望级和任选级。 a. 必须保证是指软件必须和这些需求相一致，否则该软件不可能被接受； b. 期望是指这些需求将提高软件产品的功能，但是如果缺省的话也是可接受的； c. 任选是给开发者一个机会，可以提供某些超出 SRS规定的目标。 注意事项 在注释需求之前，必须彻底理解这种注释的实质性含义。 在表达需求时遇到的共同弊病 SRS的基本点是它必须说明由软件获得的结果，而不是获得这些结果 的手段。 编写需求的人必须描述的基本问题是： a. 功能 —— 所设计的软件要做什么； b. 性能 —— 是指软件功能在执行过程中的速度、可使用性、响应时间、各种软件功能的恢复时间、吞吐能力、精度、频率等等； c. 强加于实现的设计限制 —— 在效果、实现的语言、数据库完整性、资源限制、操作环境等等方面所要求的标准； d. 属性 —— 可移植性、正确性、可维护性及安全性等方面的考虑因素； e. 外部接口 —— 与人、硬件、其他软件和其他硬件的相互关系。 编写需求的人应当避免把设计或项目需求写入 SRS之中，应当对说 明需求设计约束与规划设计两者有清晰的区别。 在 SRS中嵌入了设计 在 SRS中嵌入设计说明，会过多地约束软件设计，并且人为地把具有潜在危险的需求放入 SRS中。 SRS 必须描述在干什么数据上、为谁完成什么功能、在什么地方、产生什么结果。 SRS应把注意力集中在要完成的服务目标上。 通常不指定如下的设计项目： a. 把软件划分成若干模块； b. 给每一个模块分配功能； c. 描述模块间的信息流程或者控制流程； d. 选择数据结构。 把设计完全同 SRS隔离开来 始终是不现实的。 安全和保密方面的周密考虑可能增加一些直接反映设计约束的需求。 例如： a. 在一些分散的模块中保持某些功能； b. 允许在程序的某些区域之间进行有限的通讯； c. 计算临界值的检查和。 通常应考虑到，若要为软件选择高层次的设计，就可能需要大量的资源（可能占整个产品开发成本的 10%20%以上）。 有两种选择： a. 不顾本指南的警告，在 SRS 中描述了设计。 这意味着，或者将一个潜在不适当的设计作为一个需求进行描述（因为，若要得到好的设计，所花费的时间是不够的），或者在需求 阶段花费了过多的时间（因为在 SRS完成之前整个设计分析都要完成）； b. 采用本指南中 ，用模型设计描述需求，这种模型设计只用于辅助描述需求，而不使之成为实际的设计。 在 SRS中嵌入了一些项目要求 SRS应当是描写一个软件产品，而不是描述生产软件产品的过程。 项目要求表达客户和开发者之间对于软件生产方面合同性事宜的理解（因此不应当包括在 SRS中）例如： a. 成本； b. 交货进度； c. 报表处理； d. 软件开发方法； e. 质量保证； f. 确认和验证 的标准； g. 验收过程。 项目需求在另外的文件中描述。 在 SRS中提供的只是关于软件产品本身的需求。 6 SRS 大纲 本章着重讨论 SRS的每一个基本部分，可以作为一个 SRS的大纲。 表 1给出该大纲目录，表 2至表 5给出大纲中第 3章的具体需求内容。 各开发者和客户应当根据所描述的实际情况，按本指南有关规定编写自己的 SRS。 目录 1 前言 目的 范围 定义、缩写词、略语 参考资料 2 项目概述 产品描述 产品功能 用户特点 一般约束 假设和依据 3 具体需求 （参阅本指南 条中具体需求的组织形式） 附录 索引 前言（ SRS第 1章） 本章提供整个 SRS综述。 目的（ SRS的 ） 在这一条包括下列内容： a. 描述实际 SRS的目的； b. 说明 SRS所预期的读者。 范围（ SRS的 ） a. 用一个名字标识被生产的软件产品。 比如：数据库系统，报表生成程序等等； b. 说明软件产品将干什么，如果需要的话，还要说明软件产品不干什么； c. 描述所说明的软件的应用。 应当： （ 1）尽可能精确地描述所有相关的利闪、目的、以及最终目标。 （ 2）如果有一个较高层次的说明存在，则应该使其和高层次说明中的类似的陈述相一致（例如，系统的需求规格说明）。 定义、缩写词、略语（ SRS的 ） 本条中必须提供全部需求的术语、缩写词及略语的定义，以便对 SRS进行适当的解释。 这些信息可以由 SRS的附录提供。 也可以参考其他的文件。 参考资料（ SRS的 ） 本条应包括： a. 在 SRS中各处参照的文件的全部清单，如经 核准的计划任务书，上级机关批文、合同等； b. 列出其他参考资料，如属本项目的其他已发表的文件和主要文献等。 每一个文件、文献要有标题，索引号或文件号，发布或发表日期以及出版单位； c. 详细说明可以得到该参考文件的来源。 这个信息可以通过引用附录或其他文件提供。 项目概述（ SRS第 2章） 本章应描述影响产品和其需求的一般因素，本章不说明具体的需求，而仅使需求更易于理解。 产品描述（ SRS的 ） 这一条是把一个产品用其他有关的产品或项目来描述。 a. 如果这个产品是独立的 ，而且全部内容自含，应在此说明； b. 如果 SRS 定义的产品是。