IT软件项目文档管理PPT课件

第10章IT软件项目文档管理 10 1软件项目文档管理概述10 2项目文档的质量10 3项目文档准备10 4主要项目文档 2020 4 16 上海海事大学计算机系 1 10 1软件项目文档管理概述 10 1 1项目文档管理的概念10 1 2项目文档的分类10 1 3过程文档10 1 4产品文档 2020 4 16 上海海事大学计算机系 2 10 1 1项目文档管理的概念 1 文档的地位是IT软件项目开发中的重要组成部分对于项目开发的成功和项目的正常维护起着重要的保证和支持作用2 项目文档的特点任何项目都有数量众多的文档一般 文档数量的多少 规模的大小 结构的复杂程度与所开发软件的大小和复杂程度成正比开发成本一大部分发生在文档的编制和准备过程中 2020 4 16 上海海事大学计算机系 3 3 文档的作用能作为开发组员之间交流沟通的媒介 能为软件项目的维护工程师提供有关信息系统的资料和知识库 能为项目管理者提供项目计划 预算 开发进度等各方面的信息 能作为最终用户或管理员的用户手册 使用户知道如何使用 维护及管理系统 2020 4 16 上海海事大学计算机系 4 10 1 2项目文档的分类 1 分类 文档可分为以下两大类 即过程文档和产品文档过程文档 是指那些记录软件项目开发和维护过程的文档资料 项目的计划 进度 过程质量 组织及项目标准等都是过程文档 产品文档 是那些描述正在开发的产品的资料 这类文档又可以分为从软件工程师开发和维护系统的角度描述产品的系统文档 以及主要以客户为对象描述产品的用户文档 2020 4 16 上海海事大学计算机系 5 2 编写过程文档目的 在于所开发的产品能被很好地管理产品文档一般在系统运行后才开始使用 同时它也对管理系统开发工作必不可少不同时期编写的文档代表在软件开发过程中的一个重要阶段里程碑 2020 4 16 上海海事大学计算机系 6 10 1 3过程文档 1 1 分类 软件项目计划 预测和进度安排文档 这些文档由项目经理负责产生 以便预测和控制软件的开发过程 相关报告 这些文档用来报告在软件开发过程中 资源是如何分配和利用的 标准报告 这些文档规定了软件过程应该如何实现 这些可以是国际标准 国家标准 行业标准等 工作文档 这些文档是在项目开发中最主要的交流沟通工具 记录了软件项目开发中软件工程师的想法等 备忘录及电子信息 主要记录了每天项目经理和开发人员之间的详细交流信息 2020 4 16 上海海事大学计算机系 7 2 过程文档特点 大部分文档都是已经过时了的 过程文档主要是软件项目开发过程中的各种事件和信息的记录 计划可以是由周计划 日计划或月计划组成 进度一般以周为单位进行报告 记录软件工程师的想法和目的备忘录将不断被改变 大多数信息在过时后将没有多少使用价值 一般也就没有再保存的必要 但也有例外 如测试计划等在软件开发过程中具有保存的价值 它是系统变更的基础 设计报告也具有保存的价值 它为维护系统提供依据等 2020 4 16 上海海事大学计算机系 8 10 1 4产品文档 1 1 特点 产品文档主要描述已交付的软件产品情况与过程文档不同 产品文档有很长的生命周期必须随着产品一步步发展2 分类产品文档可以分为用户文档和系统文档用户文档以文档资料形式告诉用户如何利用该系统系统文档主要为维护工程师服务 2020 4 16 上海海事大学计算机系 9 3 注意 在软件项目中 软件的用户并不完全相同 不同用户面向的文档也不一样 必须产生不同的文档来适应不同的任务和水平的用户在编辑文档时 必须将最终用户和系统管理员区分开最终用户主要是使用软件来完成一定的任务 他们只关心如何利用软件来帮助他们完成工作 不关心计算机和软件管理上其他细节系统管理员负责管理最终用户使用的软件 2020 4 16 上海海事大学计算机系 10 10 1 4产品文档 2 2020 4 16 上海海事大学计算机系 11 图10 1需要随软件系统发布而产生的部分用户文档 10 1 4产品文档 3 4 用户文档系统功能描述 简要描述系统的需求和提供的服务 该文档为系统提供一个总体的概念描述 用户通过阅读该文档 可以确定是不是他们所需要的系统 初级使用手册 为系统提供一个非正式的介绍 描述一些 常规 的使用操作 系统参考手册 描述系统的功能设施及其用途 能为错误信息提供一个完整的列表 并且描述怎样从发现的错误中恢复 系统参考手册应该是完整的和正式的 2020 4 16 上海海事大学计算机系 12 系统安装文档 一般面向系统管理员 为系统管理员提供在特定环境下如何安装系统的详细说明 系统管理员手册 主要提供当系统与其他系统交互时所产生的信息 及如何对这些信息进行反应的说明 2020 4 16 上海海事大学计算机系 13 10 1 4产品文档 4 5 系统文档 系统文档包括所有描述系统是如何从需求报告到最终变成可接受的系统过程中 与分析 设计 实施等方面有关的技术文档 主要包括 需求文档及相关的基本原理说明 系统体系结构文档 对系统的每一个程序 都有相应的程序体系结构文档 每个子系统的规范和设计说明书 2020 4 16 上海海事大学计算机系 14 程序代码列表 这些列表包括程序注释 用来解释代码中复杂代码段和采用的编码方法等 描述每个程序怎样验证和验证信息与需求之间关系的验证文档 维护指导文档 主要描述系统已知的问题 软件支持 硬件支持等信息 以便维护时使用 2020 4 16 上海海事大学计算机系 15 6 文档编制的注意事项系统维护的要求 文档与文档之间的关系与依赖都应该记录在配置管理数据库中修改代码引起的文档变化 应该采用记录文档关系的软件工具来支持文档维护 当一个文档变化引起其他文件变化是 提醒工程师 2020 4 16 上海海事大学计算机系 16 10 2项目文档的质量 10 2 1项目文档结构10 2 2文档标准10 2 3文档书写风格 2020 4 16 上海海事大学计算机系 17 1 概述文档质量与程序质量一样重要没有说明如何使用系统和理解系统的文档 系统实用性会大打折扣高质量文档产生既不容易也不便宜 与编制高质量的程序一样困难 2020 4 16 上海海事大学计算机系 18 10 2 1项目文档结构 1 1 文档结构的基本原则文档的内容决定了文档的结构 文档结构随项目不同而不同 但一般都要符合以下的基本原则 所有文档 不论大小 长短 都应该有封面 用来标识该项目文档的作者 制作时间 文档类型 配置管理 质量确保信息和文档的秘级等 还包括文档的摘要 关键字及版权信息 如图10 2 文档应分章节描述 如果文档包括许多细节性参考信息 应该有附录 文档应该有难点注释和详细说明 文档的结构通常应当是严整的 并且有一定的标准 2020 4 16 上海海事大学计算机系 19 2020 4 16 上海海事大学计算机系 20 10 2 1项目文档结构 2 文档封面的主要信息 10 2 2文档标准 1 1 重要性文档标准是保证文档质量的基础 根据一定的标准编写文档可以有一致的外观 结构和质量等 2 类型过程标准 这种标准定义了高质量文档应该遵守的过程产品标准 这种标准操纵文档本身交互标准 通过电子邮件和文档数据库交换文档变得越来越重要 交互标准使得所有的文档都存在可比性 交互标准的使用允许文档通过电子化的方式传递 能够相互理解和规范 并且在最初的格式上进行再创作 2020 4 16 上海海事大学计算机系 21 过程标准定义了书写文档的方法 规定了书写文档时采用的软件工具 同时也定义了高质量文档的质量确保程序过程标准必须灵活文档编制过程是一个不断重复的过程 这个过程应该直到一个可接受的质量是才停止可接受的质量水平依赖于文档的种类和它潜在的用户水平 2020 4 16 上海海事大学计算机系 22 2020 4 16 上海海事大学计算机系 23 10 2 2文档标准 2 文档编制过程 图10 3文档编制过程 产品标准适用于在软件开发过程中所产生的文档 文档应该有一个统一的外观 同一类文档应该有统一的结构应该基于更一般的行业标准 2020 4 16 上海海事大学计算机系 24 10 2 2文档标准 3 文档编制中涉及到的一些产品标准有 文档识别标准 项目都要产生许多文档 每一个文档都要求有一个独特的识别标准 对于正式的文档 它的识别标准可以是由配置管理人员专门定义的 对于非正式的文档 其识别标准可以由项目经理来定义 文档结构标准 在软件项目中每一种类型的文档都有一种合适的结构 结构标准就用来定义这种结构 可以采用传统的页码 页眉 页脚和章节等 文档解释标准 文档解释标准定义了文档的总体 建筑风格 包括文档中字体的大小 颜色及风格的定义等 文档更新标准 系统的变更应在文档中反映 因此应该采用一种连续的方法来表示系统变更 即在文档中确定更新的标准 2020 4 16 上海海事大学计算机系 25 文档标准要适用于所有项目文档及用户文档的最初版本 2020 4 16 上海海事大学计算机系 26 10 2 3文档书写风格 文档的质量依赖于编写者的文字组织能力 好的文档需要好的文笔编写文档时要注意以下问题 运用主动的而不是被动的语气 运用正确的术语和语法结构 句子不宜过长 尽量用短句 段落简短 用词简洁 不要长篇累犊 质量比数量更重要 简明定义用到的专业术语 2020 4 16 上海海事大学计算机系 27 10 2 3文档书写风格 应用标题和子标题 尽可能地逐条列举事实 不要单纯地参考数字 图 表来理解信息 应当有一定的说明和注释 文档要像程序一样采用相同的方法进行检测 在后期主要侧重在错误的发现而不是错误的修改机制上 2020 4 16 上海海事大学计算机系 28 10 3项目文档准备 1 1 阶段文档制作 文字处理器 文本格式器 表格和公式编辑器 绘图工具包等 文档修改 拼写检查器和风格检查器 文档产品发布 桌面发布包 技术工作包等 最常用的文档工具是系统编辑器 它支持文档的产生和修改过程 2020 4 16 上海海事大学计算机系 29 10 3项目文档准备 2 文档管理系统 2020 4 16 上海海事大学计算机系 30 文档管理系统可以维护关联文档的索引 并且从文档的文本中产生索引 可以采用标准数据库 配置管理工具和系统文件来建造 它是一个松散集成的系统 并且在部分系统里要求一定的原则 10 4主要项目文档 10 4 1项目开发立项报告10 4 2可行性研究报告10 4 3项目开发计划报告10 4 4项目分析报告10 4 5项目设计报告10 4 6程序设计报告10 4 7项目测试报告10 4 8项目使用与维护手册10 4 9项目评价报告10 4 10项目开发总结报告 2020 4 16 上海海事大学计算机系 31 2020 4 16 上海海事大学计算机系 32 10 4 1项目开发立项报告 1 概述 概述现行系统的组织结构 功能 业务流程以及存在的主要问题 2 新系统的目标 开发新系统的意义和新系统实现后的功能 技术指标 安全和保密性 新系统运行环境等 3 经费预测和经费来源 4 项目进度和完成期限 5 验收标准和方法 6 移交的文档资料 7 开始可行性研究的组织队伍 机构与预算 8 其他需要说明的有关问题 项目开发立项报告是在项目正式开发前 由开发单位提出或委托开发单位提出要开发的新系统的目标 功能 费用 时间 对组织机构的影响等内容的申请项目立项文档 项目开发立项报告主要包括以下内容 2020 4 16 上海海事大学计算机系 33 10 4 2可行性研究报告 可行性研究报告主要包括以下内容 1 系统概述 2 新系统的目标 要求和约束 3 可行性研究的基本准则 4 现行系统描述及现行系统存在的主要问题 5 新系统对现行系统的影响 6 投资与效益分析 7 其他可选方案及国内外同类方案的比较 8 有关建议 可行性研究阶段的文档是可行性研究报告 可行性研究报告是根据对现行系统的调查 分析和研究 提出若干个系统的开发方案及其评价 供领导进行决策 2020 4 16 上海海事大学计算机系 34 10 4 3项目开发计划报告 1 概述 主要包括系统开发的主要目标 基本方针 参加人员 工作阶段和内容等 2 开发计划 系统开发各个工作阶段或者子项目的划分 任务 分工 负责人 计划时间 开始及结束时间 人力资源需求 资金及设备消耗 实际执行情况等 可以用工作进度表 甘特图 网络图及关键路径法等工具辅助管理 3 验收标准 每项工作完成后验收的标准 包括时间 资金 质量等 4 协调方法 项目开发中各个单位 阶段之间的衔接 协调方法 负责人 权限等 项目开发计划报告主要包括以下内容 2020 4 16 上海海事大学计算机系 35 10 4 4项目分析报告 1 概述 2 系统需求 3 新系统的目标与新系统的功能 4 新系统的逻辑模型 5 新系统的运行环境 6 新系统的验收标准与培训计划 项目分析报告主要包括以下内容 2020 4 16 上海海事大学计算机系 36 10 4 5项目设计报告 1 系统概述 2 系统总体结构 3 计算机系统配置方案 4 代码设计 5 文件 数据库设计 6 输入输出设计 7 计算机处理过程设计 8 接口及通信环境设计 9 安全保密设计 10 数据准备 11 系统测试计划 12 培训计划 包括以下内容 2020 4 16 上海海事大学计算机系 37 10 4 6程序设计报告 1 概述 2 程序结构图 3 程序控制图 4 算法 5 程序流程图 6 源程序 7 程序注释及说明 包括以下内容 2020 4 16 上海海事大学计算机系 38 10 4 7项目测试报告 1 概述 说明项目测试的目的 2 测试环境 有关软 硬件 通信 数据库 人员等情况 3 测试内容 系统 子系统 模块的名称 性能技术指标等 4 测试方案 测试的方法 测试数据 测试步骤 测试中故障的解决方案等 5 测试结果 测试的实际情况 6 结论 项目功能评价 性能技术指标评价 结论 包括以下内容 2020 4 16 上海海事大学计算机系 39 10 4 8项目使用与维护手册 1 概述 主要包括系统功能 系统运行环境 软硬件环境 系统安装等内容 2 使用说明 系统操作使用说明较为详细地说明了操作的目的 过程 方式 输入输出的数据等 最好将系统操作的界面图放入说明书中 便于使用者学习与操作 3 问题解释 解释了系统使用中可能出现的问题及解决办法 如非常规操作命令 系统恢复过程及意外情况 与开发单位的联系方式等 包括以下内容 2020 4 16 上海海事大学计算机系 40 10 4 9项目评价报告 项