软件过程标准化和软件文档课件.ppt

《软件过程标准化和软件文档课件.ppt》由会员分享，可在线阅读，更多相关《软件过程标准化和软件文档课件.ppt（70页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、n n什么是软件工程标准什么是软件工程标准n n软件工程标准的层次软件工程标准的层次n n中国的软件标准中国的软件标准n nISO 9000-3标准及软件质量认证标准及软件质量认证n n软件软件文档的作用与分类文档的作用与分类n n对文档编制的质量要求对文档编制的质量要求什么是软件工程标准什么是软件工程标准n n软件危机的出路在于软件开发的软件危机的出路在于软件开发的工程工程化化和和标准化标准化。n n程序设计语言的标准化程序设计语言的标准化：为某一程序：为某一程序设计语言规定若干个标准子集，对于设计语言规定若干个标准子集，对于语言的实现者和用户都带来了很大方语言的实现者和用户都带来了很大方便

2、。便。n n软件过程的标准化软件过程的标准化：软件生存期各个：软件生存期各个阶段的工作建立标准或规范。阶段的工作建立标准或规范。软件工程标准的类型软件工程标准的类型n n国家标准国家标准GBT 155381995软件工软件工程标准分类法程标准分类法给出软件工程标准的给出软件工程标准的分类。分类。n n涉及涉及过程管理过程管理、产品管理产品管理、资源管理资源管理，以及以及确认与验证确认与验证。n n过程标准过程标准 方法、技术、度量方法、技术、度量n n产品标准产品标准 需求、设计、部件、描述、计划、报需求、设计、部件、描述、计划、报告告n n专业标准专业标准 职别、道德准则、认证、特许、课职别

3、、道德准则、认证、特许、课程程n n记法标准记法标准 术语、表示法、语言术语、表示法、语言软件工程标准化的作用软件工程标准化的作用n n可提高软件的可提高软件的可靠性可靠性、可维护性可维护性和和可可移植性移植性；n n可提高软件人员的可提高软件人员的技术水平技术水平，减少差，减少差错和误解；错和误解；n n可提高软件人员之间的可提高软件人员之间的通信效率通信效率，提，提高软件的高软件的生产率生产率；n n有利于软件管理；有利于有利于软件管理；有利于降低软件产降低软件产品的成本品的成本和和运行维护成本运行维护成本；n n有利于有利于缩短软件开发周期缩短软件开发周期。软件工程标准的层次软件工程标准

4、的层次(1)国际标准国际标准 由国际联合机构制定和公布，提供各由国际联合机构制定和公布，提供各国参考的标准。国参考的标准。uu 国际标准化组织国际标准化组织 ISO(International Standards Organization)uu 这一国际机构有着广泛的代表性和这一国际机构有着广泛的代表性和权威性，它所公布的标准也有较大的权威性，它所公布的标准也有较大的影响。影响。uu ISO建立了建立了“计算机与信息处理技术计算机与信息处理技术委员会委员会”,简称简称ISOTC97，专门负责专门负责与计算机有关的标准化工作。与计算机有关的标准化工作。uu 这一标准通常冠有这一标准通常冠有ISO

5、字样，如字样，如 ISO 863186 Information processing_program constructs and conventions for their representation信息处理信息处理程序构造及其表示法的程序构造及其表示法的约定约定。该标准现已由中国收入国家。该标准现已由中国收入国家标准。标准。(2)国家标准国家标准 由政府或国家级的机构制定或批准，适由政府或国家级的机构制定或批准，适用于全国范围的标准用于全国范围的标准，如：，如：uu GB 中华人民共和国国家技术监督中华人民共和国国家技术监督局局公布实施的标准，简称公布实施的标准，简称“国标国标”。现。现

6、已批准了若干软件工程标准。已批准了若干软件工程标准。u ANSI(American National Standards Institute)美国国家标准协会。这美国国家标准协会。这是美国一些民间标准化组织的领导机是美国一些民间标准化组织的领导机构，构，uu FIPS(NBS)Federal Information Processing Standards(National Bureau of Standards)美国商务美国商务部国家标准局联邦信息处理标准。部国家标准局联邦信息处理标准。uu BS(British Standard)英国国家英国国家标准。标准。uu DIN(Deutsches

7、 Institut fr Nor-mung)德国标准协会德国标准协会uu JIS(Japanese Industrial Standard)日本工业标准日本工业标准(3)行业标准行业标准 由行业机构、学术团体或国防机构制定，由行业机构、学术团体或国防机构制定，适用于某个业务领域的标准。适用于某个业务领域的标准。uu IEEE(Institute of Electrical and Electronics Engineers)美国电气与电子工程师学会。该学会有一个该学会有一个软件标准分技术委员会软件标准分技术委员会(SESS)，负责软件标准化活动。负责软件标准化活动。IEEE公布的标准常冠有公布

