需求文档范例(教学用)

1《软件需求（第2版）》，清华大学出版社，2004-11-1【原书名】SoftwareRequirements,SEcondEdition[原书信息]【原出版社】MicrosoftPress【作者】（美）KarlE.Wiegers【译者】刘伟琴刘洪涛【开本】185×260【页码】357D需求文档范例..................................................................................................................2D.1前景和范围文档..........................................................................................................2D.1.1业务需求..........................................................................................................2D.1.2解决方案的前景..............................................................................................4D.1.3范围和局限性..................................................................................................5D.1.4业务上下文......................................................................................................6D.2用例..............................................................................................................................8D.3软件需求规格说明....................................................................................................15D.3.1介绍................................................................................................................15D.3.2总体描述........................................................................................................16D.3.3系统特性........................................................................................................18D.3.4外部接口需求................................................................................................22D.3.5其他非功能性需求........................................................................................23D.3.6附录A数据字典和数据模型......................................................................24D.3.7附录B分析模型............................................................................................28D.4业务规则....................................................................................................................292D需求文档范例该附录通过“自助食堂订餐系统（CafeteriaOrderingSystem，COS）”这样一个假想的小型项目，阐述了本书所描述的某些需求文档和图。这里包括如下这些内容：前景和范围文档。用例列表和若干用例描述。部分软件需求规格说明。某些分析模型。部分数据字典。若干业务规则。因为这仅仅是一个范例，所以我们并不打算完善这些需求元素。我们的目标只是提供一种思想，各种类型的需求信息之间彼此是如何关联的，并演示我们可能如何编写文档每一部分的内容。在一个小型项目中，将不同的需求信息综合到单一的文档中，常常是有意义的，因此我们可能没有单独的前景和范围文档、用例文档和软件需求规格说明。这些文档中的信息能够以多种其他合理的方式来组织。基本的目标是确保需求文档清晰明了、完整和易使用。这些文档总的来说都遵循照前面章节所描述的模板，但是，因为这只是一个小型项目，所以对这些模板稍微作了一些简化。有时，会将几个部分合并起来，这是为了避免信息重复。每一个项目都应该考虑如何适应组织的标准模板，以尽量适合于项目的规模和本质。D.1前景和范围文档D.1.1业务需求1.背景、业务机会和客户需要3目前，ProcessImpact公司的大多数员工平均每天要花费60分钟去自助食堂选择、购买并用午餐，其中大约有20分钟要花在公司和自助食堂之间的往返路程、选择自己喜欢的午餐、以及以现金方式或以信用卡方式结算餐费上。当员工出去用午餐时，他们平均有90分钟时间不在岗。有些员工提前给自助食堂打电话预订午餐，请自助食堂准备好他们所选择的午餐。但是，员工并不是总能如愿以偿，因为自助食堂有些食物己卖完，而与此同时，自助食堂又不可避免地会浪费大量的食物，因为有些食物没有卖出去而只好倒掉。早餐和晚餐同样面临着这样的问题，只是到自助食堂用餐的员工人数比午餐要少得多。许多员工都通过允许自助食堂用户在线订餐的一个系统而提出订餐请求，要求在指定的日期和时间内将所订的午餐送到公司的指定地点。通过这样一个系统，使用这一服务的员工可以节约相当可观的时间，而且订到自己所喜欢的食物的机会也增大了。这既提高了他们的工作生活质量，也提高了他们的生产率。自助食堂提前了解到客户需要哪些食物，就可以减少浪费，并提高自助食堂员工的工作效率。要求送货上门的订餐员工将来还可以从本地的饭店来订餐，这就大大扩大了员工对食物的选择范围，并通过与饭店的大量购餐协议而有可能节约费用。ProcessImpact公司也可以只在自助食堂订午餐，而在饭店订早餐、晚餐、特定事件的用餐以及周末会餐。2.业务目标（BusinessObjective，BO）和成功标准（SuccessCriteria，SC）BO-1：初始版本发布之后的6个月内，自助食堂的食物浪费减少50%。度量单位（scale）：自助食堂的工作人员每星期所倒掉的食物的价值。计量（meter）：检查“自助食堂存货系统（CafeteriaInventorySystem）”的日志。过去情况（past）[2002.初步调研]：30%一般标准（plan）：小于15%最低标准（must）：小于20%。注该范例展示了使用Planguage语言来精确陈述业务目标或其他需求这样一种方法。BO-2：初始版本发布之后的12个月内，自助食堂的运作费用减少50%。BO-3：初始版本发布之后的3个月内，每个雇员每天的平均有效工作时间增加20分钟。SC-1：目前通过自助食堂解决午餐问题的那些员工，在初始版本发布之后的6个月内，他们中有75%的人使用“自助食堂订餐系统”。SC-2：初始版本发布之后的3个月内，对自助食堂满意度的季度调查评价要提高0.5.而在初始版本发布之后的12个月内，这种满意度要提高1.0。3.业务风险（Risk）4RI-1：“自助食堂雇员联合会（CafeteriaEmp1oyeesUnion）”可能要求与雇员重新签订合同，以反映新的雇员角色和自助食堂营业时间。（可能性为0.6，影响为3）RI-2：使用该系统的雇员太少，减少了对系统开发和变更自助食堂经营过程的投资回报。（可能性为0.3.影响为9）RI-3：本地饭店可能并不认同减价是雇员使用这一系统的正当理由，这会减低雇员对该系统的满意度，并可能会减少他们对这一系统的使用。（可能性为0.4，影响为3）D.1.2解决方案的前景1.前景陈述对那些希望通过公司自助食堂或本地饭店在线订餐的员工来说，“自助食堂订餐系统”是一个基于Internet的应用程序，它可以接受个人订餐或团体订餐，结算用餐费用，并触发将预订餐送到ProcessImpact公司内的指定位置。与当前的电话订餐和人工订餐不同，使用“自助食堂订餐系统”的雇员并不需要到食堂内去用餐，这既可以节约他们的时间，又可以增加他们对食物的选择范围。2.主要特性（FEature）FE-1：根据自助食堂提供的选择菜单或送货菜单来订餐。FE-2：根据本地饭店的送货菜单来订餐。FE-3：创建、浏览、修改和删除用餐预订服务。FE-4：注册用餐的付费方式。FE-5：请求送餐。FE-6：创建、浏览、修改和删除自助食堂菜单。FE-7：预订自助食堂菜单上所没有的定做菜。FE-8：生成自助食堂定做菜的食谱和配料列表。FE-9：通过公司的内联网可以访问系统，或者授权的员工通过外部Internet访问系统。3.假设（ASsumption）和依赖（DEpendency）5AS-1：自助食堂内有可以访问公司内联网的计算机和打印机，这样自助食堂的雇员就可以处理期望的订单量，不会遗漏任何送货时间。AS-2：最多比请求的送货时间晚15分钟，自助食堂有送货人员和送货车辆，这样就能满足所有订单的送货要求。DE-1：如果某饭店有自己的联机订餐系统，那么“自助食堂订餐系统”必须能与这一系统进行双向通信。D.1.3范围和局限性1.初始版本和后续版本的范围特性版本1版本2版本3FE-1只能从午餐菜单中订标准餐：交货单的费用支付方式只能是从工资中扣除除了午餐订单外，也接受早餐订单和晚餐订单；费用的支付方式可以是信用卡和借记卡FE-2不实现不实现完全实现FE-3如果有时间就实现（具有中等优先级）完全实现FE-4注册的费用支付方式只能是从工资中扣除注册的费用支付方式可以是信用卡和借记卡FE-5送餐地点只能是公司内送餐地点还可以选择在公司外面FE-6完全实现FE-7不实现不实现完全实现FE-8不实现完全实现FE-9完全实现2.局限性（Limitation）和排斥性LI-1：自助食堂的有些食物不适宜于送货，因此“自助食堂订餐系统”的顾客所用的菜单是食堂整个菜单的一个子集。LI-2：“自助食堂订餐系统”只能用于俄勒冈州Clackamas的ProcessImpact公司总部内的自助食堂。6D.1.4业务上下文1.涉众概览涉众主要价值态度主要兴趣约束条件公司管理层提高员工生产率；节约自助食堂的费用强烈承诺完成版本2.如果有条件尽早完成版本3使用该系统所节约的费用必须超过开发此系统的费用和使用此系统的费用无自助食堂工作人员更高效地利用了工作人员的整个工作时间：提高了客户的满意度担心与联合会的关系，担心食堂有可能会裁员；否则很愿意接受新系统保住工作培训工作人员，掌握使用Internet所必需的技能；必须有送货人员和车辆顾客可以更好地选择食物；节约了时间：更加方便积极支持新系统，但使用系统