软件工程规范前景

《软件工程规范前景》由会员分享，可在线阅读，更多相关《软件工程规范前景（5页珍藏版）》请在装配图网上搜索。

1、前景文档软件工程文档规范一摘要文档的写作规范，前景文档以客户（visi。）本文是软件:程文档之一：前景（2002-10-22 0的语言描述总体的需求说明，它与需求规格说明书是相互配合的0 09:00:45）By介绍1.这部分应该提供整个前景文档的概述，它包含以下几部分：前景文档的目的文档目的是收集、分析、定义高层用户需要和产品特征。集中于目标用户所需要的能力以及为 什么存在这些需要。有关系统如何满足这些需要的特定需求应该放在“软件需求规格说明”和“用 例规格说明中。产品综述陈述该应用系统的目的、版本以及要交付的新特征。这部分应该做以下几件事：1）确定要创建或增强的产品或应用系统：2）提供有关产

2、品将做什么以及需要时不做什么的般性描述；3）描述产品的应用，包括与相关的利益、目的、目标。参考这一部分应该做以下几件事：1）列出在前景文档中引用的其他文档的清单：2）标明每个文档的题目、报告号（如果有的话）、日期和出版机构；3）指定该参考获取的来源：4）这个信息可通过引用附录或其它文档来提供。用户描述2.为了有效地提供满足客户需要的产品和服务，理解完成这项工作时所面对的挑战是很有必要的。 这部分应该剖析应用系统的用户和限制用户生产的关键问题。这部分不能用于陈述特定需求, 而是提供有关为什么需要第5部分指定的需求的背景和理由。用户/市场统计总结激励产品决策的主要市场统计：描述和定位目标；利用潜在

3、用户数量或客户愿意花在试图 满足你的产品或增强所完成的需要上的钱的数量来侦测市场的大小和增长率；回顾主要的行业趋 势和技术：回答以上战略问题：你的机构在这些市场中的声誉如何你希望它做成什么样这个产品 或服务如何支持你的目标用户剖析描述系统中每个不同的用户。用户的类型可能是从权威到新手差距很大。例如，权威可能需要个复杂、灵活的支持跨平台工具，而个新手可能需要个易于使用、用户友好的工具。对用 户的全面剖析覆盖每种用户的以下题目：1）技术背景和复杂程度：2）主要职责；3）为谁提交用户产品：4）使用户的匚作更容易或更困难的趋势：5）影响成功的问题：6）目标用户对成功的定义以及用户如何等到回报。用户环境

4、目标用户的工作环境的详细描述。以下是些建议：1）完成该任务涉及多少人是否会变化2）任务的周期是多长其中每项活动需要多少时间是否会变化3）是否有一些独特的环境约束：移动的、室外的、飞机上的，等等4）现在正在使用哪种系统平台未来的平台是什么5）正在使用其他什么应用系统你的应用系统是否能与这些系统集成关键用户需要列出用户认为的关键问题或需要。为每个问题澄清以下内容：1）这个问题的原因是什么2）现在是怎么解决的3）用户预期的解决方案是什么重要的是理解用户对解决每个问题所放的相对重要性。分级和累积投票技术可以说明必须解决的问题以及每个问题强调的事物。替代品和竞争对手确定用户认为目前可得到的替代品。可包括

5、购买对手的产品、构建个全部是自己的解决方案 或者维持现状。列出所知的已有的以及即将得到的竞争对手的产品。包括最终用户所理解的每位 对手的强项和弱项。竞争对手13 .产品综述这部分对产品能力、到其他应用系统的接口以及系统配置等等提供个高层视图，通常由以 下三个部分组成。产品前景这部分应该合理地把该产品与其他相关产品及用户的需求放在起。如果产品是独立的而且是 完全独立的，就在这里说明它；如果产品是个大型系统的组件之:那么这部分应该说明系 统之间如何交互而且应该确定相关的接口。种展示大型系统主要组件、互连及外部接口的简单 方法就是利用框图。产品定位陈述提供个整体陈述，从最高层次总结产品在市场上的独特