8、的标准常冠有ANSI的字头。例如，的字头。例如，ANSIIEEE Str 8281983软件配软件配置管理计划标准置管理计划标准。n nGJB中华人民共和国国家军用标准。中华人民共和国国家军用标准。这是由这是由中国国防科学技术工业委员会中国国防科学技术工业委员会批准，适合于国防部门和军队使用的批准，适合于国防部门和军队使用的标准。例如，标准。例如，GJB 43788军用软件军用软件开发规范开发规范。n nDOD_STD(Department Of Defense _STanDards)美国国防部标准，适美国国防部标准，适用于美国国防部门。用于美国国防部门。n nMIL_S(MILitary_S

9、tandard)美国美国军用标准，适用于美军内部。军用标准，适用于美军内部。(4)企业规范企业规范 一些大型企业或公司，由于软件工程一些大型企业或公司，由于软件工程工作的需要，制定适用于本部门的规工作的需要，制定适用于本部门的规范。范。uu 例如，例如，美国美国IBM公司通用产品部公司通用产品部1984年制定的年制定的程序设计开发指南程序设计开发指南，仅供该公司内部使用。仅供该公司内部使用。(5)项目规范项目规范 由某一科研生产项目组织制定，为该由某一科研生产项目组织制定，为该项任务专用的软件工程规范。项任务专用的软件工程规范。中国的软件标准中国的软件标准 从从1983年起，中国已陆续制定和发

10、布年起，中国已陆续制定和发布了了20项国家标准。这些标准可分为项国家标准。这些标准可分为4类：类：基础标准基础标准uu GB/T 11457-89 软件工程术语软件工程术语uu GB 1526-891（ISO 5807-1985）信息信息处理处理-数据流程图、程序流程图、系数据流程图、程序流程图、系统结构图、程序网络图和系统资源图统结构图、程序网络图和系统资源图的文件编制符号及约定的文件编制符号及约定uu GB/T 15538-1995 软件工程标准分类软件工程标准分类法法uu GB 13502-92（ISO 8631）信息处理信息处理-程序构造及其表示法的约定程序构造及其表示法的约定uu G

11、B/T 15535-1995（ISO 5806）信息信息处理处理-判定表规范判定表规范uu GB/T 14085-93（ISO 8790）信息处信息处理系统理系统 计算机系统配置图符号及其约计算机系统配置图符号及其约定定 开发标准开发标准uu GB 8566-88 软件开发规范软件开发规范uu GB 计算机软件单元测试计算机软件单元测试uu GB 软件支持环境软件支持环境uu GB（ISO 6593-1985）信息处理信息处理-按按记录组处理顺序文卷的程序流程记录组处理顺序文卷的程序流程uu GB/T 14079-93 软件维护指南软件维护指南 文档标准文档标准uu GB 8567-88 计算

12、机软件产品开发文计算机软件产品开发文件编制指南件编制指南uu GB 9385-88 计算机软件需求说明编计算机软件需求说明编制指南制指南uu GB 9386-88 计算机软件测试文件编计算机软件测试文件编制规范制规范uu GB 软件文档管理指南软件文档管理指南 管理标准管理标准uu GB/T 12505-90 计算机软件配置管理计算机软件配置管理计划规范计划规范uu GB 信息技术信息技术 软件产品评价软件产品评价-质量特质量特性及其使用指南性及其使用指南 uuGB 12504-90 计算机软件质量保证计计算机软件质量保证计划规范划规范uu GB/T 14394-93 计算机软件可靠性和计算机

13、软件可靠性和可维护性管理可维护性管理uu GB/T 19000-3-94 质量管理和质量保质量管理和质量保证标准证标准 第三部分：第三部分：在软件开发、供应和维护中的使在软件开发、供应和维护中的使 用指南用指南。ISO 9000-3标准及软件质量认证标准及软件质量认证n nISO 9000国际标准发源于欧洲经济共同国际标准发源于欧洲经济共同体，但很快就波及美国、日本及世界各体，但很快就波及美国、日本及世界各国。到目前为止，已有国。到目前为止，已有70多个国家在它多个国家在它们的企业中采用和实施这一系列标准。们的企业中采用和实施这一系列标准。n n中国对此也十分重视，确定对其中国对此也十分重视，

