需求工程规范和文档

需求工程规范和文档开始第三章：评估技术

其他选择同意要求已记录的需求合并要求规范和文档第二章：诱导技术第四章：规范和文档大纲需求文档文档设计文档类型文档结构使用需求文档需求文档的质量标准在需求工程中，必须在不同活动中建立或确定的信息进行记录。这些信息包括访谈记录、验证或协议活动报告，以及变更请求等。然而，需求工程中最主要、最重要的文档任务是以适当的方式记录系统需求。需求文档原则上，任何一种文档技术都可以用来记录需求，无论是用散文形式的自然语言文档、结构化的自然语言文本，还是状态图等更正式的技术。定义4-1：需求文档/需求规范：需求规范是对需求的系统性表示集合，通常针对系统或组件，以满足给定的标准。文档设计（1）记录原因：需求的核心作用：需求是系统开发的基础。任何类型的需求都会直接或间接地影响分析、设计、实现和测试阶段。需求或需求文档的质量对项目进度乃至项目成败都至关重要。法律相关性需求具有法律效力。这些需求对承包商和客户均具有法律约束力，客户可以就需求的履行提起诉讼。将需求记录下来有助于快速解决两方或多方之间的法律纠纷。文档设计（2）复杂

需求文档非常复杂。在实践中，拥有成千上万条需求、且这些需求在多个层面上又存在复杂相互依赖关系的系统并不少见。如果没有合适的文档，任何相关人员都很难掌控全局。无障碍需求必须对所有相关方开放。项目会随着时间的推移而不断发展，这不仅体现在项目主题上，也体现在人员配备上。如果需求能够永久公开，就能避免不确定性和晦涩之处，新加入项目的员工也能迅速上手。文档设计（3）另一个支持项目良好文档的论点是，员工对同一主题的理解几乎不可能完全一致。因此，需求文档的编写方式应满足所有相关人员的质量要求。文档设计（4）使用自然语言编写需求文档：自然语言，尤其是散文，是实践中最常用的需求文档形式。此外，语言还可以用于各种其他用途——需求工程师可以使用自然语言来表达任何类型的需求。然而，自然语言可能会使要求产生歧义。文档类型（1）使用概念模型进行需求文档编写这些模型以更简洁的方式描述了已记录的需求，因此对于训练有素的读者来说，它们比自然语言更容易理解。此外，由于概念模型具有更高的形式化程度，因此其歧义程度（即解释方式）比自然语言要低。但是，使用概念建模语言进行需求文档编写需要特定的建模知识。用例图类图活动图序列图文档类型（2）混合需求文档通常，文档包含自然语言和概念模型的结合。这种组合能够利用一种文档类型的优势来减少另一种文档类型的劣势，并且结合文档类型可以充分发挥两者的优势。例如，可以通过自然语言注释和自然语言要求来修改或补充模型，可以总结自然语言词汇表，并利用模型清晰地描述它们的依赖关系。文档类型（3）需求文档包含大量不同的信息。这些内容必须结构清晰，便于读者阅读。为了做到这一点：人们可以利用标准化的文档结构

或者

单独定义自定义文档结构。文档结构（1）标准化文档结构现有标准大纲的改编标准大纲提供预定义的结构，即预定义的刻板印象，信息可以根据这些刻板印象进行分类。必须指出的是，这些结构必须根据具体项目的特性进行调整，以满足相应的限制条件。文档结构（2）理性统一过程RationalUnifiedProcess(RUP)[Kruchten2001]通常用于软件系统。客户创建了一个业务模型，其中包含来自业务环境的不同工件（例如，业务规则、业务用例、业务目标），这些工件将作为系统在开发过程中需求的基础。文档结构（3）承包商使用软件需求规范（SRS）的结构来记录所有软件需求。文档结构（4）ISO/IEC/IEEE标准29148:2011ISO/IEC/IEEE标准29148:2011[ISO/IEC/IEEE29148:2011]包含一个用于记录软件需求（软件需求规范）的大纲。标准结构建议将需求文档根据其主题内容分为五个部分：介绍性信息（例如，系统目标、系统边界）和软件总体描述（例如，系统视角、未来用户属性）的章节文档结构（5）规范中引用的所有文档列表的章节章节，用于描述具体需求（例如，功能需求、性能需求、接口需求）包含所有计划核查措施的章节附录（例如，有关所做的假设、已确定的依赖关系的信息）文档结构（6）定制标准内容最低内容要求：介绍目的系统覆盖范围利益相关者定义、首字母缩略词和简称参考概述概述系统环境。架构描述系统功能用户和目标受众约束条件假设要求附录指数文档结构（7）在项目过程中，需求文档是各项任务的基础：规划：根据需求文档，可以定义系统实施的具体工作包和里程碑。架构设计：详细记录的需求（以及约束条件）是系统架构设计的基础。实现：基于架构设计，利用需求来实现该系统。测试：根据需求文档中记录的需求，可以开发测试用例，以便日后进行系统验证。使用需求文档（1）变更管理：当需求发生变更时，需求文档可以作为分析系统其他部分受影响程度的基础。由此可以估算变更工作量。系统使用和系统维护：系统开发完成后，需求文档将用于维护和支持。

例如，可以推断缺陷是由于系统使用不当、需求错误还是实现错误造成的。合同管理：需求文档是客户与承包商之间合同的主要内容。使用需求文档（2）根据ISO/IEC/IEEE标准29148:2011[ISO/IEC/IEEE29148:2011]，需求文件应当完整且一致。此外，需求文档应通过提供清晰的结构、合理的范围和可追溯性来保证可读性。总体而言，需求文档应满足以下质量标准：明确性和一致性必须保证各项要求之间互不冲突。需求文档的质量标准清晰的结构为了保证任何利益相关者都能阅读需求文档，该文档应内容全面、结构清晰。可修改性和可扩展性需求文档必须易于扩展。随着项目的推进，需求总会发生变化、修改、添加或删除。因此，需求文档的结构应该易于修改和扩展。需求文档质量标准（1）完整性对于每个所需的系统功能，必须描述系统的所有可能输入、影响因素和所需反应。可追溯性一项重要的质量标准是需求文档与其他文档（例