6、定位。Moore （1991）称此为产品定 位陈述，并推荐以下格式：为了（目标客户）谁（陈述需要或机遇）产品名是一个（产品分类）它（对主要优点的陈述，即驱动购买的原因）不像（主要竞争替代品）我们的产品（对主要区别的陈述）产品定位陈述向所有相关人员说明了应用系统的意图以及项目的重要性。能力总结总结产品将提供的主要优点和特征。例如，客户支持系统的前景文档可能会使用这部分强调 问题建档、路电和状态报告一不提及各个功能需求的细节。组织特征，以便清单能够被客户或所有第次阅读文档的人理解。个简单的表列出主要的优 点及其所支持的特征。客户支持系统7JJ%1牛 tlU2牛 fj3华假定和相关条件列出所有旦变更

7、将影响整个产品前景的假设条件。例如，某个假定条件可能指出，指定用于 软件产品的硬件可得到某个特定的操作系统，如果该操作系统得不到，则前景必须变更。成本和定价时于将销售给外部客户的产品以及许多机构内使用的应用系统，成本和定价将直接影响应用系 统的定义和实现。在这部分，把所有成本和相关的定价约束记录下来。例如，分销成本（磁盘、 CD-ROX、CD母盘的编号）或者其他货品销售成本（手册、打包）根据应用的性质对于项目的成 功可能无关也可能有实质性影响。4 .特征属性与需求样，特征也有属性，提供附加的项目信息，用于评估、跟踪、划分优先级、管理为实 现提出的项。这部分陈述所有建议在前景文档中使用的属性，描

8、述所选择的属性及其意义，使 各方都能更好地理解每个特征的背景。状态在项目管理团队协商和评审之后确定。状态信息在项目基线定义过程中跟踪进程。1）建议的（proposed）：描述正在对该特征进行讨论，但还没有得到“正式渠道”的审核与采 纳，“正式渠道”可以是个由项目团队、产品管理、用户或客户团队的代表组织的工作小组：2）批准的（approved）：它的能力被断定是有用和可行的，得到正式渠道的认可并加以实现：3）收编的（incorporated）：已经在某个特定时间收编入产品基线的特征；优先级产品优先级是由营销人员、产品经理或商业分析人员设置的。根据特征对最终用户的相对优先 级把它们划分等级打开了

9、个与客户、分析人员以及开发团队成员之间的对话。优先级用于管理 广度和确定开发优先级。一种优先级划分模式如下：1）关键的（critical）：本质特征。实现的失败意味着系统将不能满足客户的需要。所有关键 的特征必须在发布中实现，否则进度将推迟。2）重要的（important）：对于大多数应用的系统效率和效力都重要的特征。该功能无法容易 地用其他方式实现。如果缺少重要的特征，可能影响客户或用户的满意程度，甚至影响收益，但 发布不会因此而推迟；3）有用的（useful）：在不太典型的应用中有用的特征，但不经常使用或者有其他合理的有效 变通。如果发布中没有这类特征也不会对客户满意程度或收益造成重大的影

10、响工作量由开发团队设置，用于管理广度和确定开发优先级。由于有些特征比其他特征要求更多的时间 和资源，因此对各特征采用团队数量或人周、代码行、功能点等等进行评估将是预测复杂度的最 好办法，从而可对在给定时间范围内能完成什么不能完成什么有个预期。风险由开发团队设置，设置的依据是项目经历意外事件的可能性，如成本过高.、进度延迟甚至项目 被撤消等。许多项目经理发现，把风险分为高、中、低就已经足够r,尽管还可以再细些。风 险通常可以通过度量项目团队进度预测的不确定性（范围）进行间接地评估。稳定性由分析人员和开发团队设置，设置的依据是特征变更的可能性或团对变更特征的理解。这个信 息有助于建立开发优先级或确