14、确定对其等同采等同采用用，发布了与其相应的，发布了与其相应的质量管理国家标质量管理国家标准系列准系列GBT 19000；同时积极组织实同时积极组织实施和开展质量认证工作。施和开展质量认证工作。n nISO 9000系列标准如此迅速地在国际上广为流行，其原因主要在于：uu 市场经济，特别是国际贸易的驱动市场经济，特别是国际贸易的驱动。ISO 9000系列标准系列标准客观地对客观地对生产生产者者(也称供方也称供方)提出了全面的提出了全面的质量管理要质量管理要求求、质量管理办法质量管理办法，并且还规定了，并且还规定了消消费者费者(也称需方也称需方)的的管理职责管理职责，使其得，使其得到双方的普遍认同

15、，从而将符合到双方的普遍认同，从而将符合ISO 9000标准标准的要求作为的要求作为国际贸易活动中国际贸易活动中建立互相信任关系的基石建立互相信任关系的基石。在各国企业中形成了在各国企业中形成了不通过这一标不通过这一标准认证就不具备参与国际市场竞争实准认证就不具备参与国际市场竞争实力力的潮流，并且在国际贸易中，的潮流，并且在国际贸易中，把生把生产者是否达到产者是否达到ISO 9000质量标准作为质量标准作为购买产品的前提条件购买产品的前提条件，取得，取得ISO 9000质量标准认证被人们当做进入国际市质量标准认证被人们当做进入国际市场的通行证。场的通行证。uu ISO 9000系列标准适用领域

16、广阔系列标准适用领域广阔。1)硬件硬件：具有特定形状的产品，如：具有特定形状的产品，如机械、电子产品，包括计算机硬件。机械、电子产品，包括计算机硬件。2)软件软件：通过媒体表达的信息所构：通过媒体表达的信息所构成的智力产品。包括计算机软件。成的智力产品。包括计算机软件。3)流程性材料流程性材料：将原料转化为某一：将原料转化为某一特定状态的产品。如，流体、粒状、线特定状态的产品。如，流体、粒状、线状等，通过瓶装、袋装等或通过管道传状等，通过瓶装、袋装等或通过管道传输交付。输交付。4)服务服务：为满足客户需求的更为广：为满足客户需求的更为广泛的活动。泛的活动。ISO 9000系列标准的内容系列标准

17、的内容n nISO 9000 质量管理和质量保证标准质量管理和质量保证标准选择和使用的导则选择和使用的导则n nISO 9001 质量体系质量体系设计开发、生设计开发、生产、安装和服务中的质量保证模式产、安装和服务中的质量保证模式n nISO 9002 质量体系质量体系生产和安装中的生产和安装中的质量保证模式质量保证模式n nISO 9003 质量体系质量体系最终检验和测试最终检验和测试中的质量保证模式中的质量保证模式n nISO 9004 质量管理和质量体系要素质量管理和质量体系要素导则导则n nISO 9000系列标准系列标准的主体部分可以分为的主体部分可以分为两组：两组：uu 一组是用于

18、一组是用于“需方对供方要求质量需方对供方要求质量保证保证”的标准的标准 90019003；uu 一组是用于一组是用于“供方建立质量保证体供方建立质量保证体系系”的标准的标准 9004。n n9001、9002和和9003之间的区别，在于其之间的区别，在于其对象的工序范围不同对象的工序范围不同：uu 9001范围最广，包括从设计直到售范围最广，包括从设计直到售后服务；后服务；9002为为9001的子集，而的子集，而9003又是又是9002的子集。的子集。ISO 9000-3标准标准n nISO 9000系列标准系列标准原本是为制造硬件原本是为制造硬件产品而制定的标准，不能直接用于软产品而制定的标

19、准，不能直接用于软件制作。件制作。n n曾试图将曾试图将9001改写用于软件开发方面，改写用于软件开发方面，但效果不佳。但效果不佳。n n以以ISO 9000系列标准系列标准的追加形式，另的追加形式，另行制定出行制定出ISO 9000-3标准标准。n nISO 9000-3成为成为“使使9001适用于软件适用于软件开发、供应及维护开发、供应及维护”的的“指南指南”。制定与实施制定与实施ISO 9000系列标准的系列标准的主导思想主导思想(1)强调质量并非在产品检验中得到，强调质量并非在产品检验中得到，而是形成于生产的全过程。而是形成于生产的全过程。uu ISO 9000-3叙述了需方和供方叙述

