软件工程文档规范前景文档.docVIP

软件工程文档规范--前景文档 摘要　　本文是软件工程文档之一：前景(visio)文档的写作规范，前景文档以客户的语言描述总体的需求说明，它与需求规格说明书是相互配合的。。(2002-10-22 09:00:45) By 风过留枫 1. 介绍 　　这一部分应该提供整个前景文档的概述，它包含以下几部分： 　　1.1 前景文档的目的 　　文档目的是收集、分析、定义高层用户需要和产品特征。集中于目标用户所需要的能力以及为什么存在这些需要。有关系统如何满足这些需要的特定需求应该放在“软件需求规格说明”和“用例规格说明”中。 　　1.2 产品综述 　　陈述该应用系统的目的、版本以及要交付的新特征。这一部分应该做以下几件事： 　　1）确定要创建或增强的产品或应用系统； 　　2）提供有关产品将做什么以及需要时不做什么的一般性描述； 　　3）描述产品的应用，包括与相关的利益、目的、目标。 　　1.3 参考 　　这一部分应该做以下几件事： 　　1）列出在前景文档中引用的其他文档的清单； 　　2）标明每个文档的题目、报告号（如果有的话）、日期和出版机构； 　　3）指定该参考获取的来源； 　　4）这个信息可通过引用附录或其它文档来提供。 2. 用户描述 　　为了有效地提供满足客户需要的产品和服务，理解完成这项工作时所面对的挑战是很有必要的。这一部分应该剖析应用系统的用户和限制用户生产的关键问题。这一部分不能用于陈述特定需求，而是提供有关为什么需要第5部分指定的需求的背景和理由。 　　2.1 用户/市场统计 　　总结激励产品决策的主要市场统计；描述和定位目标；利用潜在用户数量或客户愿意花在试图满足你的产品或增强所完成的需要上的钱的数量来预测市场的大小和增长率；回顾主要的行业趋势和技术；回答以上战略问题：你的机构在这些市场中的声誉如何？你希望它做成什么样？这个产品或服务如何支持你的目标？ 　　2.2 用户剖析 　　描述系统中每个不同的用户。用户的类型可能是从权威到新手差距很大。例如，权威可能需要一个复杂、灵活的支持跨平台工具，而一个新手可能需要一个易于使用、用户友好的工具。对用户的全面剖析覆盖每种用户的以下题目： 　　1）技术背景和复杂程度； 　　2）主要职责； 　　3）为谁提交用户产品； 　　4）使用户的工作更容易或更困难的趋势； 　　5）影响成功的问题； 　　6）目标用户对成功的定义以及用户如何等到回报。 　　2.3 用户环境 　　目标用户的工作环境的详细描述。以下是一些建议： 　　1）完成该任务涉及多少人？是否会变化？ 　　2）任务的周期是多长？其中每项活动需要多少时间？是否会变化？ 　　3）是否有一些独特的环境约束：移动的、室外的、飞机上的，等等？ 　　4）现在正在使用哪种系统平台？未来的平台是什么？ 　　5）正在使用其他什么应用系统？你的应用系统是否能与这些系统集成？ 　　2.4 关键用户需要 　　列出用户认为的关键问题或需要。为每个问题澄清以下内容： 　　1）这个问题的原因是什么？ 　　2）现在是怎么解决的？ 　　3）用户预期的解决方案是什么？ 　　重要的是理解用户对解决每个问题所放的相对重要性。分级和累积投票技术可以说明 　　必须解决的问题以及每个问题强调的事物。 　　2.5 替代品和竞争对手 　　确定用户认为目前可得到的替代品。可包括购买对手的产品、构建一个全部是自己的解决方案或者维持现状。列出所知的已有的以及即将得到的竞争对手的产品。包括最终用户所理解的每位对手的强项和弱项。 　　2.5.1 竞争对手1 3. 产品综述 　　这一部分对产品能力、到其他应用系统的接口以及系统配置等等提供一个高层视图，通常由以下三个部分组成。 　　3.1 产品前景 　　这部分应该合理地把该产品与其他相关产品及用户的需求放在一起。如果产品是独立的而且是完全独立的，就在这里说明它；如果产品是一个大型系统的组件之一，那么这一部分应该说明系统之间如何交互而且应该确定相关的接口。一种展示大型系统主要组件、互连及外部接口的简单方法就是利用框图。 　　3.2 产品定位陈述 　　提供一个整体陈述，从最高层次总结产品在市场上的独特定位。Moore（1991）称此为产品定位陈述，并推荐以下格式： （目标客户） 　　谁 （陈述需要或机遇） 　　产品名 是一个（产品分类） 　　它 （对主要优点的陈述，即驱动购买的原因） 　　不像 （主要竞争替代品） 我们的产品 （对主要区别的陈述） 　　产品定位陈述向所有相关人员说明了应用系统的意图以及项目的重要性。 　　3.3 能力总结 　　总结产品将提供的主要优点和特征。例如，客户支持系统的前景文档可能会使用这一部分强调问题建档、路电和状态报告—不提及各个功能需求的细节。 　　组织特征，以便清单能够被客户或所有第一次阅