第10章_IT软件项目文档管理课件

《第10章_IT软件项目文档管理课件》由会员分享，可在线阅读，更多相关《第10章_IT软件项目文档管理课件（32页珍藏版）》请在金锄头文库上搜索。

1、第10章 IT软件项目文档管理,10.1 软件项目文档管理概述 10.2 项目文档的质量 10.3 项目文档准备 10.4 主要项目文档,2020/7/22,辽宁工程技术大学 软件学院,1,10.1 软件项目文档管理概述,10.1.1 项目文档管理的概念 10.1.2 项目文档的分类 10.1.3 过程文档 10.1.4 产品文档,2020/7/22,辽宁工程技术大学 软件学院,2,10.1.1 项目文档管理的概念,能作为开发组员之间交流沟通的媒介。 能为软件项目的维护工程师提供有关信息系统的资料和知识库。 能为项目管理者提供项目计划、预算、开发进度等各方面的信息。 能作为最终用户或管理员的用

2、户手册，使用户知道如何使用、维护及管理系统。,2020/7/22,辽宁工程技术大学 软件学院,3,与软件项目相关的项目文档的概念属性有：,软件项目文档是IT软件项目开发中的重要组成部分。文档对于项目开发的成功和项目的正常维护起着重要的保证和支持作用。 一般：文档数量的多少、规模的大小、结构的复杂程度与所开发软件的大小和复杂程度成正比。,10.1.2 项目文档的分类,过程文档：是指那些记录软件项目开发和维护过程的文档资料，项目的计划、进度、过程质量、组织及项目标准等都是过程文档。 产品文档：是那些描述正在开发的产品的资料。这类文档又可以分为从软件工程师开发和维护系统的角度描述产品的系统文档，以及

3、主要以客户为对象描述产品的用户文档。 编写过程文档的主要目的在于所开发的产品能被很好地管理。产品文档一般在系统运行后才开始使用，同时它也对管理系统开发工作必不可少。不同时期编写的文档代表在软件开发过程中的一个重要阶段里程碑。,2020/7/22,辽宁工程技术大学 软件学院,4,文档可分为以下两大类，即过程文档和产品文档 ：,10.1.3 过程文档（1）,软件项目计划、预测和进度安排文档：这些文档由项目经理负责产生，以便预测和控制软件的开发过程。 相关报告：这些文档用来报告在软件开发过程中，资源是如何分配和利用的。 标准报告：这些文档规定了软件过程应该如何实现，这些可以是国际标准、国家标准、行业

4、标准等。 工作文档：这些文档是在项目开发中最主要的交流沟通工具，记录了软件项目开发中软件工程师的想法等。 备忘录及电子信息：主要记录了每天项目经理和开发人员之间的详细交流信息。,2020/7/22,辽宁工程技术大学 软件学院,5,过程文档可以分为如下几类：,10.1.3 过程文档（2）,过程文档的最大特点是：大部分文档都是已经过时了的。过程文档主要是软件项目开发过程中的各种事件和信息的记录。 在过程文档中，计划可以是由周计划、日计划或月计划组成，进度一般以周为单位进行报告，记录软件工程师的想法和目的备忘录将不断被改变。 大多数信息在过时后将没有多少使用价值，一般也就没有再保存的必要，但也有例外

5、，如测试计划等在软件开发过程中具有保存的价值，它是系统变更的基础；设计报告也具有保存的价值，它为维护系统提供依据等。,2020/7/22,辽宁工程技术大学 软件学院,6,10.1.4 产品文档（1）,产品文档主要描述已交付的软件产品情况，与大多数过程文档不同，产品文档有很长的生命周期，它必须随着产品一步步发展。 产品文档可以分为用户文档和系统文档 用户文档以文档资料形式告诉用户如何利用该系统； 系统文档主要为维护工程师服务。 在软件项目中，软件的用户并不完全相同，不同用户面向的文档也不一样，因此，在编辑文档时，必须将最终用户和系统管理员区分开。 最终用户主要是使用软件来完成一定的任务。他们只关