20、了需方和供方应如应如何进行何进行有组织的质量保证活动，才有组织的质量保证活动，才能得到较为满意的软件；规定了能得到较为满意的软件；规定了从从双方签订开发合同到设计双方签订开发合同到设计、实现以实现以至维护整个软件生存期中至维护整个软件生存期中应当实施应当实施的质量保证活动的质量保证活动uu ISO 9000-3没有规定具体的质量管没有规定具体的质量管理和质量检验方法和步骤。理和质量检验方法和步骤。uu ISO 9000-3的核心思想是的核心思想是“将质量将质量制作入产品之中制作入产品之中”。软件产品的质。软件产品的质量量取决于软件生存期所有阶段的活取决于软件生存期所有阶段的活动动。(2)为把握

21、产品的质量，为把握产品的质量，ISO 9000-3要要求求“必须使影响产品质量的全部因素必须使影响产品质量的全部因素在生产全过程中始终处于受控状态在生产全过程中始终处于受控状态”。uu 为使软件产品达到质量要求，为使软件产品达到质量要求，ISO 9000-3要求软件开发机构建立要求软件开发机构建立质量保质量保证体系证体系。uu 首先要求首先要求明确供需双方的职责明确供需双方的职责，针，针对对所有可能影响软件质量的各个因素所有可能影响软件质量的各个因素都要采取有力措施，作出如何加强管都要采取有力措施，作出如何加强管理和控制的决定。理和控制的决定。uu 对与质量有关的人员规定其对与质量有关的人员规

22、定其职责职责和和职权职权，责任落实到人，产品质量真正，责任落实到人，产品质量真正得到控制。得到控制。(3)ISO 9000标准标准要求证实：要求证实：“企业具企业具有持续提供符合要求产品的能力有持续提供符合要求产品的能力”。uu 质量认证质量认证是取得这一证实的有效方是取得这一证实的有效方法。法。uu 产品质量若能达到标准提出的要求，产品质量若能达到标准提出的要求，由由不依赖于供方和需方的第三方权威不依赖于供方和需方的第三方权威机构机构对生产厂家审查证实后出具合格对生产厂家审查证实后出具合格证明。证明。uu 如果认证工作是公正的、可靠的，如果认证工作是公正的、可靠的，其公证的结果应当是可以信赖

23、的。其公证的结果应当是可以信赖的。uu 为了达到质量标准，取得质量认为了达到质量标准，取得质量认证，必须多方面证，必须多方面开展质量管理活动开展质量管理活动。其中，负责人的重视以及全体人员其中，负责人的重视以及全体人员的积极参与是取得成功的关键。的积极参与是取得成功的关键。(4)ISO 9000标准标准强调强调“质量管理必须质量管理必须坚持进行质量改进坚持进行质量改进”。uu 贯彻贯彻ISO 9000标准标准就是企业加强就是企业加强质量管理，提高产品质量的过程质量管理，提高产品质量的过程，这个过程包含许多工作，决非轻而这个过程包含许多工作，决非轻而易举，一蹴而就所能奏效的。易举，一蹴而就所能奏

24、效的。uu 即使已经取得了质量认证也不能认即使已经取得了质量认证也不能认为一劳永逸而放松质量管理。为一劳永逸而放松质量管理。uu 实际上认证通常以半年为有效期。实际上认证通常以半年为有效期。取得认证之后尚需接受每年取得认证之后尚需接受每年12次次的定期检查，其目的在于促使企业的定期检查，其目的在于促使企业坚持进行质量改进。坚持进行质量改进。软件文档的作用与分类软件文档的作用与分类uu 什么是文档什么是文档u 软件文档的作用软件文档的作用u 文档的分类文档的分类u 软件文档的工作软件文档的工作(1)什么是文档什么是文档uu 文档文档(document)是指某种数据媒是指某种数据媒体和其中所记录的

25、数据。体和其中所记录的数据。uu 它具有它具有永久性永久性，并可以由人或机，并可以由人或机器阅读，通常仅用于描述人工可读器阅读，通常仅用于描述人工可读的东西。的东西。uu 在软件工程中，文档常常用来表在软件工程中，文档常常用来表示对示对活动活动、需求需求、过程过程或或结果结果进行进行描述描述、定义定义、规定规定、报告报告或或认证认证的的任何书面或图示的信息。任何书面或图示的信息。(2)软件文档的作用软件文档的作用n n在软件生产过程中，总是产生和使用在软件生产过程中，总是产生和使用大量的信息。软件文档在产品的开发大量的信息。软件文档在产品的开发过程中起着重要的作用。过程中起着重要的作用。u 提

