《现代软件工程应用技术》项目九 软件文档与软件工程标准

项目九

软件文档与软件工程标准---------基于企业设备状况管理系统【本章概要】·软件文档·案例：企业设备状况管理系统相关文档·软件工程标准任务9.1软件文档简介9.1.1软件文档定义1983年IEEE为软件下的定义是：计算机程序、方法、规则、相关文档资料以及在计算机上运行程序时所必需的数据。其中方法和规则通常是在文档中说明并在程序中实现的。任务9.1软件文档简介9.1.2软件文档作用软件文档的作用简要概括如下：1)提高软件开发过程的能见度。2)提高开发效率。3)作为开发人员在一定阶段的工作成果和结束标志。

4)软件维护人员需要软件系统的详细说明，从而有助于理解、熟悉系统，找出并修正错误，改进并完善系统以适应用户需求的变化或适应系统环境的变化。任务9.1软件文档简介5)提供了软件的运行、维护和培训的有关信息，便于管理人员、开发人员、操作人员、用户之间的协作、交流和了解。使软件开发活动更科学、更有成效。

6)质量的保证。

总的说来，软件文档应该满足下述要求。1）必须描述如何使用这个系统，没有这种描述即使是最简单的系统也无法使用。2）必须描述怎样安装和管理这个系统。3）必须描述系统需求和设计。4）必须描述系统的实现和测试，以便使系统成为可维护的。任务9.1软件文档简介9.1.3软件文档的分类软件文档大致可分为以下3类。(1)开发文档。(2)管理文档。(3)用户文档。案例9.2：企业设备状况管理系统相关文档9.2.1可行性分析（研究）报告（FAR）9.2.2系统开发计划（SDP）9.2.3软件需求分析报告（SRS）9.2.4软件测试计划（STP）9.2.5系统结构设计说明书（SDD）9.2.6详细设计说明书9.2.7软件测试报告（STR）9.2.7项目开发总结报告（PDSR）任务9.3软件工程标准9.3.1软件工程标准简介软件工程标准可分为5个级别。即国际标准、国家标准、行业标准、企业标准和项目标准。(1)国际标准。国际标准主要由国际联合机构制定和公布，提供各国参考的标准，其中最著名的就是ISO(InternationalStandardsOrganization)国际标准化组织。(2)国家标准。国家标准由国家政府机构制定、批准,是适用于全国范围的标准。·GB：中国国家技术监督局是中国的最高标准化机构，它所公布实施的标准简称“国标”，常以“GB”字母开头。·ANSI：美国国家标准协会。·Bs：英国国家标准。·JIs：日本工业标准。

任务9.3软件工程标准(3)行业标准。行业标准由行业机构、学术团体制定，并适用于某个业务领域的标准，如IEEE(InstituteofElectricalandE1ectronicsEngineers)—美国电气与电子工程师学会。(4)企业标准。企业标准又称为企业规范，是一些大型企业或公司制定的适用于本组织的规范。例如，美国IBM公司制定的《软件程序设计开发指南》仅供该公司内部使用。(5)项目标准。项目标准又称为项目规范，是由某一科研生产项目组织制定的，且为该项任务专用的软件工程规范。任务9.3软件工程标准9.3.2ISO9000国际标准ISO9000由5个相关标准组成，它们分别是ISO9000质量管理和质量保证标准---选择和使用的导则。ISO9001质量体系---设计／开发、生产、安装和服务中的质量保证模式。ISO9002质量体系---生产和安装中的质量保证模式。ISO9003质量体系---最终检验和测试中的质量保证模式。ISO9004质量管理和质量体系要素---导则。任务9.3软件工程标准9.3.3中国的软件工程标准分

类标准名称标

准

号基础标准

软件工程术语GB/T11457-1995

信息处理---数据流程图、程序流程图、系统流程图、程序网络图和系统资源图的文件编辑符号，以及约定软件工程标准分类法GB/T15538-1995

信息处理---程序构造及其表示法的约定GB13502-1992

信息处理---判定表规范GB/T15535-1995

计算机系统配置图符号及其约定GB/T14085-1993开发标准

软件开发规范GB8566-1988

计算机软件单元测试GB/T15532-1995

软件支持环境GB/T15853-1995

软件维护指南GB/T14079-1993文档标准

软件文档管理指南GB/T16680-1996

计算机软件产品开发文件编制指南GB8567-1988

计算机软件需求说明编制指南GB9385-1988

计算机软件测试文件编制规范GB9386-1988管理标准

计算机软件配置管理计划规范GB/T12505-1990

计算机软件可靠性和可维护性管理GB/T14394-1993

计算机软件质量保证计划规范GB/T12504-1990表9-20中国的主要软件工程标准案例9.4：企业设备状况管理系统相关文档9.4.1可行性分析（研究）报告（FAR）9.4.2系统开发计划（SDP）9.4.3软件需求分析报告（SRS）9.4.4软件测试计划（STP）9.4.5系统结构设计说明书（SDD）9.4.6详细设计说明书9.4.7软件测试报告（STR）9.4.8项目开发总结报告（PDSR）小结

项目介绍了软件项目文档的作用和书写规范以及软件工程管理标准。文档(Document)是指某种数据媒体及其所记录的数据。文档具有永久性，并可以被人或机器阅读，通常仅用于描述人工可读的内容。在软件工程中，文档用来表示对软件项目活动、需求、过程、结果进行描述、定义、规定、报告和认证的各种书面或图示信息。软件文档描述和规定了软件设计和实现的细节，说明使用软件的