《00计算机软件产品开发文件编制指南11.docx》由会员分享，可在线阅读，更多相关《00计算机软件产品开发文件编制指南11.docx（29页珍藏版）》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
1、软件产品开发文件编制指南河南雪城软件有限公司2008年2月目录1.引言31.1目的31.2范围31.3文件的使用者42.文件的编制指导52.1软件生存周期与各种文件的编制52.2文件编制中的考虑因素72.2.1文件的读者72.2.2重复性82.2.3灵活性82.2.3.1应编制的文件种类82.2.3.2文件的详细程度92.2.3.3文件的扩展92.2.3.4节的扩张与缩并102.2.3.5程序设计的表现形式102.2.3.6文件的表现形式102.2.3.7文件的其他种类113.文件编制的管理工作113.1文件的形成113.2文件的分类与标识113.3文件的控制123.4文件的修改管理134.各
2、种文件的内容要求134.1可行性研究报告134.2项目开发计划154.3软件需求说明书164.4数据要求说明书184.5概要设计说明书184.6详细设计说明书204.7数据库设计说明书214.8用户手册214.9操作手册234.10模块开发卷宗244.11测试计划及设计254.12测试分析报告264.13开发进度月报274.14开发总结报告27附录:产品文件体系281.引言1.1目的一项计算机软件的筹划、研制及实现，构成一个软件开发项目。一个软件开发项目的进行，一般需要在人力和自动化资源等方面作重大的投资。为了保证项目开发的成功，最经济地花费这些投资，并且便于运行和维护，在开发工作的每一阶段，
3、都需要编制一定的文件。这些文件连同计算机程序及数据一起，构成为计算机软件。文件是计算机软件中不可缺少的组成部分，它的作用是：a作为开发人员在一定阶段内的工作成果和结束标志；b向管理人员提供软件开发过程中的进展和情况，把软件开发过程中的一些“不可见的事物转”换成“可见的”文字资料，以便管理人员在各个阶段检查开发计划的实施进展，使之能够判断原定目标是否已达到，还将继续耗用资源的种类和数量；c记录开发过程中的技术信息，便于协调以后的软件开发、使用和修改；d提供对软件的有关运行、维护和培训的信息，便于管理人员、开发人员、操作人员和用户之间相互了解彼此的工作；e向潜在用户报导软件的功能和性能，使他们能判
4、定该软件能否服务于自己的需要。换言之，本指南认为：文件的编制必须适应计算机软件整个生存周期的需要。计算机软件所包含的文件有两类：一类是开发过程中填写的各种图表，可称之为工作表格；另一类则是应编制的技术资料或技术管理资料，可称之为文件。本指南规定软件文件的编制形式，并提供对这些规定的解释。本指南的目的是使得所编制的软件文件确实能够起到软件文件应该发挥的作用。1.2范围本指南建议，在一项计算机软件的开发过程中，一般地说，应该产生十四种文件。这十四种文件是：可行性研究报告；项目开发计划；软件需求说明书；数据要求说明书；概要设计说明书；详细设计说明书；数据库设计说明书；用户手册；操作手册；模块开发卷宗
5、；测试计划；测试分析报告；开发进度月报；项目开发总结报告。本指南将给出开发过程中建议产生的这十四种文件的编制指导，同时，本指南也是这十四种文件的编写质量的检验准则。1.3文件的使用者对于使用文件的人员而言，他们所关心的文件的种类，随他们所承担的工作而异。管理人员：可行性研究报告，项目开发计划，模块开发卷宗，开发进度月报，项目开发总结报告；开发和测试人员：可行性研究报告，项目开发计划，软件需求说明书，数据要求说明书，概要设计说明书，详细设计说明书，数据库设计说明书，测试计划，测试分析报告；维护人员：设计说明书，测试分析报告，模块开发卷宗；用户：用户手册，操作手册。尽管本指南提出了在软件开发中文件
6、编制的要求，但并不意味着这些文件都必须交给用户。一项软件的用户应该得到的文件的种类由供应者与用户之间签订的合同规定。2.文件的编制指导2.1软件生存周期与各种文件的编制一项计算机软件，从出现一个构思之日起，经过这项软件开发成功投入使用，直到最后决定停止使用，并被另一项软件代替之时止，被认为是该软件的一个生存周期。一般地说这个软件生存周期可以分成以下六个阶段：1、可行性与计划研究阶段2、需求分析阶段3、设计阶段4、实现阶段5、测试阶段6、运行与维护阶段在可行性研究与计划阶段内，要确定该软件的开发目标和总的要求，要进行可行性分析、投资一收益分析、制订开发计划，并完成应编制的文件。在需求分析阶段内，
7、由系统分析人员对被设计的系统进行系统分析，确定对该软件的各项功能、性能需求和设计约束，确定对文件编制的要求，作为本阶段工作的结果，一般地说，软件需求说明书、数据要求说明书应该编写出来。在设计阶段内，系统设计人员和程序设计人员应该在反复理解软件需求的基础上，提出多个设计，分析每个设计能履行的功能并进行相互比较，最后确定一个设计，包括该软件的结构、模块的划分、功能的分配以及处理流程。在被设计系统比较复杂的情况下，设计阶段应分解成概要设计阶段和详细设计阶段两个步骤。在一般情况下，应完成的文件包括：概要设计说明书、详细设计说明书。在实现阶段内，要完成源程序的编码、编译（或汇编）和排错调试，得到无语法错
8、的程序清单，要开始编写模块开发卷宗，并且要完成用户手册、操作手册等面向用户的文件的编写工作，还要完成测试计划的编制。在测试阶段，该程序将被全面地测试，已编制的文件将被检查审阅。一般要完成模块开发卷宗和测试分析报告，作为开发工作的结束，所生产的程序、文件以及开发工作本身将逐项被评价，最后写出项目开发总结报告。在整个开发过程中（即前五个阶段中），开发集体要按月编写开发进度月报。在运行和维护阶段，软件将在运行使用中不断地被维护，根据新提出的需求进行必要而且可能的扩充和删改。对于一项软件而言，其生存周期各阶段与各种文件编写工作的关系可见表互，其中有些文件的编写工作可能要在若干个阶段中延续进行。表1软件
9、生存周期各阶段中的文件编制2.2文件编制中的考虑因素文件编制是一个不断努力的工作过程。是一个从形成最初轮廓，经反复检查和修改，直到程序和文件正式交付使用的完整过程。其中每一步都要求工作人员做出很大努力。要保证文件编制的质量，要体现每个开发项目的特点，也要注意不要花太多的人力。为此，编制中要考虑如下各项因素。2.2.1文件的读者每一种文件都具有特定的读者。这些读者包括个人或小组、软件开发单位的成员或社会上的公众、从事软件工作的技术人员、管理人员或领导干部。他们期待着使用这些文件的内容来进行工作，例如设计、编写程序、测试、使用、维护或进行计划管理。因此，这些文件的作者必须了解自己的读者，这些文件的
10、编写必须注意适应自己的特定读者的水平、特点和要求。2.2.2重复性本指南第二篇中将列出的这十四种文件的内容要求中，显然存在某些重复。较明显的重复有两类。引言是每一种文件都要包含的内容，以向读者提供总的梗概。第二类明显的重复是各种文件中的说明部分，如对功能性能的说明、对输入和输出的描述、系统中包含的设备等。这是为了方便每种文件各自的读者，每种产品文件应该自成体系，尽量避免读一种文件时又不得不去参考另一种文件。当然，在每一种文件里，有关引言、说明等同其他文件相重复的部分，在行文上、在所用的术语上、在详细的程度上，还是应该有一些差别，以适应各种文件的不同读者的需要。2.2.3灵活性鉴于软件开发是具有
11、创造性的脑力劳动，也鉴于不同软件在规模上和复杂程度上差别极大，本指南认为在文件编制工作中应允许一定的灵活性。这种灵活性表现在如下各款。2.2.3.1应编制的文件种类尽管本指南认为在一般情况下，一项软件的开发过程中，应产生的文件有十四种，然而针对一项具体的软件开发项目，有时不必编制这么多的文件，可以把几种文件合并成一种。一般地说，当项目的规模、复杂性和成败风险增大时，文件编制的范围、管理手续和详细程度将随之增加。反之，则可适当减少。为了恰当地掌握这种灵活性，本指南要求贯彻分工负责的原则，这意味着：a一个软件开发单位的领导机构应该根据本单位经营承包的应用软件的专业领域和本单位的管理能力，制定一个对
12、文件编制要求的实施规定，主要是：在不同的条件下，应该形成哪些文件？这些文件的详细程度？该开发单位的每一个项目负责人，必须认真执行这个实施规定。这种规定的两个例子可参考本指南的附录o（参考件）；b对于一个具体的应用软件项目，项目负责人应根据上述实施规定，确定一个文件编制计划，主要包括：1、应该编制哪几种文件，详细程度如何？2、各个文件的编制负责人和进度要求；3、审查、批准的负责人和时间进度安排；4、在开发时期内，各文件的维护、修改和管理的负责人，以及批准手续。5、每项工作必须落实到人。6、这个文件编制计划是整个开发计划的重要组成部分；c有关的设计人员则必须严格执行这个文件编制计划。2.2.3.2
13、文件的详细程度从同一份提纲起草的文件的篇幅大小往往不同，可以少到几页，也可以长达几百页。对于这种差别本指南是允许的。其详细程度取决于任务的规模、复杂性和项目负责人对该软件的开发过程及运行环与所需要的详细程度的判断。2.2.3.3文件的扩展当被开发系统的规模非常大（例如源码超过一百万行）时，一种文件可以分成几卷编写，可以按其每一个系统分别编制，也可以按内容划分成多卷，例如：项目开发计划可能包括：质量保证计划，配置管理计划，用户培训计划，安装实施计划；系统设计说明书可分写成：系统设计说明书，子系统设计说明书；程序设计说明书可分写成：程序设计说明书，接口设计说明书，版本说明；操作手册可分写成：操作手
14、册，安装实施过程；测试计划可分写成：测试计划，测试设计说明，测试规程，测试用例；测试分析报告可分写成：综合测试报告，验收测试报告；项目开发总结报告亦可分写成项目开发总结报告和资源环境统计。2.2.3.4节的扩张与缩并在有些文件中，可以使用本指南所提供的章、条标题，但在条内又存在一系列需要分别讨论的因素本指南认为，所有的条都可以扩展，可以进一步细分，以适应实际需要。反之，如果章条中的有些细节；非必需，也可以根据实际情况缩并。此时章条的编号应相应地改变。2.2.3.5程序设计的表现形式本指南对于程序的设计表现形式并未作出规定或限制，可以使用流程图的形式、判定表的形式，可以使用其他表现形式。2.2.
15、3.6文件的表现形式本指南对于文件的表现形式亦未作出规定或限制，可以使用自然语言，也可以使用形式化语言。2.2.3.7文件的其他种类当本指南中规定的文件种类尚不能满足某些应用部门的特殊需要时，他们可以建立一些特殊的文件种类要求，例如软件质量保证计划、软件配置管理计划等，这些要求可以包含在本单位的文件编制实施规定中。3.文件编制的管理工作文件编制工作必须有管理工作的配合，才能使所编制的文件真正发挥它的作用。文件的编制工作实际上贯穿于一项软件的整个开发过程，因此，对文件的管理必须贯穿于整个开发过程。在开发过程中必须进行的管理工作是以下四条。3.1文件的形成开发集体中的每个成员，尤其是项目负责人，应
16、该认识到：文件是软件产品的必不可少的组成部分；在软件开发过程的各个阶段中，必须按照规定及时地完成各种产品文件的编写工作；必须把在一个开发步骤中作出的决定和取得的结果及时地写入文件；开发集体必须及时地对这些文件进行严格的评审；这些文件的形成是各个阶段开发工作正式完成的标志。这些文件上必须有编写者、评审者和批准者的签字，必须有编写、评审完成的日期和批准的日期。3.2文件的分类与标识在软件开发的过程中，产生的文件是很多的，为了便于保存、查找、使用和修改，应该对文件按层次地加以分类组织。一个软件开发单位应该建立一个对本单位文件的标识方法，使文件的每一页都具有明确的标识。例如可以按如下四个层次对文件加以
17、分类和标识。a文件所属的项目的标识；b文件种类的标识；c同一种文件的不同版本号；d页号。此外，对每种文件还应根据项目的性质，划定它们各自的保密级别，确定他们各自的发行范围。3.3文件的控制在一项软件的开发过程中，随着程序的逐步形成和逐步修改，各种文件亦在不断地产生、不断地修改或补充。因此，必须加以周密的控制，以保持文件与程序产品的一致性，保持各种文件之间的一致性和文件的安全性。这种控制表现为：a就从事一项软件开发工作的开发集体而言，应设置一位专职的文件管理人员（接口管理工程师或文件管理员）；在开发集体中，应该集中保管本项目现有全部文件的主文本两套，由该文件管理人员负责保管；b每一份提交给文件管
18、理人员的文件都必须具有编写人、审核人和批准人的签字；c这两套主文本的内容必须完全一致；其中有一套是可供出借的，另一套是绝对不能出借的，以免发生万一；可出借的主文本在出借时必须办理出借手续，归还时办理注销出借手续；d开发集体中的工作人员可以根据工作的需要，在本项目的开发过程中持有一些文件，即所谓个人文件，包括为使他完成他承担的任务所需要的文件，以及他在完成任务过程中所编制的文件；但这种个人文件必须是主文本的复制品，必须同主文本完全一致，若要修改，必须首先修改主文本；e不同开发人员所拥有的个人文件通常是主文本的各种子集；所谓子集是指把主文本的各个部分根据承担不同任务的人员或部门的工作需要加以复制、
19、组装而成的若干个文件的集合；文件管理人员。应该列出一份不同子集的分发对象的清单，按照清单及时把文件分发给有关人员或部门；f一份文件如果已经被另一份新的文件所代替，则原文件应该被注销；文件管理人中要随时整理主文本，及时反映出文件的变化和增加情况，及时分发文件；g当一个项目的开发工作临近结束时，文件管理人员应逐个收回开发集体内每个成员的个人文件，并检查这些个人文件的内容；经验表明，这些个人文件往往可能比主文本更详细，或同主文本的内容有所不同，必须认真监督有关人员进行修改，使主文本能真正反映实际的开发结果。3.4文件的修改管理在一个项目的开发过程中的任何时刻，开发集体内的所有成员都可能对开发工作的已
20、有成果文件，提出进行修改的要求。提出修改要求的理由可能是各种各样的，进行修改而引起的影响可能很小，也可能会牵涉到本项目的很多方面。因此，修改活动的进行必须谨慎，必须对修改活动的进行加以管理，必须执行修改活动的规程，使整个修改活动有控制地进行。修改活动可分如下五个步骤进行：a提议开发集体中的任何一个成员都可以向项目负责人提出修改建议，为此应该填写一份修改建议表，说明修改的内容、所修改的文件和部位、以及修改理由；b评议由项目负责人或项目负责人指定的人员对该修改建议进行评议，包括审查该项修改的必要性、确定这一修改的影响范围、研究进行修改的方法、步骤和实施计划；c审核一般由项目负责人进行审核，包括核实
21、修改的自的和要求、核实修改活动将带来的影响、审核修改活动计划是否可行；d批准在一般情况下，批准权属于该开发单位的部门负责人；在批准时，主要是决断修改工作中各项活动的先后顺序及各自的完成日期，以保证整个开发工作按原定计划日期完成；e实施由项目负责人按照已批准的修改活动计划，安排各项修改活动的负责人员进行修改，建立修改记录、产生新的文件以取代原有文件、最后把文件交文件管理人员归档，并分发给有关的持有者。4.各种文件的内容要求本篇将对引言中提到的十四种文件提供内容要求，作为文件编制的技术标准。4.1可行性研究报告可行性研究报告的编写目的是：说明该软件开发项目的实现在技术、经济和社会条件方面的可行性；
22、评述为了合理地达到开发目标而可能选择的各种方案；说明并论证所选定的方案。可行性研究报告的编写内容要求如下：1引言1.1编写目的1.2背景1.3定义1.4参考资料2可行性研究的前提2.1要求2.2目标2.3条件、假定和限制2.4进行可行性研究的方法2.5评价尺度3对现有系统的分析3.1数据流程和处理流程3.2工作负荷3.3费用开支3.4人员3.5设备3.6局限性4所建议的系统4.1对所建议系统的说明4.2数据流程和处理流程4.3改进之处4.4影响4.4.1对设备的影响4.4.2对软件的影响4.4.3对用户单位机构的影响4.4.4对系统运行的影响4.4.5对开发的影响4.4.6对地点和设施的影响4
23、.4.7对经费开支的影响4.5局限性4.6技术条件方面的可行性5可选择的其他系统方案5.1可选择的系统方案15.2可选择的系统方案2.6投资及收益分析6.1支出6.1.1基本建设投资6.1.2其他一次性支出6.1.3非一次性支出6.2收益6.2.1一次性收益6.2.2非一次性收益6.2.3不可定量的收益6.3收益投资比6.4投资回收周期6.5敏感性分析7社会条件方面的可行性7.1法律方面的可行性7.2使用方面的可行性8结论4.2项目开发计划编制项目开发计划的目的是用文件的形式，把对于在开发过程中各项工作的负责人员、开发进度、所需经费预算、所需软、硬件条件等问题作出的安排记载下来，以便根据本计划
24、开展和检查本项目的开发工作。编制内容要求如下：1.概述1.1编写目的1.2项目背景1.3定义1.4参考资料2.项目过程定义2.1软件开发生命周期模型2.2开发工具与平台3.计划3.1资源计划3.2关键计算机资源估计4.项目管理4.1人员与角色4.2人员计划4.3风险管理计划4.4培训计划4.5成本估计5.进度跟踪5.1项目会议5.2项目里程碑5.3进度表5.4人员任务分配4.3软件需求说明书软件需求说明书的编制是为了使用户和软件开发者双方对该软件的初始规定有一个共同的理解，使之成为整个开发工作的基础。编制软件需求说明书的内容要求如下：1.引言1.1编写目的1.2项目背景1.3定义1.4参考资料
25、2.任务概述2.1目标2.2运行环境2.3条件与限制3.数据描述3.1静态数据3.2动态数据3.3数据库介绍3.4数据词典3.5数据采集4.功能需求4.1功能划分4.2功能描述5.性能需求5.1数据精确度5.2时间特性5.3适应性6.运行需求6.1用户界面6.2硬件接口6.3软件接口6.4故障处理7.其它需求4.4数据要求说明书数据要求说明书的编制目的是为了向整个开发时期提供关于被处理数据的描述和数据采集要求的技术信息。编制数据要求说明书的内容要求如下：1引言1.1编写目的1.2背景1.3定义1.4参考资料2数据的逻辑描述2.1静态数据2.2动态输入数据2.3动态输出数据2.4内部生成数据2.
26、5数据约定3数据的采集3.1要求和范围3.2输入的承担者3.3处理3.4影响4.5概要设计说明书概要设计说明书又可称系统设计说明书，这里所说的系统是指程序系统。编制的目的是说明对程序系统的设计考虑，包括程序系统的基本处。流程、程序系统的组织结构、模块划分、功能分配、接口设计。运行设计、数据结构设计和出错处理设计等，为程序的详细设计提供基础。编制概要设计说明书的内容要求如下：1引言1.1编写目的1.2背景1.3定义1.4参考资料2总体设计2.1需求规定2.2运行环境2.3基本设计概念和处理流程2.4结构2.5功能需求与程序的关系2.6人工处理过程2.7尚未解决的问题3接口设计3.1用户接口3.2
27、外部接口3.3内部接口4运行设计4.1运行模块组合4.2运行控制4.3运行时间5系统论据结构设计5.1逻辑结构设计要点5.2物理结构设计要点5.3数据结构与程序的关系6系统出错处理设计6.1出错信息6.2补救措施7安全保密设计8系统维护设计4.6详细设计说明书详细设计说明书又可称程序设计说明书。编制目的是说明一个软件系统各个层次中的每一个程序（每个模块或子程序）的设计考虑，如果一个软件系统比较简单，层次很少，本文件可以不单独编写，有关内容合并入概要设计说明书。对详细设计说明书的内容要求如下：1引言1.1编写目的1.2背景1.3定义1.4参考资料2程序系统的组织结构3程序1（标识符）设计说明3.
28、1程序描述3.2功能3.3性能3.4输入项3.5输出项3.6算法3.7流程逻辑3.8接口3.9存储分配3.10注释设计3.11限制条件3.12测试计划.3.13尚未解决的问题4程序2（标识符）设计说明.4.7数据库设计说明书数据库设计说明书的编制目的是对于设计中的数据库的所有标识、逻辑结构和物理结构作出具体的设计规定。其内容要求如下：1引言1.1编写目的1.2背景1.3定义1.4参考资料2外部设计2.1标识符和状态2.2使用它的程序2.3约定2.4专门指导2.5支持软件3结构设计3.1概念结构设计3.2逻辑结构设计3.3物理结构设计4运用设计4.1数据字典设计4.2安全保密设计4.8用户手册用
29、户手册的编制是要使用非专门术语的语言，充分地描述该软件系统所具有的功能及基本的使用方法。使用户（或潜在用户）通过本手册能够了解该软件的用途，并且能够确定在什么情况下，如何使用它。具体的内容要求如下：1引言1.1编写目的1.2背景1.3定义1.4参考资料2用途2.1功能2.2性能2.2.1精度2.2.2时间特性2.2.3灵活性2.3安全保密3运行环境3.1硬设备3.2支持软件3.3数据结构4使用过程4.1安装与初始化4.2输入4.2.1输入数据的现实背景4.2.2输入格式4.2.3输入举例4.3输出4.3.1输出数据的现实背景4.3.2输出格式4.3.3输出举例4.4文卷查询4.5出错处理与恢复
30、4.6终端操作4.9操作手册操作手册的编制是为了向操作人员提供该软件每一个运行的具体过程和有关知识，包括操作方法的细节。具体的内容要求如下：1引言1.1编写目的1.2背景1.3定义1.4参考资料2软件概述2.1软件的结构2.2程序表2.3文卷表3安装与初始化4运行说明4.1运行表4.2运行步骤4.3运行1（标识符）说明4.3.1运行控制4.3.2操作信息4.3.3输入一输出文卷4.3.4输出文段4.3.5输出文段的复制4.3.6启动恢复过程4.4运行2（标识符）说明.5非常现过程6远程操作4.10模块开发卷宗模块开发卷宗是在模块开发过程中逐步编写出来的，每完成一个模块或一组密切相关的模块的复审
31、时编写一份，应该把所有的模块开发卷宗汇集在一起。编写的目的是记录和汇总低层次开发的进度和结果，以便于对整个模块开发工作的管理和复审，并为将来的维护提供非常有用的技术信息。具体的内容要求如下：1标题2模块开发情况表（见下表）模块开发情况表3功能说明4设计说明5源代码清单6测试说明7复审的结论4.11测试计划及设计这里所说的测试，主要是指整个程序系统的组装测试和确认测试。本文件的编制是为了提供一个对该软件的测试计划，包括对每项测试活动的内容、进度安排、设计考虑、测试数据的整理方法及评价准则。具体的内容要求如下：1引言1.1编写目的1.2背景1.3定义1.4参考资料2计划2.1软件说明2.2测试内容
32、2.3测试1（标识符）2.3.1进度安排2.3.2条件2.3.3测试资料2.3.4测试培训2.4测试2（标识符）.3测试设计说明3.1测试l（标识符）3.1.1控制3.1.2输入3.1.3输出3.1.4过程3.2测试2（标识符）.4评价准则4.1范围4.2数据整理4.3尺度4.12测试分析报告测试分析报告的编写是为了把组装测试和确认测试的结果、发现及分析写成文件加以记载，具体的内容要求如下：1引言1.1编写目的1.2项目背景1.3定义1.4参考资料2测试计划执行情况2.1测试项目2.2测试机构和人员2.3测试结果3软件需求测试结论4评价4.1软件能力4.2缺陷和限制4.3建议4.4测试结论4.
33、13开发进度月报开发进度月报的编制目的是及时向有关管理部门汇报项目开发的进展和情况，以便及时发现和处理开发过程中出现的问题。一般地，开发进度月报是以项目组为单位每月编写的。如果被开发的软件系统规模比较大，整个工程项目被划分给若干个分项目组承担，开发进度月报将以分项目组为单位按月编写。具体的内容要求如下：1报告时间及所处的开发阶段2工程进度2.1本月内的主要活动2.2实际进展与计划比较3所用工时4所用机时5经费支出5.1支持性费用5.2设备购置费6工作遇到的问题及采取的对策7本月完成的成果8下月的工作计划9特殊问题4.14开发总结报告项目开发总结报告的编制是为了总结本项目开发工作的经验，说明实际
34、取得的开发结果以及对整个开发工作的各个方面的评价。具体的内容要求如下：1引言1.1编写目的1.2背景1.3定义1.4参考资料2.1产品2实际开发结果2.2主要功能和性能2.3基本流程2.4进度2.5费用3开发工作评价3.1对生产效率的评价3.2对产品质量的评价3.3对技术方法的评价3.4出错原因的分析4经验与教训附录:产品文件体系为了避免在软件开发中文件编制的不足或过分，一个简便的办法是把对软件文件的编制要求同软件的规模大小联系起来，这就是本例的出发点。软件的规模不妨分为四级：1小规模软件源程序行数小于5000的软件；2中规模软件源程序行数为1000050000的软件；3大规模软件源程序行数为100000500000的软件；4特大规模软件源程序行数大于500000的软件。对上述的四级软件的文件编制要求分别列于表O3。至于源程序行数为500010000，50000100000的软件，其文件编制要求介于两级之间，可根据一个软件产品的具体情况，由项目负责人参照表O3的规定，确定需要编制的文件种类。对于源程序行数大于500000的特大规模软件，可进一步把本指南规定的十四种文件按实际需要扩展成更多种类。