26、高提高软件开发过程的能见度软件开发过程的能见度。把。把开发过程中开发过程中发生的事件发生的事件以某种可阅以某种可阅读的形式读的形式记录在文档中记录在文档中。u 管理人员可把这些记载下来的材管理人员可把这些记载下来的材料料作为检查软件开发进度和开发质作为检查软件开发进度和开发质量的依据量的依据，实现对软件开发的工程实现对软件开发的工程管理管理。n n提高开发效率提高开发效率。软件文档的编制，使。软件文档的编制，使得开发人员得开发人员对各个阶段的工作对各个阶段的工作都进行都进行周密思考周密思考、全盘权衡全盘权衡、减少返工减少返工。并。并且可且可在开发早期发现错误和不一致性在开发早期发现错误和不一致

27、性，便于及时加以纠正。便于及时加以纠正。n n作为开发人员在一定作为开发人员在一定阶段的阶段的工作成果工作成果和和结束标志结束标志。n n记录开发过程中有关信息，便于记录开发过程中有关信息，便于协调协调以后的软件开发、使用和维护。以后的软件开发、使用和维护。n n提供对软件的提供对软件的运行运行、维护维护和和培训培训的有的有关信息，关信息，便于管理人员、开发人员、便于管理人员、开发人员、操作人员、用户之间的协作、交流和操作人员、用户之间的协作、交流和了解了解。使软件开发活动更科学、更有。使软件开发活动更科学、更有成效。成效。n n便于潜在用户了解软件的功能、性能便于潜在用户了解软件的功能、性能

28、等各项指标等各项指标，为他们选购符合自己需，为他们选购符合自己需要的软件提供依据。要的软件提供依据。文档的桥梁作用文档的桥梁作用n n从某种意义上来说，从某种意义上来说，文档是软件开发文档是软件开发规范的体现和指南规范的体现和指南。n n按规范要求生成一整套文档的过程，按规范要求生成一整套文档的过程，就是按照软件开发规范完成一个软件就是按照软件开发规范完成一个软件开发的过程。开发的过程。n n所以，在使用工程化的原理和方法来所以，在使用工程化的原理和方法来指导软件的开发和维护时，应当充分指导软件的开发和维护时，应当充分注意软件文档的编制和管理。注意软件文档的编制和管理。(3)文档的分类文档的分

29、类n n软件文档从形式上来看，大致可分为软件文档从形式上来看，大致可分为两类：两类：u 一类是开发过程中填写的各种图一类是开发过程中填写的各种图表，称之为表，称之为工作表格工作表格；u 一类是应编制的技术资料或技术一类是应编制的技术资料或技术管理资料，称之为管理资料，称之为文档文档或或文件文件。n n软件文档的编制，可以用软件文档的编制，可以用自然语言自然语言，特别设计的特别设计的形式语言形式语言，介于两者之间，介于两者之间的的半形式语言半形式语言(结构化语言结构化语言)，各类，各类图图形表示形表示、表格表格来编制文档。来编制文档。n n文档可以书写，也可以在计算机支持文档可以书写，也可以在计

30、算机支持系统中产生，但必须系统中产生，但必须可阅读可阅读。n n按照文档产生和使用的范围，软件文按照文档产生和使用的范围，软件文档大致可分为三类：档大致可分为三类：uu 开发文档开发文档 软件需求说明书软件需求说明书 数据要求说明书数据要求说明书 概要设计说明书概要设计说明书 详细设计说明书详细设计说明书 可行性研究报告可行性研究报告 项目开发计划项目开发计划uu 管理文档管理文档 项目开发计划项目开发计划 测试计划测试计划 测试报告测试报告 开发进度月报开发进度月报 项目开发总结项目开发总结u 用户文档用户文档 用户手册用户手册 操作手册操作手册 维护修改建议维护修改建议 软件需求说明书软件

