06 软件开发文档幻灯片

《06 软件开发文档幻灯片》由会员分享，可在线阅读，更多相关《06 软件开发文档幻灯片（54页珍藏版）》请在金锄头文库上搜索。

1、第5章 软件开发文档5.1 5.1 可行性研究报告可行性研究报告 4.2 4.2 软件需求文档软件需求文档 4.34.3 概要设计文档概要设计文档 4.44.4 详细设计详细设计文档文档About this chapter软件开发文档对软件开发过程及内容进行 描述，包括可行性研究报告、软件需求说明 书、软件概要设计说明书和软件详细设计说 明书。5.1 可行性研究报告在软件开发的第一个阶段。即可行性研究与计 划阶段，主要任务是了解用户的需求和现实环境， 研究并论证项目的可行性，提出系统方案，制定初 步的项目开发计划。可行性研究报告是这一阶段工 作成果的主要标志之一。计算机软件产品开发文档编制指南

2、指出，可 行性研究报告的编写目的是：“说明该软件开发项目 的实现在技术上、经济上和社会条件上的可行性； 评述为合理地达到目标可能选择的各种方案；说明 并论证所选定的方案。”郑州大学信息工程学院 徐婷软件文档1-41.可行性研究报告的内容对于确定的问题，判定能否解决，是否值得解决， 是可行性研究的根本任务。 因此可以按以下内容组织可行性研究报告： 陈述开发软件的目标、要求和限制条件，表达可行性研 究的前提条件。 对现有系统的描述。现有系统指当前实际使用的系统， 这个系统可能是计算机系统，也可能是一个机械系统甚至是 一个人工系统。分析现有系统的目的是为了进一步阐明建议 中的开发新系统或修改现有系统

3、的必要性。 提出若干个新系统的建议方案，对每个方案的技术、 经济和社会再行性进行分析。 在比较多个方案的基础上得出可行性研究的结论。5.1 可行性研究报告郑州大学信息工程学院 徐婷软件文档1-52.可行性研究报告的要求软件的开发首先要确切定义所要解决的问题。软件开发部门的分析人员对客户要求及现实环境进 行调查之后，就应该确定问题的性质、目标和规模。分 析人员对所解决的问题的理解是否正确十分关键，因为 它决定了开发工作的方向。尤其在用户提出的软件要求 比较含糊和简略的情况下，分析人员应该首先进行角色 的转换，将自己带入到用户所处的位置，试着自己提出 一些需求，而不是等用户将所有的需求告诉分析人员

4、。5.1 可行性研究报告郑州大学信息工程学院 徐婷软件文档1-62.可行性研究报告的要求 报告应该阐明所开发软件的基本要求。如功能、性能、 输出 、输入、处理流程和数据流程、在安全与保密方面的要求、同 本系统相联系的其他系统、完成期限等。 报告应该说明所建议系统的主要开发目标。如人力与设备费 用的减少、 处理速度的提高、控制精度或生产能力的提高、管 理信息服务的改进、自动决策系统的改进、人员利用率的改进 等。 报告应该说明对这项开发中给出的条件、假定和所受到的限 制。如所建议系统的运行寿命的最小值， 进行系统方案选择比 较的时间、经费、投资方面的来源和限制，法律和政策方面的 限制，硬件、软件、

5、运行环境和开发环境方面的条件和限制， 可利用的信息和资源，系统投入使用的最晚时间。5.1 可行性研究报告郑州大学信息工程学院 徐婷软件文档1-72.可行性研究报告的要求 报告应该说明进行可行性研究的方法和评价尺度。如说明这 项可行性研究将是如何进行的，所建议的系统将是如何评价的 ；说明对系统进行评价时所使用的主要尺度，如费用多少、各 项功能的优先次序、开发时间的长短及使用中的难易程度。 报告应该对现有系统进行分析。现有系统是待开发系统的取 代对象，对现有系统的分析是为了阐明开发新系统的必要性， 同时也是导出新系统方案的出发点。5.1 可行性研究报告郑州大学信息工程学院 徐婷软件文档1-83.可