6、心如何利用软件来帮助他们完成工作，不关心计算机和软件管理上其他细节。 系统管理员负责管理最终用户使用的软件。,2020/7/22,辽宁工程技术大学 软件学院,7,10.1.4 产品文档（2）,2020/7/22,辽宁工程技术大学 软件学院,8,图10.1 需要随软件系统发布而产生的部分用户文档,10.1.4 产品文档（3）用户文档,系统功能描述：简要描述系统的需求和提供的服务。该文档为系统提供一个总体的概念描述。用户通过阅读该文档，可以确定是不是他们所需要的系统。 初级使用手册：为系统提供一个非正式的介绍，描述一些“常规”的使用操作。 系统参考手册：描述系统的功能设施及其用途，能为错误信息提供

7、一个完整的列表，并且描述怎样从发现的错误中恢复。系统参考手册应该是完整的和正式的。 系统安装文档：一般面向系统管理员，为系统管理员提供在特定环境下如何安装系统的详细说明。 系统管理员手册：主要提供当系统与其他系统交互时所产生的信息，及如何对这些信息进行反应的说明。,2020/7/22,辽宁工程技术大学 软件学院,9,10.1.4 产品文档（4）系统文档,系统文档包括所有描述系统是如何从需求报告到最终变成可接受的系统过程中，与分析、设计、实施等方面有关的技术文档。 系统文档主要包括： 需求文档及相关的基本原理说明。 系统体系结构文档。 对系统的每一个程序，都有相应的程序体系结构文档。 每个子系统

8、的规范和设计说明书。 程序代码列表。这些列表包括程序注释、用来解释代码中复杂代码段和采用的编码方法等。 描述每个程序怎样验证和验证信息与需求之间关系的验证文档。 维护指导文档，主要描述系统已知的问题、软件支持、硬件支持等信息，以便维护时使用。,2020/7/22,辽宁工程技术大学 软件学院,10,10.2 项目文档的质量,10.2.1 项目文档结构 10.2.2 文档标准 10.2.3 文档书写风格,2020/7/22,辽宁工程技术大学 软件学院,11,10.2.1 项目文档结构（1）,文档的内容决定了文档的结构，文档结构随项目不同而不同，但一般都要符合以下的基本原则： 所有文档（不论大小、长

9、短）都应该有封面，用来标识该项目文档的作者、制作时间、文档类型、配置管理、质量确保信息和文档的秘级等，还包括文档的摘要、关键字及版权信息。如图10.2。 文档应分章节描述。 如果文档包括许多细节性参考信息，应该有附录。 文档应该有难点注释和详细说明。 文档的结构通常应当是严整的，并且有一定的标准。,2020/7/22,辽宁工程技术大学 软件学院,12,10.2.1 项目文档结构（2）,2020/7/22,辽宁工程技术大学 软件学院,13,文档封面的主要信息：,10.2.2 文档标准（1）,过程标准：这种标准定义了高质量文档应该遵守的过程，定义了书写文档的方法。 产品标准：这种标准操纵文档本身。

10、适用于在软件开发过程中所有产生的文档。 交互标准：通过电子邮件和文档数据库交换文档变得越来越重要，交互标准使得所有的文档都存在可比性。交互标准的使用允许文档通过电子化的方式进行传递，能够相互理解和规范，并且在最初的格式上进行再创造。,2020/7/22,辽宁工程技术大学 软件学院,14,包括：,文档标准是保证文档质量的基础，根据一定的标准编写文档，可以有一致的外观、结构和质量等。,10.2.2 文档标准（2）文档编制过程,2020/7/22,辽宁工程技术大学 软件学院,15,图10.3 文档编制过程,10.2.2 文档标准（3）,文档编制中涉及到的一些产品标准有： 文档识别标准：项目都要产生许

11、多文档，每一个文档都要求有一个独特的识别标准。对于正式的文档，它的识别标准可以是由配置管理人员专门定义的；对于非正式的文档，其识别标准可以由项目经理来定义。 文档结构标准：在软件项目中每一种类型的文档都有一种合适的结构，结构标准就用来定义这种结构，可以采用传统的页码、页眉、页脚和章节等。 文档解释标准：文档解释标准定义了文档的总体“建筑风格”，包括文档中字体的大小、颜色及风格的定义等。 文档更新标准：系统的变更应在文档中反映，因此应该采用一种连续的方法来表示系统变更，即在文档中确定更新的标准。 文档标准要适用于所有项目文档及用户文档的最初版本。,2020/7/22,辽宁工程技术大学 软件学院,