31、需求说明书(4)软件文档的工作软件文档的工作n n国家标准局在国家标准局在1988年年1月发布了月发布了uu计算机软件开发规范计算机软件开发规范uu软件产品开发文件编制指南软件产品开发文件编制指南n n作为软件开发人员工作的准则和规程。作为软件开发人员工作的准则和规程。它们它们基于软件生存期方法基于软件生存期方法，把软件产，把软件产品品从形成概念开始从形成概念开始，经过开发经过开发、使用使用和不断增补修订和不断增补修订，直到最后被淘汰直到最后被淘汰的的整个过程整个过程应提交的文档归于以下十三应提交的文档归于以下十三种。种。n n可行性研究报告可行性研究报告uu 说明该软件项目的实现在说明该软件

32、项目的实现在技术上技术上、经济上经济上和和社会因素上社会因素上的的可行性可行性;uu 评述为合理地达到开发目标评述为合理地达到开发目标可供选可供选择的择的各种可能的实现方案各种可能的实现方案;uu 说明并论证所选定实施方案的理由。说明并论证所选定实施方案的理由。n n项目开发计划项目开发计划为软件项目实施方案制定出的具体计为软件项目实施方案制定出的具体计划。它包括划。它包括uu 各部分工作的负责人员各部分工作的负责人员uu 开发的进度开发的进度uu 开发经费的概算开发经费的概算uu 所需的硬件和软件资源等所需的硬件和软件资源等项目开发计划应提供给管理部门，并项目开发计划应提供给管理部门，并作为

33、开发阶段评审的基础作为开发阶段评审的基础。n n软件需求说明书软件需求说明书对目标软件的对目标软件的功能功能、性能性能、用户界面用户界面及及运行环境运行环境等等作出详细的说明作出详细的说明。它是用户与开发人员它是用户与开发人员双方对软件需求双方对软件需求取得共同理解基础上达成的协议取得共同理解基础上达成的协议，也，也是是实施开发工作的基础实施开发工作的基础。n n数据要求说明书数据要求说明书给出给出数据逻辑描述数据逻辑描述和和数据采集数据采集的各项的各项要求要求,为生成和维护系统的数据文件为生成和维护系统的数据文件做好准备。做好准备。n n概要设计说明书概要设计说明书该说明书是概要设计工作阶段

34、的成果。该说明书是概要设计工作阶段的成果。它应当说明它应当说明uu 系统的功能分配系统的功能分配uu 模块划分模块划分uu 程序的总体结构程序的总体结构uu 输入输出及接口设计输入输出及接口设计uu 运行设计运行设计uu 数据结构设计数据结构设计uu 出错处理设计等出错处理设计等为详细设计奠定基础。为详细设计奠定基础。n n详细设计说明书详细设计说明书着重描述着重描述每一个模块是如何实现的每一个模块是如何实现的，包括包括实现算法实现算法、逻辑流程逻辑流程等。等。n n用户手册用户手册n n详细描述软件的详细描述软件的功能功能、性能性能和和用户界用户界面面，使用户了解，使用户了解如何使用该软件如

35、何使用该软件。n n操作手册操作手册n n为操作人员提供为操作人员提供软件各种运行情况的软件各种运行情况的有关知识有关知识，特别是操作方法细节。，特别是操作方法细节。n n测试计划测试计划针对针对组装测试组装测试和和确认测试确认测试，需要，需要为组为组织测试制定计划织测试制定计划。计划应包括。计划应包括uu 测试的内容测试的内容uu 进度安排进度安排uu 条件条件uu 人员人员uu 测试用例的选取原则测试用例的选取原则uu 测试结果允许的偏差范围等测试结果允许的偏差范围等n n测试分析报告测试分析报告测试工作完成后，应测试工作完成后，应提交测试计划执提交测试计划执行情况的说明行情况的说明。对测

36、试结果加以分析对测试结果加以分析，并并提出测试的结论性意见提出测试的结论性意见。n n开发进度月报开发进度月报该月报是软件人员该月报是软件人员按月向管理部门提按月向管理部门提交的项目进展情况的报告交的项目进展情况的报告。报告应包。报告应包括括进度计划与实际执行情况的比较进度计划与实际执行情况的比较、阶段成果阶段成果、遇到的问题和解决的办法遇到的问题和解决的办法以及以及下个月的打算下个月的打算等。等。n n项目开发总结报告项目开发总结报告uu 软件项目开发完成之后，应当软件项目开发完成之后，应当与项与项目实施计划对照目实施计划对照，总结实际执行的情总结实际执行的情况况，如，如进度进度、成果成果、