6、行性研究报告的描述方法 （1）数据流图数据流图是表达软件系统处理功能的合适工具。在 可行性研究报告里建议使用数据流图描述现有系统和每个候 选系统中数据的流动、存储和处理状况，作为系统逻辑模型 的图形表示。有四类基本元素： 数据流：表示含有固定成分的动态数据。 处理：表示对数据进行的操作，它是数据流变换的原因。 数据存储：表示处在静止状态，需要暂时存储的数据。 圆点和终点：表示数据流的产生处和最终抵达处。通常可 能是系统外的部门、人员和组织。5.1 可行性研究报告郑州大学信息工程学院 徐婷软件文档1-93.可行性研究报告的描述方法 （2）系统流程图系统流程图是系统数据加工逻辑能力的抽象表示。在设

7、 计阶段，设计结果要从抽象的逻辑模型向物理系统转换。广义的处理用特定的程序替代，数据存储由具体物理设 备上的文档或数据库替换，数据流也要有相应的存储介质。 系统流程图就可以用来表达实现系统逻辑功能的设计思想， 是概括大量技术信息的好工具。所以图是对现有系统和每个 候选系统方案的描述手段之一。它要表达数据在每个系统的各个物理组成部分之间的流 动情况，因此是系统物理模型概貌的描绘，实际上是物理数 据流图。5.1 可行性研究报告郑州大学信息工程学院 徐婷软件文档1-104.可行性研究报告的评审经过可行性研究工作阶段，系统分析人员对待开发 软件的目标、规模、开发工作量已经有了比较接近实际 情况的认识。

8、由分析人员完成的软件项目可行性研究报 告必须经由开发部门和用户部门负责人评审通过后，方 可成为正式软件文档，作为后续开发阶段的工作依据。若决定继续开发此项目，则应制定初步的项目开发 计划，并根据需要签署开发合同。5.1 可行性研究报告郑州大学信息工程学院 徐婷软件文档1-115.2 软件需求文档尽管在进行可行性研究时已经提出了软件项目的 一些可行的方案，但由于分析和设计的过程较粗，其 目的只是在较短时间内确定问题并分析问题的解是否 存在。所以在软件需求分析阶段的首要任务仍然是为 待开发软件提出准确而详尽的要求，包括功能、性能 、数据和运行环境等，为下阶段的概要设计提供目标 和依据。这个阶段的工

9、作出发点应该是可行性研究报告。 首先是选择方案中的数据流图，通过更详尽的环境和 业务调查，进一步明确用户需求，修正和细化数据流 图，以表示软件的数据处理功能。功能分析要落实到 每一个最基本的数据元素，也就是数据流和数据存储 中不可再划分的基本数据成分。郑州大学信息工程学院 徐婷软件文档1-125.2 软件需求文档除了功能分析外，还要确定被开发软件的其他一 些综合需求，如性能、数据、运行环境(设备、支持 软件、接口等)、系统层次上的输入输出、安全控制 、故障恢复要求等。对于需要保存的数据，即数据流图上的数据存储 ，尚须从整体上考虑它们的分组、规范化，分析各个 信息实体分组之间的对应联系，从而为设

10、计阶段设计 全局数据存储结构(文档或数据库)提供前提条件。表 达这种全局性存储数据的联系的简明手段，常选 ER( 实体关系)图。ER图用简单的三四种符号表示组成 信息实体的属性、实体以及实体之间的联系。因此是 对系统中要暂时或长期保存数据的更深层次的刻画， 可称之为概念信息结构。郑州大学信息工程学院 徐婷软件文档1-135.2 软件需求文档综合上述各种分析结果，就导出了被开发软件的 逻辑模型。也就是说，通过逻辑模型清晰而又准确地 刻画出软件必须做什么才符合用户的目标和要求。在软件需求分析阶段的工作成果用两个文档来表 示。其中，软件需求说明书的编制是为了用户和软件 开发者双方对软件的初始规定有一

11、个共同的理解，使 之成为整个开发工作的基础。而数据要求说明书的编 制目的则是提供关于被处理数据的描述和数据采集要 求的技术信息。郑州大学信息工程学院 徐婷软件文档1-145.2 软件需求文档在需求描述中，对软件的功能描述占据着核心地 位。软件的功能归根到底就是对数据的处理，因此功 能的描述和数据的描述应该是密不可分的。对于一般 系统可以编制一份软件需求说明书，其功能描述部分 以数据流图为核心，以体现功能和数据需求描述的重 叠。同时包括对基本的数据元素的属性的描述、对存 储数据的概念信息结构的描述、 对数据加工动作的 说明。再加上对软件其他方面需求的描述，如性能、 运行环境、系统级上的输入输出数