12、16,10.2.3 文档书写风格,运用主动的而不是被动的语气。 运用正确的术语和语法结构。 句子不宜过长，尽量用短句。 段落简短。 用词简洁，不要长篇累犊，质量比数量更重要。 简明定义用到的专业术语。 应用标题和子标题。 尽可能地逐条列举事实。 不要单纯地参考数字、图、表来理解信息，应当有一定的说明和注释。,2020/7/22,辽宁工程技术大学 软件学院,17,编写文档时，也应该注意以下问题：,10.3 项目文档准备（1）,文档制作：文字处理器、文本格式器、表格和公式编辑器、绘图工具包等。 文档修改：拼写检查器和风格检查器。 文档产品发布：桌面发布包、技术工作包等。 最常用的文档工具是系统编辑

13、器，它支持文档的产生和修改过程。,2020/7/22,辽宁工程技术大学 软件学院,18,文档的准备分3个阶段 ：,10.3 项目文档准备（2）,2020/7/22,辽宁工程技术大学 软件学院,19,文档管理系统 ：,文档管理系统可以维护关联文档的索引，并且从文档的文本中产生索引。可以采用标准数据库、配置管理工具和系统文件来建造。它是一个松散集成的系统，并且在部分系统里要求一定的原则。,10.4 主要项目文档,10.4.1 项目开发立项报告 10.4.2 可行性研究报告 10.4.3 项目开发计划报告 10.4.4 项目分析报告 10.4.5 项目设计报告 10.4.6 程序设计报告 10.4.

14、7 项目测试报告 10.4.8 项目使用与维护手册 10.4.9 项目评价报告 10.4.10 项目开发总结报告,2020/7/22,辽宁工程技术大学 软件学院,20,10.4.1 项目开发立项报告,(1) 概述：概述现行系统的组织结构、功能、业务流程以及存在的主要问题。 (2) 新系统的目标：开发新系统的意义和新系统实现后的功能、技术指标、安全和保密性、新系统运行环境等。 (3) 经费预测和经费来源。 (4) 项目进度和完成期限。 (5) 验收标准和方法。 (6) 移交的文档资料。 (7) 开始可行性研究的组织队伍、机构与预算。 (8) 其他需要说明的有关问题。,2020/7/22,辽宁工程

15、技术大学 软件学院,21,项目开发立项报告是在项目正式开发前，由开发单位提出或委托开发单位提出要开发的新系统的目标、功能、费用、时间、对组织机构的影响等内容的申请项目立项文档。 项目开发立项报告主要包括以下内容 :,10.4.2 可行性研究报告,可行性研究报告主要包括以下内容 : (1) 系统概述。 (2) 新系统的目标、要求和约束。 (3) 可行性研究的基本准则。 (4) 现行系统描述及现行系统存在的主要问题。 (5) 新系统对现行系统的影响。 (6) 投资与效益分析。 (7) 其他可选方案及国内外同类方案的比较。 (8) 有关建议。,2020/7/22,辽宁工程技术大学 软件学院,22,可

16、行性研究阶段的文档是可行性研究报告。可行性研究报告是根据对现行系统的调查、分析和研究，提出若干个系统的开发方案及其评价，供领导进行决策。,10.4.3 项目开发计划报告,(1)概述：主要包括系统开发的主要目标、基本方针、参加人员、工作阶段和内容等。 (2)开发计划：系统开发各个工作阶段或者子项目的划分、任务、分工、负责人、计划时间(开始及结束时间)、人力资源需求、资金及设备消耗、实际执行情况等。可以用工作进度表、甘特图、网络图及关键路径法等工具辅助管理。 (3)验收标准：每项工作完成后验收的标准，包括时间、资金、质量等。 (4)协调方法：项目开发中各个单位、阶段之间的衔接、协调方法、负责人、权限等。,2020/7/22,辽宁工程技术大学 软件学院,23,项目开发计划报告主要包括以下内容 :,10.4.4 项目分析报告,(1) 概述 (2) 系统需求 (3) 新系统的目标与新系统的功能 (4) 新系统的逻辑模型 (5) 新系统的运行环境 (6) 新系统的验收标准与培训计划,2020/7/22,辽宁工程技术大学 软件学院,24,项目分析报告主要包括以下内容 :,10.4.5 项目设计报告