37、资源利用资源利用、成本成本和和投入的人力投入的人力。uu 还需还需对开发工作作出评价对开发工作作出评价，总结经总结经验和教训验和教训。n n维护修改建议维护修改建议软件产品投入运行之后软件产品投入运行之后，可能有修正可能有修正、更改等问题更改等问题，应当，应当对存在的问题对存在的问题、修修改的考虑改的考虑以及以及修改的影响估计修改的影响估计等等做详做详细的描述细的描述，写成维护修改建议，提交，写成维护修改建议，提交审批。审批。n n以上软件文档是在软件生存期中，随以上软件文档是在软件生存期中，随着各个阶段工作的开展适时编制的。着各个阶段工作的开展适时编制的。其中，有的仅反映某一个阶段的工作，其

38、中，有的仅反映某一个阶段的工作，有的则需跨越多个阶段。有的则需跨越多个阶段。软件生存期各阶段与各种文档编制的关系软件生存期各阶段与各种文档编制的关系n n文档最终要向文档最终要向软件管理部门软件管理部门，或向，或向用用户户回答下列问题回答下列问题uu 哪些需求要被满足哪些需求要被满足（What）；）；uu 软件在什么环境中实现，所需信息软件在什么环境中实现，所需信息从哪里来从哪里来（Where）；）；uu 开发时间如何安排开发时间如何安排（When）；）；uu 开发开发(或维护或维护)工作打算由谁来做工作打算由谁来做（Who）；）；uu 需求应如何实现需求应如何实现（How）；）；uu 为什么

39、要进行这些软件开发或维护为什么要进行这些软件开发或维护修改工作修改工作（Why）。）。文档要回答的问题文档要回答的问题对文档编制的质量要求对文档编制的质量要求n n如果不重视文档编写工作，或是对文档如果不重视文档编写工作，或是对文档编写工作的安排不当，就不可能得到高编写工作的安排不当，就不可能得到高质量的文档。质量的文档。n n质量差的文档质量差的文档uu 使读者难于理解使读者难于理解，给使用者造成许给使用者造成许多不便多不便uu 会削弱对软件的管理会削弱对软件的管理（难以确认和（难以确认和评价开发工作的进展情况评价开发工作的进展情况)，提高软提高软件成本件成本(一些工作可能被迫返工一些工作可

40、能被迫返工)uu 造成造成误操作误操作对编制高质量文档的要求对编制高质量文档的要求(1 1)针对性针对性uu 文档编制以前文档编制以前应分清读者对象应分清读者对象。按。按不同的类型、不同层次的读者，决定不同的类型、不同层次的读者，决定怎样适应他们的需要。怎样适应他们的需要。uu 管理文档主要面向管理人员管理文档主要面向管理人员uu 用户文档主要面向用户用户文档主要面向用户uu 这两类文档不应像开发文档这两类文档不应像开发文档(面向面向开发人员开发人员)那样过多使用软件的专用那样过多使用软件的专用术语。术语。(2)精确性精确性 uu 文档的行文应当文档的行文应当十分确切十分确切，不能出不能出现多

41、义性的描述现多义性的描述。同一课题几个文档。同一课题几个文档的内容应当是协调一致，没有矛盾的。的内容应当是协调一致，没有矛盾的。(3)清晰性清晰性uu 文档编写应文档编写应力求简明力求简明，如有可能，如有可能，配以适当的图表，以增强其清晰性。配以适当的图表，以增强其清晰性。(4)完整性完整性uu 任何一个文档都应当是任何一个文档都应当是完整的完整的、独独立的立的，它应，它应自成体系自成体系。uu 例如，例如，前言部分应做一般性介绍，前言部分应做一般性介绍，正文给出中心内容，必要时还有附录，正文给出中心内容，必要时还有附录，列出参考资料等。列出参考资料等。uu 同一课题的几个文档之间可能有些同一

42、课题的几个文档之间可能有些部分内容相同，这种重复是必要的。部分内容相同，这种重复是必要的。uu 不要在文档中出现转引其它文档内不要在文档中出现转引其它文档内容的情况容的情况。如，一些段落没有具体描如，一些段落没有具体描述，用述，用“见见文档文档节节”的方式的方式.(5)灵活性灵活性各个不同软件项目，其规模和复杂程度各个不同软件项目，其规模和复杂程度有着许多实际差别，不能一律看待。有着许多实际差别，不能一律看待。n n应根据具体的软件开发项目，决定编制应根据具体的软件开发项目，决定编制的文档种类。的文档种类。uu 软件开发的管理部门应该软件开发的管理部门应该根据本单根据本单位承担的应用软件的专业

