《计算机软件产品开发标准与规范.pdf》由会员分享,可在线阅读,更多相关《计算机软件产品开发标准与规范.pdf(50页珍藏版)》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
1、软件开发标准与规范jevin 引言1 目的一项计算机软件的筹划、研制及实现,构成一个软件开发项目。一个软件开发项目的进行,一般需要在人力和自动化资源等方面作重大的投资。为了保证项目开发的成功,最经济地花费这些投资,并且便于运行和维护,在开发工作的每一阶段,都需要编制二定的文件。这些文件连同计算机程序及数据一起,构成为计算机软件。文件是计算机软件中不可缺少的组成部分,它的作用是:a作为开发人员在一定阶段内的工作成果和结束标志;b向管理人员提供软件开发过程中的进展和情况,把软件开发过程中的一些“不可见的”事物转 换成“可见的”文字资料。以便管理人员在各个阶段检查开发计划的实施进展,使之能够判断原定
2、目标是否已达到,还将继续耗用资源的种类和数量;C记录开发过程中的技术信息,便于协调以后的软件开发、使用和修改;d提供对软件的有关运行、维护和培训的信息,便于管理人员、开发人员、操作人员和用户之间相互了解彼此的工作;e向潜在用户报导软件的功能和性能,使他们能判定该软件能否服务于自己的需要。换言之,本指南认为:文件的编制必须适应计算机软件整个生存周期的需要。计算机软件所包含的文件有两类:一类是开发过程中填写的各种图表,可称之为工作表格;另一类 则是应编制的技术资料或技术管理资料,可称之为文件。本指南规定软件文件的编制形式,并提供对这些规定的解释。本指南的目的是使得所编制的软件文件确实能够起到软件文
3、件应该发挥的作用。2 范围本指南是一份指导性文件。本指甫建议,在一项计算机软件的开发过程中,一般地说,应该产生十四种文件。这十四种文件是:可行性研究报告;项目开发计划;软件需求说明书;软件开发标准与规范jevin 数据要求说明书;概要设计说明书;详细设计说明书;数据库设计说明书;用户手册;操作手册;模块开发卷宗;测试计划;测试分析报告;开发进度月报;项目开发总结报告。本指南将给出开发过程中建议产生的这十四种文件的编制指导,同时,本指南也是这十四种文件的编写质量的检验准则。但是,本指南并未涉及软件开发过程中如何填写工作表格的问题。一般地说,一个软件总是一个计算机系统(包括硬件、固件和软件)的组成
4、部分。鉴于计算机系统的多样性,本指南一般不涉及整个系统开发中的文件编制问题,本指南仅仅是软件开发过程中的文件编制指南。3 文件的使用者对于使用文件的人员而言,他们所关心的文件的种类,随他们所承担的工作而异。管理人员:可行性研究报告,项目开发计划,模块开发卷宗,开发进度月报,项目开发总结报告;开发人员:可行性研究报告,项目开发计划,软件需求说明书,数据要求说明书,概要设计说明书,详细设计说明书,数据库设计说明书,测试计划,软件开发标准与规范jevin 测试分析报告;维护人员:设计说明书,测试分析报告,模块开发卷宗;用户:用户手册,操作手册。尽管本指南提出了在软件开发中文件编制的要求,但并不意味着
5、这些文件都必须交给用户。一项软件的用户应该得到的文件的种类由供应者与用户之间签订的合同规定。第一篇文件的编制指导4 软件生存周期与各种文件的编制一项计算机软件,从出现一个构思之日起,经过这项软件开发成功投入使用,直到最后决定停止使用,并被另一一项软件代替之时止,被认为是该软件的一个生存周期。一般地说这个软件生存周期可以分成以下六个阶段:可行性与计划研究阶段需求分析阶段设计阶段实现阶段测试阶段运行与维护阶段在可行性研究与计划阶段内,要确定该软件的开发目标和总的要求,要进行可行性分析、投资一收益分析、制订开发计划,并完成应编制的文件。在需求分析阶段内,由系统分析人员对被设计的系统进行系统分析,确定
6、对该软件的各项功能、性能需求和设计约束,确定对文件编制的要求,作为本阶段工作的结果,一般地说,软件需求说明书、数据要求说明书和初步的用户手册应该编写出来。在设计阶段内,系统设计人员和程序设计人员应该在反复理解软件需求的基础上,提出多个设计,分析每个设计能履行的功能并进行相互比较,最后确定一个设计,包括该软件的结构、模块的划分、功能的分配以及处理流程。在被设计系统比较复杂的情况下,设计阶段应分解成概要设计阶段和详细设计阶段两个步软件开发标准与规范jevin 骤。在一般情况下,应完成的文件包括:概要设计说明书、详细设计说明书和测试计划初稿。在实现阶段内,要完成源程序的编码、编译(或汇编)和排错调试
7、得到无语法错的程序清单,要开始编写模块开发卷宗,并且要完成用户手册、操作手册等面向用户的文件的编写工作,还要完成测试计划的编制。在测试阶段,该程序将被全面地测试,已编制的文件将被检查审阅。一般要完成模块开发卷宗和测试分析报告,作为开发工作的结束,所生产的程序、文件以及开发工作本身将逐项被评价,最后写出项目开发总结报告。在整个开发过程中(即前五个阶段中),开发集体要按月编写开发进度月报。在运行和维护阶段,软件将在运行使用中不断地被维护,根据新提出的需求进行必要而且可能的扩充和删改。对于一项软件而言,其生存周期各阶段与各种文件编写工作的关系可见表互,其中有些文件的编写工作可能要在若干个阶段中延续进
8、行。表 1 软件生存周期各阶段中的文件编制软件开发标准与规范jevin 5 文件编制中的考虑因素文件编制是一个不断努力的工作过程。是一个从形成最初轮廓,经反复检查和修改,直到程序和文件正式交付使用的完整过程。其中每一步都要求工作人员做出很大努力。要保证文件编制的质量,要体现每个开发项目的特点,也要注意不要花太多的人力。为此,编制中要考虑如下各项因素。51 文件的读者每一种文件都具有特定的读者。这些读者包括个人或小组、软件开发单位的成员或社会上的公众、从事软件工作的技术人员、管理人员或领导干部。他们期软件开发标准与规范jevin 待着使用这些文件的内容来进行工作,例如设计、编写程序、测试、使用、
9、维护或进行计划管理。因此,这些文件的作者必须了解自己的读者,这些文件的编写必须注意适应自己的特定读者的水平、特点和要求。52 重复性本指南第二篇中将列出的这十四种文件的内容要求中,显然存在某些重复。较明显的重复有两类。引言是每一种文件都要包含的内容,以向读者提供总的梗概。第二类明显的重复是各种文件中的说明部分,如对功能性能的说明、对输入和输出的描述、系统中包含的设备等。这是为了方便每种文件各自的读者,每种产品文件应该自成体系,尽量避免读一种文件时又不得不去参考另一种文件。当然,在每一种文件里,有关引言、说明等同其他文件相重复的部分,在行文上、在所用的术语上、在详细的程度上,还是应该有一些差别,
10、以适应各种文件的不同读者的需要。53 灵活性鉴于软件开发是具有创造性的脑力劳动,也鉴于不同软件在规模上和复杂程度上差别极大,本指南认为在文件编制工作中应允许一定的灵活性。这种灵活性表现在如下各款。531 应编制的文件种类尽管本指南认为在一般情况下,一项软件的开发过程中,应产生的文件有十四种,然而针对一项具体的软件开发项目,有时不必编制这么多的文件,可以把几种文件合并成一种。一般地说,当项目的规模、复杂性和成败风险增大时,文件编制的范围、管理手续和详细程度将随之增加。反之,则可适当减少。为了恰当地掌握这种灵活性,本指南要求贯彻分工负责的原则,这意味着:a:一个软件开发单位的领导机构应该根据本单位
11、经营承包的应用软件的专业领域和本单位的管理能力,制定一个对文件编制要求的实施规定,主要是:在不同的条件下,应该形成哪些文件?这些文件的详细程度?该开发单位的每一个项目负责人,必须认真执行这个实施规定。这种规定的两个例子可叹本指南的附录 o(参考件);b对于一个具体的应用软件项目,项目负责人应根据上述实施规定,确定一个文件编制计划,主中包括:软件开发标准与规范jevin(1)应该编制哪几种文件,详细程度如何?(2)各个文件的编制负责人和进度要求;(3)审查、批准的负责人和时间进度安排;(4)在开发时期内,各文件的维护、修改和管理的负责人,以及批准手续。每项工作必须落实到人。这个文件编制计划 是整
12、个开发计划的重要组成部分;C有关的设计人员则必须严格执行这个文件编制计划。532 文件的详细程度从同一份提纲起草的文件的篇幅大小往往不同,可以少到几页,也可以长达几百页。对于这种差别本指南是允许的。此详细程度取决于 任务的规模、复杂性和项目负责人对该软件的开发过程及运行环与所需要的详细程度的判断。533 文件的扩展当被开发系统的规模非常大(例如源码超过一百万行)时,一种文件可以分成几卷编写,可以按其。每一个系统分别编制,也可以按内容划分成多卷,例如:项目开发计划可能包括:质量保证计划,配置管理计划,用户培训计划,安装实施计划;系统设计说明书可分写成:系统设计说明书,子系统设计说明书;程序设计说
13、明书可分写成:程序设计说明书,接口设计说明书,版本说明;操作手册可分写成:操作手册,安装实施过程;测试计划可分写成:测试计划,测试设计说明,测试规程,测试用例;测试分析报告可分写成:综合测试报告,软件开发标准与规范jevin 验收测试报告;项目开发总结报告亦可分写成项目开发总结报告和资源环境统计。534 节的扩张与缩并在有些文件中,可以使用本指南所提供的章、条标题,但在条内又存在一系列需要分别讨论的因素本指南认为,所有的条都可以扩展,可以进一步细分,以适应实际需要。反之,如果章条中的有些细节;非必需,也可以根据实际情况缩并。此时章条的编号应相应地改变。535 程序设计的表现形式本指南对于程序的
14、设计表现形式并未作出规定或限制,可以使用流程图的形式、判定表的形式,1 可以使用其他表现形式,如程序设计语言(PDL)、问题分析图(PAD)等。536 文件的表现形式本指南对于文件的表现形式亦未作出规定或限制,可以使用自然语言,也可以使用形式化语言。537 文件的其他种类当本指南中规定的文件种类尚不能满足某些应用部门的特殊需要时,他们可以建立一些特殊的文件种类要求,例如软件质量保证计划、软件配置管理计划等,这些要求可以包含在本单位的文件编制实施规定中。6 文件编制的管理工作文件编制工作必须有管理工作的配合,才能使所编制的文件真正发挥它的作用。文件的编制工作实际上贯穿于一项软件的整个开发过程,因
15、此,对文件的管理必须贯穿于整个开发过程。在开发过程中必须进行的管理工作是以下四条。软件开发标准与规范jevin 61 文件的形成开发集体中的每个成员,尤其是项目负责人,应该认识到:文件是软件产品的必不可少的组成部分;在软件开发过程的各个阶段中,必须按照规定及时地完成各种产品文件的编写工作;必须把在一个开发步骤中作出的决定和取得的结果及时地写入文件;开发集体必须及时地对这些文件进行严格的评审;这些文件的形成是各个阶段开发工作正式完成的标志。这些文件上必须有编写者、评审者和批准者的签字,必须有编写、评审完成的日期和批准的日期。62 文件的分类与标识在软件开发的过程中,产生的文件是很多的,为了便于保
16、存、查找、使用和修改,应该对文件按层次地加以分类组织。一个软件开发单位应该建立一个对本单位文件的标识方法,使文件的每一页都具有明确的标识。例如可以按如下四个层次对文件加以分类和标识。a文件所属的项目的标识;b文件种类的标识;C同一种文件的不同版本号;d页号。此外,对每种文件还应根据项目的性质,划定它们各自的保密级别,确定他们各自的发行范围。6 3 文件的控制在一项软件的开发过程中,随着程序的逐步形成和逐步修改,各种文件亦在不断地产生、不断地修改或补充。因此,必须加以周密的控制,以保持文件与程序产品的一致性,保持各种文件之间的一致性和文件的安全性。这种控制表现为:a就从事一项软件开发工作的开发集
17、体而言,应设置一位专职的文件管理人员(接口管理工程师或文件管理员);在开发集体中,应该集中保管本项目现有全部文件的主文本两套,由该文件管理人员负责保管;b每一份提交给文件管理人员的文件都必须具有编写人、审核人和批准人的签字;C这两套主文本的内容必须完全一致;其中有一套是可供出借的,另一套是绝对不能出借的,以免发生万一;可出借的主文本在出借时必须办理出借手续,归还时办理注销出借手续;软件开发标准与规范jevin d开发集体中的工作人员可以根据工作的需要,在本项目的开发过程中持有一些文件,即所谓个人文件,包括为使他完成他承担的任务所需要的文件,以及他在完成任务过程中所编制的文件;但这种 个人文件必
18、须是主文本的复制品,必须同主文本完全一致,若要修改,必须首先修改主文本;e不同开发人员所拥有的个人文件通常是主文本的各种子集;所谓子集是指把主文本的各个部分根据承担不同任务的人员或部门的工作需要加以复制、组装而成的若干个文件的集合;文件管理人员。应该列出一份不同子集的分发对象的清单,按照清单及时把文件分发给有关人员或部门;f一份文件如果已经被另一份新的文件所代替,则原文件应该被注销;文件管理人中要随时整理主文本,及时反映出文件的变化和增加情况,及时分发文件;g当一个项目的开发工作临近结束时,文件管理人员应逐个收回开发集体内每个成员的个人文件,并检查这些个人文件的内容;经验表明,这些个人文件往往
19、可能比主文本更详细,或同主文本的内容有所不同,必须认真监督有关人员进行修改,使主文本能真正反映实际的开发结果。6 4 文件的修改管理在一个项目的开发过程中的任何时刻,开发集体内的所有成员都可能对开发工作的已有成果 文件,提出进行修改的要求。提出修改要求的理由可能是各种各样的,进行修改而引起的影响可能很小,也可能会牵涉到本项目的很多方面。因此,修改活动的进行必须谨慎,必须对修改活动的进行加以管理,必须执行修改活动的规程,使整个修改活动有控制地进行。修改活动可分如下五个步骤进行:a提议开发集体中的任何一个成员都可以向项目负责人提出修改建议,为此应该填写一份修改建议表,说明修改的内容、所修改的文件和
20、部位、以及修改理由;b评议由项目负责人或项目负责人指定的人员对该修改建议进行评议,包括审查该项修改的必要性、确定这一修改的影响范围、研究进行修改的方法、步骤和实施计划;c审核一般由项目负责人进行审核,包括核实修改的自的和要求、核实修改活动将带来的影响、审核修改活动计划是否可行;d批准在一般情况下,批准权属于该开发单位的部门负责人;在批准时,主要是决断修改工作中各项活动的先后顺序及各自的完成日期,以保证整个开发工作按原定计划日期完成;e实施由项目负责人按照已批准的修改活动计划,安排各项修改活动的负责软件开发标准与规范jevin 人员进行修改,建立修改记录、产生新的文件以取代原有文件、最后把文件交
21、文件管理人员归档,并分发给有关的持有者。第二篇各种文件的内容要求本篇将对引言中提到的十四种文件提供内容要求,作为文件编制的技术标准。7 可行性研究报告可行性研究报告的编写目的是:说明该软件开发项目的实现在技术、经济和社会条件方面的可行性;评述为了合理地达到开发目标而可能选择的各种方案;说明并论证所选定的方案。可行性研究报告的编写内容要求如下:71 引言 71C1 编写目的 712 背景 713 定义 714 参考资料7 72 可行性研究的前提 721 要求 722 目标 723 条件、假定和限制 724 进行可行性研究的方法 725 评价尺度 73 对现有系统的分析 731 数据流程和处理流程
22、 732 工作负荷 733 费用开支 734 人员 735 设备 736 局限性74 所建议的系统 741 对所建议系统的说明软件开发标准与规范jevin 742 数据流程和处理流程 743 改进之处 744 影响 7441 对设备的影响 7442 对软件的影响 7443 对用户单位机构的影响 7444 对系统运行的影响 7445 对开发的影响 74,46 对地点和设施的影响 7447 对经费开支的影响 745 局限性 746 技术条件方面的可行性75 可选择的其他系统方案 751 可选择的系统方案1 752 可选择的系统方案2 76 投资及收益分析 761 支出 7611 基本建设投资 76
23、12 其他一次性支出 7613 非一次性支出 762 收益 76,21 一次性收益 7622 非一次性收益 7623 不可定量的收益 763 收益投资比 764 投资回收周期 765 敏感性分析77 社会条件方面的可行性 771 法律方面的可行性 772 使用方面的可行性78 结论软件开发标准与规范jevin 8 项目开发计划编制项目开发计划的目的是用文件的形式,把对于在开发过程中各项工作的负责人员、开发进度、所需经费预算、所需软、硬件条件等问题作出的安排记载下来,以便根据本计划开展和检查本项目的开发工作。编制内容要求如下:81 引言811 编写目的812 背景813 定义814 参考资料82
24、 项目概述821 作内容822 主要参加人员823 产品及成果8231 程序8232 文件8233 服务8234 非移交产品824 验收标准825 完成项目的最迟期限826 本计划的审查者与批准者83 实施总计划831 工作任务的分解832 接口人员833 进度834 预算835 关键问题84 支持条件841 计算机系统支持842 需要用户承担的工作843 需由外单位提供的条件85 专题计划要点软件开发标准与规范jevin 9 软件需求说明书软件需求说明书的编制是为了使用户和软件开发者双方对该软件的初始规定有一个共同的理解,使之成为整个开发工作的基础。编制软件需求说明书的内容要求如下:91 引
25、言911 编写目的912 背景913 定义914 参考资料92 任务概述921 目标922 用户的特点923 假定与约束93 需求规定931 对功能的规定932 对性能的规定9321 精度9322 时间特性耍求9323 灵活性933 输入输出要求934 数据管理能力要求935 故障处理要求936 其他专门要求94 运行环境规定941 设备942 支持软件943 接口944 控制10 数据要求说明书数据 要求说明书的编制目的是为了向整个开发时期提供关于被处理数据的描软件开发标准与规范jevin 述和数据采集要求的技术信息。编制数据要求说明书的内容要求如下:101 引言1011 编写目的1012
26、背景1013 定义1014 参考资料102 数据的逻辑描述1021 静态数据1022 动态输入数据1023 动态输出数据1024 内部生成数据1025 数据约定103 数据的采集1031 要求和范围1032 输入的承担者1033 处理1034 影响。11 概要设计说明书概要设计说明书又可称系统设计说明书,这里所说的系统是指程序系统。编制的目的是说明对程序系统的设计考虑,包括程序系统的基本处。流程、程序系统的组织结构、模块划分、功能分配、接口设计。运行设计、数据结构设计和出错处理设计等,为程序的详细设计提供基础。编制概要设计说明书的内容要求如下:111 引言1111 编写目的1112 背景111
27、3 定义1114 参考资料112 总体设计1121 需求规定1122 运行环境1123 基本设计概念和处理流程1124 结构软件开发标准与规范jevin 1125 功能需求与程序的关系1126 人工处理过程1127 尚未解决的问题113 接口设计1131 用户接口1132 外部接口1133 内部接口114 运行设计1141 运行模块组合1142 运行控制1143 运行时间115 系统论据结构设计1151 逻辑结构设计要点1152 物理结构设计要点1153 数据结构与程序的关系11 6 系统出错处理设计1161 出错信息1162 补救措施116 3 系统维护设计12 详细设计说明书详细设计说明书
28、又可称程序设计说明书。编制目的是说明一个软件系统各个层次中的每一个程序(每个模块或子程序)的设计考虑,如果一个软件系统比较简单,层次很少,本文件可以不单独编写,有关内容合并入概要设计说明书。对详细设计说明书的内容要求如下:121 引言1211 编写目的1212 背景1213 定义1214 参考资料122 程序系统的组织结构12 3 程序 1(标识符)设计说明1231 程序描述1232 功能软件开发标准与规范jevin 1233 性能1234 输入项1235 输出项1236 算法1237 流程逻辑1238 接口1239 存储分配12310 注释设计12311 限制条件12312 测试计划1231
29、3 尚未解决的问题124 程序 2(标识符)设计说明13 数据库设计说明书数据库设计说明书的编制目的是对于设计中的数据库的所有标识、逻辑结构和物理结构作出具体的设计规定。其内容要求如下:131 引言1311 编写目的1312 背景1313 定义1314 参考资料132 外部设计1321 标识符和状态1322 使用它的程序1323 约定1324 专门指导1325 支持软件13 3 结构设计1331 概念结构设计1332 逻辑结构设计1333 物理结构设计13 4 运用设计1341 数据字典设计1342 安全保密设计软件开发标准与规范jevin 14 用户手册用户手册的编制是要使用非专门术语的语言
30、,充分地描述该软件系统所具有的功能及基本的使用方法。使用户(或潜在用户)通过本手册能够了解该软件的用途,并且能够确定在什么情况下,如何使用它。具体的内容要求如下:141 引言1411 编写目的1412 背景1413 定义1414 参考资料142 用途1421 功能1422 性能14221 精度14222 时间特性14223 灵活性1423 安全保密14 3 运行环境1431 硬设备1432 支持软件1433 数据结构144 使用过程1441 安装与初始化1442 输入14421 输入数据的现实背景14422 输入格式14423 输入举例1443 输出14431 输出数据的现实背景14432 输
31、出格式14433 输出举例1444 文卷查询1445 出错处理与恢复1446 终端操作软件开发标准与规范jevin 15 操作手册操作手册的编制是为了向操作人员提供该软件每一个运行的具体过程和有关知识,包括操作方法的细节。具体的内容要求如下:151 引言1511 编写目的1512 背景1513 定义1514 参考资料15 2 软件概述1521 软件的结构1522 程序表1523 文卷表153 安装与初始化154 运行说明1541 运行表1542 运行步骤1543 运行 1(标识符)说明15431 运行控制15432 操作信息15433 输入一输出文卷15434 输出文段15435 输出文段的复
32、制15436 启动恢复过程1544 运行 2(标识符)说明155 非常现过程156 远程操作16 模块开发卷宗模块开发卷宗是在模块开发过程中逐步编写出来的,每完成一个模块或一组密软件开发标准与规范jevin 切相关的模块的复审时编写一份,应该把所有的模块开发卷宗汇集在一起。编写的目的是记录和汇总低层次开发的进度和结果,以便于对整个模块开发工作的管理和复审,并为将来的维护提供非常有用的技术信息。具体的内容要求如下:16 1 标题162 模块开发情况表(见下表)模块开发情况表163 功能说明 164 设计说明165 源代码清单166 测试说明167 复审的结论软件开发标准与规范jevin 17 测
33、试计划这里所说的测试,主要是指整个程序系统的组装测试和确认测试。本文件的编制是为了提供一个对该软件的测试计划,包括对每项测试活动的内容、进度安排、设计考虑、测试数据的整理方法及评价准则。具体的内容要求如下:171 引言1711 编写目的1712 背景1713 定义1714 参考资料17 2 计划1721 软件说明1722 测试内容1723 测试 1(标识符)17231 进度安排17232 条件17233 测试资料17234 测试培训1724 测试 2(标识符)173 测试设计说明1731 测试 l(标识符)17311 控制17312 输入17313 输出17314 过程1732 测试 2(标识
34、符)174 评价准则1741 范围1742 数据整理1743 尺度软件开发标准与规范jevin 18 测试分析报告测试分析报告的编写是为了把组装测试和确认测试的结果、发现及分析写成文件加以记载,具体的内容要求如下:181 引言1811 编写目的1812 背景1813 定义1814 参考资料182 测试概 要183 测试结果及发现1831 测试 1(标识符)1832 测试 2(标识符)184 对软件功能的结论1841 功能 1(标识符)18411 能力18412 限制1842 功能 2(标识符)185 分析摘要1851 能力1852 缺陷和限制1853 建议1854 评价186 测试资源消耗19
35、 开发进度月报开发进度月报的编制目的是及时向有关管理部门汇报项目开发的进展和情况,以便及时发现和处理开发过程中出现的问题。一般地,开发进度月报是以项目组为单位每月编写的。如果被开发的软件系统规模比较大,整个工程项目被划分给若干个分项目组承担,开发进度月报将以分项目组为单位按月编写。具体的内容要求如下:191 标题192 工程进度与状态软件开发标准与规范jevin 1921 进度1922 状态193 资源耗用与状态1931 资源耗用19311 工时19312 机时1932 状态194 经费支出与状态1941 经费支出19411 支持性费用19412 设备购置费1942 状态195 下个月的工作计
36、划196 建议20 项目开发总结报告项目开发总结报告的编制是为了总结本项目开发工作的经验,说明实际取得的开发结果以及对整个开发工作的各个方面的评价。具体的内容要求如下:201 引言2011 编写目的2012 背景2013 定义2014 参考资料2021 产品202 实际开发结果2022 主要功能和性能2023 基本流程2024 进度2025 费用203 开发工作评价2031 对生产效率的评价2032 对产品质量的评价2033 对技术方法的评价软件开发标准与规范jevin 2034 出错原因的分析204 经验与教训附录 A 可行性研究报告的编写提示(参考件)A1 引言A11 编写目的说明编写本可
37、行性研究报告的目的,指出预期的读者。A12 背景说明:a所建议开发的软件系统的名称;b本项目的任务提出者、开发者、用户及实现该软件的计算中心或计算机网络;C该软件系统同其他系统或其他机构的基本的相互来往关系。A13 定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。A14 参考资料列出用得着的参考资料,如:a本项目的经核准的计划任务书或合同、上级机关的批文;b属于本项目的其他已发表的文件;C本文件中各处引用的文件、资料,包括所需用到的软件开发标准。|列出这些文件资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。A2 可行性研究的前提说明对所建议的开发项目进行
38、可行性研究的前提,如要求、目标、假定、限制等。A21 要求说明对所建议开发的软件的基本要求,如:a功能;软件开发标准与规范jevin b性能;C输出如报告、文件或数据,对每项输出要说明其特征,如用途、产生频度、接口以及分发对象;d输入说明系统的输入,包括数据的来源、类型、数量、数据的组织以及提供的频度;e处理流程和数据流程用图表的方式表示出最基本的数据流程和处理流程,并辅之以叙述;f在安全与保密方面的要求;g同本系统相连接的其他系统;h完成期限。A22 目标说明所建议系统的主要开发目标,如:a人力与设备费用的减少;b处理速度的提高;C控制精度或生产能力的提高;d管理信息服务的改进;e自动决策系
39、统的改进;f人员利用率的改进。A23 条件、假定和限制说明对这项开发中给出的条件、假定和所受到的限制,如:a所建议系统的运行寿命的最小值;b进行系统方案选择比较的时间;c经费、投资方面的来源和限制;d法律和政策方面的限制;e硬件、软件、运行环境和开发环境方面的条件和限制;f可利用的信息和资源;g系统投入使用的最晚时间。A24 进行可行性研究的方法说明这项可行性研究将是如何进行的,所建议的系统将是如何评价的。摘要说明所使用的基本方法和策略,如调查、加权、确定模型、建立基准点或仿真等。A25 评价尺度说明对系统进行评价时所使用的主要尺度,如费用的多少、各项功能的优先次序、开发时间的长短及使用中的难
40、易程度。软件开发标准与规范jevin A3 对现有系统的分析这里的现有系统是指当前实际使用的系统,这个系统可能是计算机系统,也可能是一个机械系统甚至是一个人工系统。分析现有系统的目的是为了进一步阐明建议中的开发新系统或修改现有系统的必要性。A31 处理流程和数据流程说明现有系统的基本的处理流程和数据流程。此流程可用图表即流程图的形式表示,并加以叙述。A32 工作负荷列出现有系统所承担的工作及工作量。A33 费用开支列出由于运行现有系统所引起的费用开支,如人力、设备、空间、支持性服务、材料等项开支以及开支总额。A34 人员列出为了现有系统的运行和维护所需要的人员的专业技术类别和数量。A35 设备
41、列出现有系统所使用的各种设备。A36 局限性列出本系统的主要的局限性,例如处理时间赶不上需要,响应不及时,数据存储能力不足,处理功能不够等。并且要说明,为什么对现有系统的改进性维护已经不能解决问题。A4 所建议的系统本章将用来说明所建议系统的目标和要求将如何被满足。A41 对所建议系统的说明概括地说明所建议系统,并说明在第 A2 章中列出的那些要求将如何得到满足,说明所使用的基本方法及理论根据。A42 处理流程和数据流程给出所建议系统的处理流程和数据流程。A43 改进之处按 A22 条中列出的目标,逐项说明所建议系统相对于现存系统具有的改进。A44 影响说明在建立所建议系统时,预期将带来的影响
42、,包括:A441 对设备的影响软件开发标准与规范jevin 说明新提出的设备要求及对现存系统中尚可使用的设备须作出的修改。A442 对软件的影响说明为了使现存的应用软件和支持软件能够同所建议系统相适应。而需要对这些软件所进行的修改和补充。A443 对用户单位机构的影响说明为了建立和运行所建议系统,对用户单位机构、人员的数量和技术水平等方面的全部要求。A 4 4 4 对系统运行过程的影响说明所建议系统对运行过程的影响,如:a用户的操作规程;b运行中心的操作规程;C运行中心与用户之间的关系;d源数据的处理;e数据进入系统的过程;f对数据保存的要求,对数据存储、恢复的处理;g输出报告的处理过程、存储
43、媒体和调度方法;h系统失效的后果及恢复的处理办法。A445 对开发的影响说明对开发的影响,如:a为了支持所建议系统的开发,用户需进行的工作;b为了建立一个数据库所要求的数据资源;C为了开发和测验所建议系统而需要的计算机资源;d所涉及的保密与安全问题。A446 对地点和设施的影响说明对建筑物改造的要求及对环境设施的要求。A447 对经费开支的影响扼要说明为了所建议系统的开发,设计和维持运行而需要的各项经费开支。A45 局限性说明所建议系统尚存在的局限性以及这些问题未能消除的原因。A46 技术条件方面的可行性本节应说明技术条件方面的可行性,如:a在当前的限制条件下,该系统的功能目标能否达到;b利用
44、现有的技术,该系统的功能能否实现;C对开发人员的数量和质量的要求并说明这些要求能否满足;软件开发标准与规范jevin d在规定的期限内,本系统的开发能否完成。A5 可选择的其他系统方案扼要说明曾考虑过的每一种可选择的系统方案,包括需开发的和可从国内国外直接购买的,如果没有供选择的系统方案可考虑,则说明这一点。A51 可选择的系统方案1 参照第 A4 章的提纲,说明可选择的系统方案1,并说明它未被选中的理由。A52 可选择的系统方案2 按类似 A 5 1 条的方式说明第 2 个乃至第。个可选择的系统方案。A6 投资及效益分析A61 支出对于所选择的方案,说明所需的费用。如果已有一个现存系统,则包
45、括该系统继续运行期间所需的费用。A611 基本建设投资包括采购、开发和安装下列各项所需的费用,如:a房屋和设施;b A DP 设备;C数据通讯设备;d环境保护设备;e安全与保密设备;fADP 操作系统的和应用的软件;g数据库管理软件。A612 其他一次性支出包括下列各项所需的费用,如:a研究(需求的研究和设计的研究);b开发计划与测量基准的研究;C数据库的建立;dADP 软件的转换;e检查费用和技术管理性费用;f培训费、旅差费以及开发安装人员所需要的一次性支出;g人员的退休及调动费用等。A613 非一次性支出软件开发标准与规范jevin 列出在该系统生命期内按月或按季或按年支出的用于运行和维护
46、的费用,包括:a设备的租金和维护费用;b 软件的租金和维护费用;C数据通讯方面的租金和维护费用;d人员的工资、奖金;e房屋、空间的使用开支;f公用设施方面的开支;g保密安全方面的开支;h其他经常性的支出等。A62 收益对于所选择的方案,说明能够带来的收益,这里所说的收益,表现为开支费用的减少或避免、差错的减少、灵活性的增加、动作速度的提高和管理计划方面的改进等,包括;A621 一次性收益说明能够用人民币数目表示的一次性收益,可按数据处理、用户、管理和支持等项分类叙述,如:a开支的缩减包括改进了的系统的运行所引起的开支缩减,如资源要求的减少,运行效率的改进,数据进入、存贮和恢复技术的改进,系统性
47、能的可监控,软件的转换和优化,数据压缩技术的采用,处理的集中化分布化等;b价值的增升包括由于一个应用系统的使用价值的增升所引起的收益,如资源利用的改进,管理和运行效率的改进以及出错率的减少等;C其他如从多余设备出售回收的收入等。A622 非一次性收益说明在整个系统生命期内由于运行所建议系统而导致的按月的、按年的能用人民币数目表示的收益,包括开支的减少和避免。A623 不可定量的收益逐项列出无法直接用人民币表示的收益,如服务的改进,由操作失误引起的风险的减少,信息掌握情况的改进,组织机构给外界形象的改善等。有些不可捉摸的收益只能大概估计或进行极值估计(按最好和最差情况估计)。A63 收益投资比求
48、出整个系统生命期的收益投资比值。A64 投资回收周期求出收益的累计数开始超过支出的累计数的时间。A65 敏感性分析软件开发标准与规范jevin 所谓敏感性分析是指一些关键性因素如系统生命期长度、系统的工作负荷量、工作负荷的类型与这些不同类型之间的合理搭配、处理速度要求、设备和软件的配置等变化时,对开支和收益的影响最灵敏的范围的估计。在敏感性分析的基础上做出的选择当然会比单一选择的结果要好一些。A7 社会因素方面的可行性本章用来说明对社会因素方面的可行性分析的结果,包括:A71 法律方面的可行性法律方面的可行性问题很多,如合同责任、侵犯专利权、侵犯版权等方面的陷井,软件人员通常是不熟悉的,有可能
49、陷入,务必要注意研究。A72 使用方面的可行性例如从用户单位的行政管理、工作制度等方面来看,是否能够使用该软件系统;从用户单位的工作人员的素质来看,是否能满足使用该软件系统的要求等等,都是要考虑的。A8 结论在进行可行性研究报告的编制时,必须有一个研究的结论。结论可以是:a可以立即开始进行;b需要推迟到某些条件(例如资金、人力、设备等)落实之后才能开始进行;c需要对开发目标进行某些修改之后才能开始进行;d不能进行或不必进行(例如因技术不成熟、经济上不合算等)。附录 B 项目开发计划的编写提示B1 引言B11 编写目的说明编写这份项目开发计划的目的,并指出预期的读者。B12 背景说明:软件开发标
50、准与规范jevin a待开发的软件系统的名称;b本项目的任务提出者、开发者、用户及实现该软件的计算中心或计算机网络;C该软件系统同其他系统或其他机构的基本的相互来往关系。B13 定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。B14 参考资料列出用得着的参考资料,如:a本项目的经核准的计划任务书或合同、上级机关的批文;b属于本项目的其他已发表的文件;C本文件中各处引用的文件、资料,包括所要用到的软件开发标准。列出这些文件资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。B2 项目概述B21 工作内容简要地说明在本项目的开发中须进行的各项主要工作。B22 主