12、据格式等，即构成 对软件及其数据的完整描述信息。郑州大学信息工程学院 徐婷软件文档1-155.2 软件需求文档1.软件需求文档的特点软件需求说明(SRS)处于软件生命周期的开始，对其进 行正确、精确的描述是设计、开发满足客户需求软件的 前提和基础。为此，编制的SR8必须具有如下特点：（1）无歧义性 要求最终产品的每一个特性用某一术语描述。 若某一术语在某一特殊的行文中使用时具有多种歧义 ，那么对该术语的每种含义作出解释并指出其适用场合 。郑州大学信息工程学院 徐婷软件文档1-165.2 软件需求文档（2）完整性 包括全部有意义的要求，无论是关系到功能、性能、 设计约束的，还是关系到属性或外部接

13、口方面的需求。 对所有可能出现的输入数据的响应予以定义，要对合 法和非合法的输入值的响应作出规定。 要符合SRS要求。如果个别章节不适用，则在SRS中要 保留章节号。 填写SRS中的全部插图、表、图示标记和参照，并且定 义全部术语和度量单位。郑州大学信息工程学院 徐婷软件文档1-175.2 软件需求文档（3）可验证性当且仅当SRS中描述的每一个需求都是可以验证 的，该SRS才是可以验证的；当且仅当在某一性能价 格比可取的有限处理过程，人或机器能通过该过程检 查软件产品能否满足需求时，才称这个需求是可以验 证的。 （4）一致性当且仅当SRS中各个需求的描述是不矛盾时SRS 才是一致的。郑州大学信

14、息工程学院 徐婷软件文档1-185.2 软件需求文档（5）可修改性如果一个SRS的结构和风格在需求有必要改变时是易于 实现的、完整的、一致的，那么这个SRS就是可以修改的。 可修改性要求SRS具备以下条件： 具有一个有条不紊的易于使用的内容组织，具有目录 表、索引和明确的交叉引用表。 避免冗余，即同一需求不能在SRS中出现多次。冗余本身不是错误，但是容易发生错误。冗余可增加 SRS的可读性，但是在一个冗余文档被更新时容易出现问题 。例如，假设一个明确的需求在两个地方详细列出，后来 发现这个需求需要改变，若只修改一个地方，则SRS就变得 不一致了。不管冗余是否必需，SRS一定要包含一个详细的 交

15、叉引用表，以便SRS具备可修改性。郑州大学信息工程学院 徐婷软件文档1-195.2 软件需求文档（6）可追踪性如果每一个需求的源流是清晰的，在产生和改变文档 时，可以方便地引证每一个需求，则该SRS就是可追踪的 。建议采用如下两种类型的追踪。 向后追踪(即向已开发过的前一阶段追踪)：根据先 前文档或本文档前面的每一个需求进行追踪。 向前追踪(即向由SRS派生的所有文档追踪)：根据 SRS中具有惟一的名字和参照号的每一个需求进行追踪。郑州大学信息工程学院 徐婷软件文档1-205.2 软件需求文档（6）可追踪性当SRS中的一个需求表达另一个需求的一种指派或者 是派生的，向前、向后的追踪都要提供。 例如：从总的用户响应时间需求中分配给数据库操作响应时间。识别带有一定功能和用户接口的需求的报告格式。支持法律或行政上需要的某个软件产品(例如计算税收)。 在这种情况下，要指出软件所支持的确切的法律或行政文档。当软件产品进入运行和维护阶段时，SRS的向前可追踪 性显得特别重要。当编码和设计文档作修改时，重要的 是要查清这些修改所影响的全部需求。郑州大学信息工程学院 徐婷软件文档1-215.2 软件需求文档（7）运行和维护阶段的可使用性SRS必须满足运行和维护阶段的需要，包括软件最终 替换。维护常常是由与原来开发无联系的人来进行的。局部 的