43、领域和本单位承担的应用软件的专业领域和本单位的管理能力位的管理能力，制定一个对文档编制制定一个对文档编制要求的实施规定要求的实施规定。uu 对于一个具体的应用软件项目，项对于一个具体的应用软件项目，项目负责人应根据上述实施规定，确定目负责人应根据上述实施规定，确定一个文档编制计划。其中包括：一个文档编制计划。其中包括：FF 编制哪几种文档，详细程度如何编制哪几种文档，详细程度如何FF 各文档的编制负责人和进度要求各文档的编制负责人和进度要求FF 审查审查/批准负责人和时间进度安排批准负责人和时间进度安排FF 在开发时期内各文档的维护、修在开发时期内各文档的维护、修改和管理的负责人，以及批准手续

44、改和管理的负责人，以及批准手续uu 有关的开发人员必须严格执行这个有关的开发人员必须严格执行这个文档编制计划。文档编制计划。n n当所开发的软件系统非常大时，一种文当所开发的软件系统非常大时，一种文档可以分成几卷编写。档可以分成几卷编写。例如，例如，u 项目开发计划项目开发计划可分写为：可分写为：FF 质量保证计划质量保证计划FF 配置管理计划配置管理计划FF 用户培训计划用户培训计划FF 安装实施计划等安装实施计划等。u 系统设计说明书系统设计说明书可分写为：可分写为：FF 系统设计说明书系统设计说明书FF 子系统设计说明书。子系统设计说明书。u 程序设计说明书程序设计说明书可分写为：可分写

45、为：FF 程序设计说明书程序设计说明书FF 接口设计说明书接口设计说明书FF 版本说明。版本说明。u 操作手册操作手册可分写为：可分写为：FF 操作手册操作手册FF 安装实施过程。安装实施过程。u 测试计划测试计划可分写为：可分写为：FF 测试计划测试计划FF 测试设计说明测试设计说明FF 测试规程测试规程FF 测试用例。测试用例。u 测试分析报告测试分析报告可分写为：可分写为：FF 综合测试报告综合测试报告FF 验收测试报告。验收测试报告。uu 项目开发总结报告项目开发总结报告也可分写成：也可分写成：FF 项目开发总结报告项目开发总结报告FF 资源环境统计。资源环境统计。n n应根据应根据任

46、务的规模任务的规模、复杂性复杂性、项目负责项目负责人对该软件的开发过程及运行环境所需人对该软件的开发过程及运行环境所需详细程度的判断详细程度的判断，确定文档的详细程度确定文档的详细程度。n n对国标对国标GB8567-88计算机软件产品开计算机软件产品开发文件编制指南发文件编制指南所建议的所有条款都所建议的所有条款都uu 可以扩展可以扩展，进一步细分，以适应需，进一步细分，以适应需要；要；uu 如果条款中有些细节并非必需，如果条款中有些细节并非必需，也也可以根据实际情况压缩合并可以根据实际情况压缩合并。n n程序的设计表现形式程序的设计表现形式，可以使用，可以使用程序流程序流程图程图、判定表判

47、定表、程序描述语言程序描述语言(PDL)、或或问题分析图问题分析图(PAD)等。等。n n对于对于文档的表现形式文档的表现形式，没有规定或限制。，没有规定或限制。可以使用可以使用自然语言自然语言、也可以使用、也可以使用形式化形式化的语言的语言或或半形式化的语言半形式化的语言。n n当国标当国标计算机软件产品开发文件编制计算机软件产品开发文件编制指南指南中规定的文档种类不能满足某些中规定的文档种类不能满足某些应用部门的特殊需要时，应用部门的特殊需要时，可以建立一些可以建立一些特殊的文档种类要求特殊的文档种类要求，这些要求可以包，这些要求可以包含含在本单位的文档编制实施规定在本单位的文档编制实施规定中。中。n n为使软件文档能为使软件文档能uu 起到多种桥梁的作用起到多种桥梁的作用uu 有助于程序员编制程序有助于程序员编制程序uu 有助于管理人员监督和管理软件有助于管理人员监督和管理软件的开发的开发uu 有助于用户了解软件的工作和应有助于用户了解软件的工作和应做的操作，做的操作，uu 有助于维护人员进行有效的修改有助于维护人员进行有效的修改和扩充和扩充n n文档的编制必须保证一定的质量。文档的编制必须保证一定的质量。