11、定下一步中哪些附加启发是适当的。目标当布记录特征将首先出现在哪个产品版本中。这个域可用于把特征分配到特定的基线版本中。当 把目标版本与状态域结合起来时，团队可以建议、记录和讨论该版本的各个特征，而不必把它们 提交给开发。只有些状态被设置为“收编的”特征并且其目标版本被定义的特征才能实现。在 发生广度管理时，目标版本的版本号会不断增加，于是该项仍然存在于前景文档中，但被安排到 以后的版本中去。分配给在许多项目中，把特征分配给“特征团队”，负责进步启发、书写软件需求和实现。这个简 单清单将帮助所有项目团队成员更好地了解自己的职责。原因这文本域用来跟踪所要求特征的来源。特征的存在有很多特定的理由。这

12、个域记录了特征的 解释或对解释的引用。例如，引用可以是产品需求规格说明的页号和行号，或是重要客户而谈录 像带上的一个分钟标志。5 .产品特征这部分记录产品特征。特征提供了给用户带来利益所需要的系统能力，每个特征都提供r - 个满足用户需要的服务。例如，问题跟踪系统的个特征可能是“提供走势报钟”的能力，趋势 报告可能继续支持一个“更好理解项目状态”的需要。因为前景文档是由许多涉及人员审核的而且是达成共识的基础。所以特征应该用用肪的自然语 言描述。特征描述应该简短、精练，通常是1-2个句子。为了有效管理应用的复杂度，我们建议：对于任何新系统或在原有系统上加强的系统，把能力 抽象到较高层次产生大约2

13、5-99个特征。这些特征是产品定义、广度管理和项目管理的基本基础。 每个特征都可以在后面的规格说明中被更详细地说明。在整个这部分中，每个特征都应该是用户、操作者或其他外部系统可以感知的。特征#1特征#26 .关键用例描述些关键用例，可以是对体系结构有意义或最方便帮助读者理解系统如何使用的用例。7 .其他产品需求可应用标准列出产品必须符合的标准,如法律和规章（FDA、FCC）、通信标准（TCP/IP、ISDN）、平台兼容 标准（WindowsUNIX）以及质量和安全标准（UL、ISO、CMM）O系统需求定义支持应用所必须的所有系统需求。包括支持的主机操作系统、网络平台、配置、内存、外设以及软件。

14、许可和安装许可和安装问题对于开发工作有直接影响。例如，支持序列号、口令安全或网络许可证的需要 必须创建其他开发过程中必须考虑的附加的系统需注。安装需求也会影响编码或者产生开发独立 安装软件的需求。性能需求性能问题包括用户负我因素、带宽或通信能力、吞吐量、准确度、可靠性或在某些负载条件下 的响应时间等。8 .建档需求这部分描述所有支持成功地部署系统必须开发的文档用户手册描述用户手册的目的和内容。讨论其需要的长度、详尽程序、索引和词汇表的需要、指南及参 考手册策略，等等。还要指定格式和打印约束。在线帮助许多应用系统都提供个在线的帮助系统来辅助用户。这些系统的本质是应用系统开发所特有 的，因为它们把

15、编程（如超链接）和技术书写（如组织和表示）结合起来。许多人发现在在线帮 助系统是项目中的项目，它从广度管理和计划活动中直接受益。安装指南、配置和自述文件对于个全面的解决方案来说，有个包括安装指令和配置指南的文档非常重要，而个自述 （Read Me）文件也通常作为标准组件而存在。自述文件中可能包括个“本版本的新增内容” 部分以及个与以前版本的兼容问题的讨论。许多用户还希望在自述文件中说明所有已知的错误 和变通方法。标记和打包当今最新的艺术化的应用系统提供r 个从安装菜单提示的产品打包和装载清单、炫耀的醉幕、 帮助系统、GUI对话等开始的致的外观和感觉。这部分定义要集成到代码中的标记的类型和 需要。包括版本和专利说明、公司商标、标准化图标及其他图形无素等。9 .词汇表词汇表定义所有项目特有的术语。包括所有阅读文档的用户或其他人无法理解的缩写和简写。