国家标准文档格式

上传人:无*** 文档编号:101161711 上传时间:2022-06-04 格式:DOC 页数:29 大小:122KB
返回 下载 相关 举报
国家标准文档格式_第1页
第1页 / 共29页
国家标准文档格式_第2页
第2页 / 共29页
国家标准文档格式_第3页
第3页 / 共29页
点击查看更多>>
资源描述
-计算机行业标准化网.nits.gov./jhb/软件设计文档国家标准 wendang./soft/4727.htm附录 国家标准文档格式附录1 可行性研究报告可行性研究报告的编写目的是:说明该软件开发工程的实现在技术、经济和社会条件方面的可行性;评述为了合理地到达开发目标而可能选择的各种方案;说明并论证所选定的方案。可行性研究报告的编写内容要求如下:1. 引言1.1 编写目的说明编写本可行性研究报告的目的,指出预期的读者。1.2 背景说明:a. 所建议开发的软件系统的名称;b. 本工程的任务提出者、开发者、用户及实现该软件的计算中心或计算机网络;c. 该软件系统同其他系统或其他机构的根本的相互来往关系。1.3定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。1.4参考资料列出用得着的参考资料,如:a. 本工程的经核准的方案任务书或合同、上级机关的批文;b. 属于本工程的其他已发表的文件;c. 本文件中各处引用的文件、资料,包括所需用到的软件开发标准。列出这些文件资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。2. 可行性研究的前提说明对所建议的开发工程进展可行性研究的前提,如要求、目标、假定、限制等。2.1 要求说明对所建议开发的软件的根本要求,如:a. 功能;b. 性能;c. 输出如报告、文件或数据,对每项输出要说明其特征,如用途、产生频度、接口以及分发对象;d. 输入说明系统的输入,包括数据的来源、类型、数量、数据的组织以及提供的频度;e. 处理流程和数据流程用图表的方式表示出最根本的数据流程和处理流程,并辅之以表达;f. 在平安与*方面的要求;g. 同本系统相连接的其他系统;h. 完成期限。2.2 目标说明所建议系统的主要开发目标,如:a. 人力与设备费用的减少;b. 处理速度的提高;c. 控制精度或生产能力的提高;d. 管理信息效劳的改良;e. 自动决策系统的改良;f. 人员利用率的改良。 2.3 条件、假定和限制说明对这项开发中给出的条件、假定和所受到的限制,如:a. 所建议系统的运行寿命的最小值;b. 进展系统方案选择比拟的时间; c. 经费、投资方面的来源和限制; d. 法律和政策方面的限制;e. 硬件、软件、运行环境和开发环境方面的条件和限制;f. 可利用的信息和资源;g. 系统投入使用的最晚时间。2.4 进展可行性研究的方法说明这项可行性研究将是如何进展的,所建议的系统将是如何评价的。摘要说明所使用的根本方法和策略,如调查、加权、确定模型、建立基准占或仿真等。2.5 评价尺度说明对系统进展评价时所使用的主要尺度,如费用的多少、各项功能的优先次序、开发时间的长短及使用中的难易程序。3. 对现有系统的分析这里的现有系统是指当前实际使用的系统,这个系统可能是计算机系统,也可能是一个机械系统甚至是一个人工系统。分析现有系统的目的是为了进一步说明建议中的开发新系统或修改现有系统的必要性。3.1 处理流程和数据流程说明现有系统的根本的处理流程和数据流程。此流程可用图表即流程图的形式表示,并加以表达。3.2 工作负荷列出现有系统所承当的工作及工作量。3.3 费用开支列出由于运行现有系统所引起的费用开支,如人力、设备、空间、支持性效劳、材料等项开支以及开支总额。3.4 人员列出为了现有系统的运行和维护所需要的人员的专业技术类别和数量。3.5 设备列出现有系统所使用的各种设备。3.6 局限性列出本系统的主要的局限性,例如处理时间赶不上需要,响应不及时,数据存储能力缺乏,处理功能 不够等。并且要说明,为什么对现有系统的改良性维护已经不能解决问题。4. 所建议的系统本章将用来说明所建议系统的目标和要求将如何被满足。4.1 对所建议系统的说明概括地说明所建议系统,并说明在第A2章中列出的那些要求将如何得到满足,说明所使用的根本方法及理论根据。4.2 处理流程和数据流程给出所建议系统的处理流程和数据流程。4.3 影响说明在建立所建议系统时,预期将带来的影响,包括: 对设备的影响说明新提出的设备要求及对现存系统*可使用的设备须作出的修改。 对软件的影响说明为了使现存的应用软件和支持软件能够同所建议系统相适应。而需要对这些软件所进展的修改和补充。 对用户单位机构的影响说明为了建立和运行所建议系统,对用户单位机构、人员的数量和技术水平等方面的全部要求。 对系统运行过程的影响说明所建议系统对运行过程的影响,如:a. 用户的操作规程;b. 运行中心的操作规程; c. 运行中心与用户之间的关系;d. 源数据的处理; e. 数据进入系统的过程;f. 对数据保存的要求,对数据存储、恢复的处理;g. 输出报告的处理过程、存储媒体和调度方法;h. 系统失效的后果及恢复的处理方法。 对开发的影响说明对于开发的影响,如:a. 为了支持所建议系统的开发,用户需进展的工作;b. 为了建立一个数据库所要求的数据资源;c. 为了开发和测验所建议系统而需要的计算机资源;d. 所涉及的*与平安问题。 对地点和设施的影响说明对建筑物改造的要求及对环境设施的要求。 对经费开支的影响扼要说明为了所建议系统的开发,设计和维持运行而需要的各项经费开支。4.5 局限性说明所建议系统尚存在的局限性以及这些问题未能消除的原因。4.6 技术条件方面的可行性本节应说明技术条件方面的可行性,如:a. 在当前的限制条件下,该系统的功能目标能否到达;b. 利用现有的技术,该系统的功能能否实现;c. 对开发人员的数量和质量的要求并说明这些要求能否满足;d. 在规定的期限内,本系统的开发能否完成。5. 可选择的其他系统方案 扼要说明曾考虑过的每一种可选择的系统方案,包括需开发的和可从国内国外直接购置的,如果没 有供选择的系统方案可考虑,则说明这一点。 5.1 可选择的系统方案1 说明可选择的系统方案1,并说明它未被选中的理由。5.2可选择的系统方案2 按类似5.1条的方式说明第2个乃至第n个可选择的系统方案。6. 投资及效益分析 6.1 支出对于所选择的方案,说明所需的费用。如果已有一个现存系统,则包括该系统继续运行期间所需的费用。 根本建立投资包括采购、开发和安装以下各项所需的费用,如: a. 房屋和设施;bADP设备; c. 数据通讯设备;d. 环境保护设备;e. 平安与*设备;fADP操作系统的和应用的软件; g. 数据库管理软件。 其他一次性支出包括以下各项所需的费用,如:a. 研究需求的研究和设计的研究;b. 开发方案与测量基准的研究;c. 数据库的建立;d. ADP软件的转换;e. 检查费用和技术管理性费用;f. 培训费、旅差费以及开发安装人员所需要的一次性支出; g. 人员的退休及调动费用等。 非一次性支出列出在该系统生命期内按月或按季或按年支出的用于运行和维护的费用,包括: a. 设备的租金和维护费用; b. 软件的租金和维护费用;c. 数据通讯方面的租金和维护费用;d. 人员的工资、奖金;e. 房屋、空间的使用开支;f. 公用设施方面的开支;g. *平安方面的开支; h. 其他经常性的支出等。6.2 收益 对于所选择的方案,说明能够带来的收益,这里所说的收益,表现为开支费用的减少或防止、过失的减少、灵活性的增加、动作速度的提高和管理方案方面的改良等,包括;一次性收益说明能够用人民币数目表示的一次性收益,可按数据处理、用户、管理和支持等项分类表达,如:a. 开支的缩减包括改良了的系统的运行所引起的开支缩减,如资源要求的减少,运行效率的改良,数据进入、存贮和恢复技术的改良,系统性能的可监控,软件的转换和优化,数据压缩技术的采用,处理的集中化分布化等; b. 价值的增升包括由于一个应用系统的使用价值的增升所引起的收益,如资源利用的改良,管理和运行效率的改良以及出错率的减少等;c. 其他如从多余设备出售回收的收入等。 非一次性收益 说明在整个系统生命期内由于运行所建议系统而导致的按月的、按年的能用人民币数目表示的收益,包括开支的减少和防止。 不可定量的收益 逐项列出无法直接用人民币表示的收益,如效劳的改良,由操作失误引起的风险的减少,信息掌握情况的改良,组织机构给外界形象的改善等。有些不可捉摸的收益只能大概估计或进展极值估计按最好和最差情况估计。 6.3 收益投资比求出整个系统生命期的收益投资比值。 6.4 投资回收周期 求出收益的累计数开场超过支出的累计数的时间。6.5 敏感性分析所谓敏感性分析是指一些关键性因素如系统生命期长度、系统的工作负荷量、工作负荷的类型与这些不同类型之间的合理搭配、处理速度要求、设备和软件的配置等变化时,对开支和收益的影响最灵敏的范围的估计。在敏感性分析的根底上做出的选择当然会比单一选择的结果要好一些。7. 社会因素方面的可行性 本章用来说明对社会因素方面的可行性分析的结果,包括:7.1 法律方面的可行性 法律方面的可行性问题很多,如合同责任、侵犯专利权、侵犯等方面的陷井,软件人员通常是不熟悉的,有可能陷入,务必要注意研究。 7.2 使用方面的可行性 例如从用户单位的行政管理、工作制度等方面来看,是否能够使用该软件系统;从用户单位的工作人员的素质来看,是否能满足使用该软件系统的要求等等,都是要考虑的。8. 结论在进展可行性研究报告的编制时,必须有一个研究的结论。结论可以是:a. 可以立即开场进展;b. 需要推迟到*些条件例如资金、人力、设备等落实之后才能开场进展;c. 需要对开发目标进展*些修改之后才能开场进展;d. 不能进展或不必进展例如因技术不成熟、经济上不合算等。自国家计算机标准和文件模板附录2 工程开发方案编制工程开发方案的目的是用文件的形式,把对于在开发过程中各项工作的负责人员、开发进度、所需经费预算、所需软、硬件条件等问题做出的安排记载下来,以便根据本方案开展和检查本工程的开发工作。工程开发方案的编制内容要求如下:1. 引言1.1编写目的说明编写这份工程开发方案的目的,并指出预期的读者。1.2背景说明:a. 待开发的软件系统的名称;b. 本工程的任务提出者、开发者、用户及实现该软件的计算中心或计算机网络;c. 该软件系统同其他系统或其他机构的根本的相互来往关系。1.3定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。1.4参考资料列出用得着的参考资料,如:a. 本工程的经核准的方案任务书或合同、上级机关的批文;b. 属于本工程的其他已发表的文件;c. 本文件中各处引用的文件、资料,包括所要用到的软件开发标准。 列出这些文件资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。2. 工程概述2.1工作内容简要地说明在本工程的开发中须进展的各项主要工作。2.2主要参加人员扼要说明参加本工程开发工作的主要人员的情况,包括他们的技术水平。2.3产品程序列出需移交给用户的程序的名称、所用的编程语言及存储程序的媒体形式,并通过引用有关文件,逐项说明其功能和能力。文件列出需移交给用户的每种文件的名称及内容要点。效劳列出需向用户提供的各项效劳,如培训安装、维护和运行支持等,应逐项规定开场日期、所提供支持 的级别和效劳的期限。非移交的产品说明开发集体应向本单位交出但不必向用户移交的产品文件甚至*些程序。2.4验收标准对于上述这些应交出的产品和效劳,逐项说明或引用资料说明验收标准。2.5完成工程的延迟用限2.6本方案的批准者和批准日期3. 实施方案3.1工作任务的分门与人员分工对于工程开发中需完成的各项工作,从需求分析、设计、实现、测试直到维护,包括文件的编制、审批、打印、分发工作,用户培训工作,软件安装工作等,按层次进展分解,指明每项任务的负责人和参加人员。3.2接口人员说明负责接口工作的人员及他们的职责,包括:a. 负责本工程同用户的接口人员;b. 负责本工程同本单位各管理机构,如合同方案管理部门、财务部门、质量管理部门等的接口人员;c. 负责本工程同各分合同负责单位的接口人员等。3.3进度对于需求分析、设计、编码实现、测试、移交、培训和安装等工作,给出每项工作任务的预。定开场日期、完成日期及所需资源,规定各项工作任务完成的先后顺序以及表征每项工作任务完成的标志性事件即所谓里程碑。3.4预算逐项列出本开发工程所需要的劳务包括人员的数量和时间以及经费的预算包括办公费、差旅费、机时费、资料费、通讯设备和专用设备的租金等和来源。3.5关键问题逐项列出能够影响整个工程成败的关键问题、技术难点和风险,指出这些问题对工程的影响。4. 支持条件说明为支持本工程的开发所需要的各种条件和设施。4.1计算机系统支持逐项列出开发中和运行时所需的计算机系统支持,包括计算机、外围设备、通讯设备、模拟器、编译 或 汇编程序、操作系统、数据管理程序包、数据存储能力和测试支持能力等,逐项给出有关到货日期、 使用时间的要求。4.2需由用户承当的工作逐项列出需要用户承当的工作和完成期限。包括需由用户提供的条件及提供时间。4.3由外单位提供的条件逐项列出需要外单位分合同承包者承当的工作和完成的时间,包括需要由外单位提供的条件和提 供的时间。5. 专题方案要点说明本工程开发中需制订的各个专题方案如分合同方案、开发人员培训方案、测试方案、平安* 方案、质量保证方案、配置管理方案、用户培训方案、系统安装方案等的要点。自国家计算机标准和文件模板附录3 软件需求说明书软件需求说明书的编制是为了使用户和软件开发者双方对该软件的初始规定有一个共同的理解,使之成为整个开发工作的根底。软件需求说明书的编制内容要求如下:1.引言1.1编写目的说明编写这份软件需求说明书的目的,指出预期的读者。1.2背景说明:a. 待开发的软件系统的名称;b. 本工程的任务提出者、开发者、用户及实现该软件的计算中心或计算机网络;c. 该软件系统同其他系统或其他机构的根本的相互来往关系。1.3定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。1.4参考资料列出用得着的参考资料,如:a. 本工程的经核准的方案任务书或合同、上级机关的批文;b. 属于本工程的其他已发表的文件;c. 本文件中各处引用的文件、资料、包括所要用到的软件开发标准。 列出这些文件资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。2.任务概述2.1目标表达该项软件开发的意图、应用目标、作用范围以及其他应向读者说明的有关该软件开发的背景材料。解释被开发软件与其他有关软件之间的关系。如果本软件产品是一项独立的软件,而且全部内容自含,则说明这一点。如果所定义的产品是一个更大的系统的一个组成局部,则应说明本产品与该系统中其他各组成局部之间的关系,为此可使用一张方框图来说明该系统的组成和本产品同其他各局部的联系和接口。2.2用户的特点列出本软件的最终用户的特点,充分说明操作人员、维护人员的教育水平和技术专长,以及本软件的预期使甩频度。这些是软件设计工作的重要约束。2.3假定和约束列出进展本软件开发工作的假定和约束,例如经费限制、开发期限等。3.需求规定3.1对功能的规定用列表的方式例如IPO表即输入、处理、输出表的形式,逐项定量和定性地表达对软件所提出的功能要求,说明输入什么量、经怎样的处理、得到什么输出,说明软件应支持的终端数和应支持的并行操作的用户数。3.2对性能的规定精度说明对该软件的输入、输出数据精度的要求,可能包括传输过程中的精度。时间特性要求说明对于该软件的时间特性要求,如对:a. 响应时间;b. 更新处理时间;c. 数据的转换和传送时间;d. 解题时间等的要求。灵活性说明对该软件的灵活性的要求,即当需求发生*些变化时,该软件对这些变化的适应能力,如:a. 操作方式上的变化;b. 运行环境的变化;c. 同其他软件的接口的变化;d. 精度和有效时限的变化;e. 方案的变化或改良。对于为了提供这些灵活性而进展的专门设计的局部应该加以标明。3.3输入输出要求解释各输入输出数据类型,并逐项说明其媒体、格式、数值范围、精度等。对软件的数据输出及必须标明的控制输出量进展解释并举例,包括对硬拷贝报告正常结果输出、状态输出及异常输出以及图形或显示报告的描述。3.4数据管理能力要求说明需要管理的文卷和记录的个数、表和文卷的大小规模,要按可预见的增长对数据及其分量的存储要求做出估算。3.5故障处理要求列出可能的软件、硬件故障以及对各项性能而言所产生的后果和对故障处理的要求。3.6其他专门要求如用户单位对平安*的要求,对使用方便的要求,对可维护性、可补充性、易读性、可靠性、运行环境可转换性的特殊要求等。4.运行环境规定4.1设备列出运行该软件所需要的硬设备。说明其中的新型设备及其专门功能,包括: a. 处理器型号及内在容量;b. 外存容量、联机或脱机、媒体及其存储格式,设备的型号及数量;c. 输入及输出设备的型号和数量,联机或脱机;d. 数据通信设备的型号和数量;e. 功能键及其他专用硬件。4.2支持软件列出支持软件,包括要用到的操作系统、编译或汇编程序、测试支持软件等。4.3接口说明该软件同其他软件之间的接口、数据通信协议等。4.4控制说明控制该软件的运行的方法和控制信号,并说明这些控制信号的来源。自国家计算机标准和文件模板附录4 数据要求说明书数据要求说明书的编制内容要求如下:1. 引言1.1 编写目的说明编写这份数据要求说明书的目的,指出预期的读者。1.2 背景说明:a. 待开发的软件系统的名称;b. 列出本工程的任务提出者、开发者、用户以及将运行该项软件的计算站中心或计算机网络系统。1.3定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。1.4参考资料列出用得着的参考资料,如:a.本工程的经核准的方案任务书或合同、上级机关的批文;b. 属于本工程的其他已发表的文件;c. 本文件中各处引用的文件、资料、包括所要用到的软件开发标准。 列出这些文件资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。2.数据的逻辑描述对数据进展逻辑描述时可把数据分为动态数据和静态数据。所谓静态数据,指在运行过程中主要作 为参考的数据,它们在很长的一段时间内不会变化,一般不随运行而改变。所谓动态数据包括所有在运 行中要发生变化的数据以及在运行中要输入、输出的数据。进展描述时应把各数据元素逻辑地分成假设干 组,列如函数、源数据或对于其应用更为恰当的逻辑分组。给出每一数据元的名称包括缩写和代码、定 义或物理意义度量单位、值域、格式和类型等有关信息。2.1静态数据列出所有作为控制或参考用的静态数据元素。2.2动态输入数据列出动态输入数据元素包括在常规运行中或联机操作中要改变的数据。2.3动态输出数据列出动态输出数据元素包括在常规运行中或联机操作中要改变的数据。2.4 内部生成数据列出向用户或开发单位中的维护调试人员提供的内部生成数据。2.5 数据约定说明对数据要求的制约。逐条列出对进一步扩大或使用方面的考虑而提出的对数据要求的限制容量、文卷、记录和数据元的个数的最大值。对于在设计和开发中确定是临界性的限制更要明确指出。3.数据的采集3.1要求和范围按数据元的逻辑分组来说明数据采集的要求和范围,指明数据的采集方法,说明数据采集工作的承当者是用户还是开发者。具体的内容包括:a. 输入数据的来源,例如是单个操作员、数据输入站,专业的数据输入公司或它们的一个分组;b. 数据输入指把数据输入处理系统内部所用的媒体和硬设备。如果只有指定的输入点的输入才是合法的,则必须对此加以说明;c. 承受者说明输出数据的承受者;d. 输出数据的形式和设备列出输出数据的形式和硬设备。无论承受者将接收到的数据是打印输出,还是CRT上的一组字符、一帧图形,或一声警铃,或向开关线圈提供的一个电脉冲,或常用介质如磁盘、磁带、穿孔卡片等,均应具体说明;e. 数据值的范围给出每一个数据元的合法值的范围;f. 量纲给出数字的度量单位、增量的步长、零点的定标等。在数据是非数字量的情况下,要给出每一种合法值的形式和含意;g. 更新和处理的频度给出预定的对输入数据的更新和处理的频度。如果数据的输入是随机的,应给出更新处理的频度的平均值,或变化情况的*种其他度量。3.2输入的承当者说明预定的对数据输入工作的承当者。如果输入数据同*一接口软件有关,还应说明该接口软件的来源。3.3预处理对数据的采集和预处理过程提出专门的规定,包括适合应用的数据格式、预定的数据通信媒体和对输入的时间要求等。对于需经模拟转换或数字转换处理的数据量,要给出转换方法和转换因子等有关信息,以便软件系统使用这些数据。3.4影响说明这些数据要求对于设备、软件、用户、开发单位所可能产生的影响,例如要求用户单位增设*个机构等。自国家计算机标准和文件模板附录5 概要设计说明书概要设计说明书的编制内容要求如下:1. 引言1.1编写目的说明编写这份概要设计说明书的目的,指出预期的读者。1.2背景说明:a. 待开发的软件系统的名称;b. 列出本工程的任务提出者、开发者、用户以及将运行该项软件的计算站中心。1.3定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。1.4参考资料列出用得着的参考资料,如:a. 本工程的经核准的方案任务书或合同、上级机关的批文;b. 属于本工程的其他已发表的文件;c. 本文件中各处引用的文件、资料、包括所要用到的软件开发标准。 列出这些文件资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。2.总体设计2.1需求规定说明对本系统的主要的输入输出工程、处理的功能性能要求。2.2运行环境简要地说明对本系统的运行环境包括硬件环境和支持环境的规定。2.3根本设计概念和处理流程说明本系统的根本设计概念和处理流程,尽量使用图表的形式。 2.4构造用一览表及框图的形式说明本系统的系统元素各层模块、子程序、公用程序等的划分,扼要说明每个系统元素的标识符和功能,分层次地给出各元素之间的控制与被控制关系。2.5功能要求与程序的关系本条用一张如下的矩阵图说明各项功能需求的实现同各块程序的分配关系。2.6人工处理过程说明在本软件系统的工作过程中不得不包含的人工处理过程如果有的话。2.7尚未解决的问题说明在概要设计过程*未解决而设计者认为在系统完成之前必须解决的各个问题。3.接口设计3.1用户接口说明将向用户提供的命令和它们的语法构造,以及软件的答复信息。3.2外部接口说明本系统同外界的所有接口的安排包括软件与硬件之间的接口、本系统与各支持软件之间的接口关系。3.3内部接口说明本系统之内的各个系统元素之间的接口的安排。4. 运行设计 4.1运行模块组合 说明对系统施加不同的外界运行控制时所引起的各种不同的运行模块组合,说明每种运行所历经的内部模块和支持软件。 4.2运行控制 说明每一种外界的运行控制的方式方法和操作步骤。 4.3运行时间 说明每种运行模块组合将占用各种资源的时间。 5.系统数据构造设计 5.1逻辑构造设计要点 给出本系统内所使用的每个数据构造的名称、标识符以及它们之中每个数据项、记录、文卷和系的标识、定义、长度及它们之间的层次的或表格的相互关系。 5.2物理构造设计要点 给出本系统内所使用的每个数据构造中的每个数据项的存储要求,方法、存取单位、存取的物理关系索引、设备、存储区域、设计考虑和*条件。 5.3数据构造与程序的关系 说明各个数据构造与这些数据构造的形式。 6.系统出错处理设计 6.1出错信息 用一览表的方式说明每种可能的出错或故障情况出现时,系统输出信息的形式、含意及处理方法。 6.2补救措施 说明故障出现后可能采取的变通措施,包括: a. 后备技术说明准备采用的后备技术,当原始系统数据万一丧失时启用的副本的建立和启动的技术,例如周期性地把磁盘信息记录到磁带上去就是对于磁盘媒体的一种后备技术; b. 降效技术说明准备采用的后备技术,使用另一个效率稍低的系统或方法来求得所需结果的*些局部,例如一个自动系统的降效技术可以是手工操作和数据的人工记录; c. 恢复及再启动技术说明将使用的恢复再启动技术,使软件从故障点恢复执行或使软件从头开场重新运行的方法。 6.3系统维护设计 说明为了系统维护的方便而在程序内部设计中做出的安排,包括在程序中专门安排用于系统的检查与维护的检测点和专用模块.自国家计算机标准和文件模板附录6 详细设计说明书详细设计说明书的编制内容要求如下:1. 引言1.1编写目的说明编写这份详细设计说明书的目的,指出预期的读者。1.2背景说明:a. 待开发的软件系统的名称;b. 列出本工程的任务提出者、开发者、用户以及将运行该项软件的计算中心。1.3定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。1.4参考资料列出用得着的参考资料,如:a. 本工程的经核准的方案任务书或合同、上级机关的批文;b. 属于本工程的其他已发表的文件;c. 本文件中各处引用到的文件资料,包括所要用到的软件开发标准。 列出这些文件的标题、文件编号、发表日期和出版单位,说明能够取得这些文件的来源。2.程序系统的构造用一系列图表列出本程序系统内的每个程序包括每个模块和子程序的名称、标识符和它们之间 的层次构造关系。3.程序1标识符设计说明从本章开场,逐个地给出各个层次中的每个程序的设计考虑。以下给出的提纲是针对一般情况的。 对于一个具体的模块,尤其是层次比拟低的模块或子程序,其很多条目的内容往往与它所隶属的上一层 模块的对应条目的内容一样,在这种情况下,只要简单地说明这一点即可。3.1程序描述给出对该程序的简要描述,主要说明安排设计本程序的目的意义,并且,还要说明本程序的特点如是常驻内存还是非常驻?是否子程序?是可重用的还是不可重用的?有无覆盖要求?是顺序处理还是并发处理等。3.2功能说明该程序应具有的功能,可采用IPO图即输入一处理一输出图的形式。3.3性能说明对该程序的全部性能要求,包括对精度、灵活性和时间特性的要求。3.4输入项给出对每一个输入项的特性,包括名称、标识、数据的类型和格式、数据值的有效范围、输入的方式。 数量和频度、输入媒体、输入数据的来源和平安*条件等等。3.5输出项给出对每一个输出项的特性,包括名称、标识、数据的类型和格式,数据值的有效范围,输出的形式、 数量和频度,输出媒体、对输出图形及符号的说明、平安*条件等等。3.6算法详细说明本程序所选用的算法,具体的计算公式和计算步骤。3.7流程逻辑用图表例如流程图、判定表等辅以必要的说明来表示本程序的逻辑流程。 3.8接口用图的形式说明本程序所隶属的上一层模块及隶属于本程序的下一层模块、子程序,说明参数赋值和调用方式,说明与本程序相直接关联的数据构造数据库、数据文卷。3.9存储分配根据需要,说明本程序的存储分配。3.10注释设计说明准备在本程序中安排的注释,如:a. 加在模块首部的注释;b. 加在各分枝点处的注释; 对各变量的功能、范围、缺省条件等所加的注释; c. 对使用的逻辑所加的注释等等。 3.11限制条件说明本程序运行中所受到的限制条件。3.12测试方案说明对本程序进展单体测试的方案,包括对测试的技术要求、输入数据、预期结果、进度安排、人员职责、设备条件驱动程序及桩模块等的规定。3.13尚未解决的问题说明在本程序的设计*未解决而设计者认为在软件完成之前应解决的问题。4. 程序2标识符设计说明 用类似3的方式,说明第2个程序乃至第N个程序的设计考虑。自国家计算机标准和文件模板附录7 数据库设计说明书数据库设计说明书的编制内容要求如下:1. 引言1.1编写目的说明编写这份数据库设计说明书的目的,指出预期的读者。1.2背景说明:a. 说明待开发的数据库的名称和使用此数据库的软件系统的名称;b. 列出该软件系统开发工程的任务提出者、用户以及将安装该软件和这个数据库的计算站中心。 1.3定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。1.4参考资料列出有关的参考资料:a. 本工程的经核准的方案任务书或合同、上级机关的批文;b. 属于本工程的其他已发表的文件;c. 本文件中各处引用到的文件资料,包括所要用到的软件开发标准。 列出这些文件的标题、文件编号、发表日期和出版单位,说明能够取得这些文件的来源。2.外部设计2.1标识符和状态联系用途,详细说明用于唯一地标识该数据库的代码、名称或标识符,附加的描述性信息亦要给出。如果该数据库属于尚在实验中、尚在测试中或是暂时使用的,则要说明这一特点及其有效时间范围。2.2使用它的程序列出将要使用或此数据库的所有应用程序,对于这些应用程序的每一个,给出它的名称和版本号。 2.3约定陈述一个程序员或一个系统分析员为了能使用此数据库而需要了解的建立标号、标识的约定,例如 用于标识数据库的不同版本的约定和用于标识库内各个文卷、记录、数据项的命名约定等。2.4专门指导向准备从事此数据库的生成、从事此数据库的测试、维护人员提供专门的指导,例如将被送入数据 库的数据的格式和标准、送入数据库的操作规程和步骤,用于产生、修改、更新或使用这些数据文卷的操 作指导。 如果这些指导的内容篇幅很长,列出可参阅的文件资料的名称和章条。2.5支持软件简单介绍同此数据库直接有关的支持软件,如数据库管理系统、存储定位程序和用于装入、生成、修改、更新数据库的程序等。说明这些软件的名称、版本号和主要功能特性,如所用数据模型的类型、允许 的数据容量等。列出这些支持软件的技术文件的标题、编号及来源。3.构造设计3.1概念构造设计说明本数据库将反映的现实世界中的实体、属性和它们之间的关系等的原始数据形式,包括各数据项、记录、系、文卷的标识符、定义、类型、度量单位和值域,建立本数据库的每一幅用户视图。 3.2逻辑构造设计说明把上述原始数据进展分解、合并后重新组织起来的数据库全局逻辑构造,包括所确定的关键字和属性、重新确定的记录构造和文卷构造、所建立的各个文卷之间的相互关系,形本钱数据库的数据库管理员视图。 3.3物理构造设计建立系统程序员视图,包括:a. 数据在内存中的安排,包括对索引区、缓冲区的设计;b. 所使用的外存设备及外存空间的组织,包括索引区、数据块的组织与划分;c. 数据的方式方法。4.运用设计 4.1数据字典设计 对数据库设计中涉及到的各种工程,如数据项、记录、系、文卷、模式、子模式等一般要建立起数据字典,以说明它们的标识符、同义名及有关信息。在本节中要说明对此数据字典设计的根本考虑。 4.2平安*设计 说明在数据库的设计中,将如何通过区分不同的者、不同的类型和不同的数据对象,进展分别对待而获得的数据库平安*的设计考虑。自国家计算机标准和文件模板附录8 用户手册用户手册的编制内容要求如下:1. 引言1.1编写目的说明编写这份用户手册的目的,指出预期的读者。1.2背景说明:a. 这份用户手册所描述的软件系统的名称;b. 该软件工程的任务提出者、开发者、用户或首批用户及安装此软件的计算中心。1.3定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。1.4参考资料列出有用的参考资料,如:a. 本工程的经核准的方案任务书或合同、上级机关的批文;b. 属于本工程的其他已发表的文件;c. 本文件中各处引用到的文件资料,包括所要用到的软件开发标准。 列出这些文件的标题、文件编号、发表日期和出版单位,说明能够取得这些文件的来源。2.用途2.1功能结合本软件的开发目的逐项地说明本软件所具有各项功能以及它们的极限范围。2.2性能精度逐项说明对各项输入数据的精度要求和本软件输出数据到达的精度,包括传输中的精度要求。时间特性定量地说明本软件的时间特性,如响应时间,更新处理时间,数据传输、转换时间,计算时间等。灵活性说明本软件所具有的灵活性,即当用户需求如对操作方式、运行环境、结果精度、时间特性等的要求有*些变化时,本软件的适应能力。2.3平安*说明本软件在平安、*方面的设计考虑和实际到达的能力。3.运行环境3.1硬设备列出为运行本软件所要求的硬设备的最小配置,如:a. 处理机的型号、内存容量;b. 所要求的外存储器、媒体、记录格式、设备的型号和台数、联机脱机;c. IO设备联机脱机?; d. 数据传输设备和转换设备的型号、台数。3.2支持软件说明为运行本软件所需要的支持软件,如:a. 操作系统的名称、版本号;b. 程序语言的编译汇编系统的名称和版本号;c. 数据库管理系统的名称和版本号;d. 其他支持软件。3.3数据构造列出为支持本软件的运行所需要的数据库或数据文卷。4.使用过程 在本章,首先用图表的形式说明软件的功能同系统的输入源机构、输出接收机构之间的关系。 4.1安装与初始化 一步一步地说明为使用本软件而需进展的安装与初始化过程,包括程序的存储形式、安装与初始化过程中的全部操作命令、系统对这些命令的反响与答复。表征安装工作完成的测试实例等。如果有的话,还应说明安装过程中所需用到的专用软件。 4.2输入 规定输入数据和参量的准备要求。 输入数据的现实背景 说明输入数据的现实背景,主要是: a. 情况例如人员变动、库存缺货; b. 情况出现的频度例如是周期性的、随机的、一项操作状态的函数; c. 情况来源例如人事部门、仓库管理部门; d. 输入媒体例如键盘、穿孔卡片、磁带; e. 限制出于平安、*考虑而对这些输入数据所加的限制; f. 质量管理例如对输入数据合理性的检验以及当输入数据有错误时应采取的措施,如建立出错情况的记录等; g. 支配例如如何确定输入数据是保存还是废弃,是否要分配给其他的承受者等。 输入格式 说明对初始输入数据和参量的格式要求,包括语法规则和有关约定,如: a. 长度例如字符数行,字符数项; b. 格式基准例如以左面的边沿为基准; c. 标号例如标记或标识符; d. 顺序例如各个数据项的次序及位置; e. 标点例如用来表示行、数据组等的开场或完毕而使用的空格、斜线、星号、字符组等。 f. 词汇表给出允许使用的字符组合的列表,制止使用的字符组合的列表等; g. 省略和重复给出用来表示输人元素可省略或重复的表示方式; h. 控制给出用来表示输入开场或完毕的控制信息。 输入举例 为每个完整的输入形式提供样本,包括: a. 控制或首部例如用来表示输入的种类和类型的信息,标识符输入日期,正文起点和对所用编码的规定; b. 主体输入数据的主体,包括数据文卷的输入表述局部; c. 尾部用来表示输入完毕的控制信息,累计字符总数等; d. 省略指出哪些输入数据是可省略的; e. 重复指出哪些输入数据是重复的。 4.3输出 对每项输出作出说明。 输入数据的现实背景 说明输出数据的现实背景,主要是: a. 使用这些输出数据是给谁的,用来干什么; b. 使用频度例如每周的、定期的或备查阅的; c. 媒体打印、CRT显示、磁带、卡片、磁盘; d. 质量管理例如关于合理性检验、出错纠正的规定; e. 支配例如如何确定输出数据是保存还是废弃,是否要分配给其他承受者等。 输出格式 给出对每一类输出信息的解释,主要是: a. 首部如输出数据的标识符,输出日期和输出编号; b. 主体输出信息的主体,包括分栏标题; c. 尾部包括累计总数,完毕标记。 输出举例 为每种输出类型提供例子。对例子中的每一项,说明: a. 定义每项输出信息的意义和用途; b. 来源是从特定的输入中抽出、从数据库文卷中取出、或从软件的计算过程中得到; c. 特性输出的值域、计量单位、在什么情况下可缺省等。 4.4文卷查询 这一条的编写针对具有查询能力的软件,内容包括:同数据库查询有关的初始化、准备、及处理所需 要的详细规定,说明查询的能力、方式,所使用的命令和所要求的控制规定。 4.5出错处理和恢复 列出由软件产生的出错编码或条件以及应由用户承当的修改纠正工作。指出为了确保再启动和恢复的能力,用户必须遵循的处理过程。4.6终端操作 当软件是在多终端系统上工作时,应编写本条,以说明终端的配置安排、连接步释、数据和参数输入 步骤以及控制规定说明通过终端操作进展查询、检索、修改数据文卷的能力、语言、过程以及辅助性程 序等。自标准化信息网附录9 操作手册操作手册的编制内容要求如下:1. 引言1.1编写目的说明编写这份操作手册的目的,指出预期的读者。1.2背景说明:a. 这份操作手册所描述的软件系统的名称;b. 该软件工程的任务提出者、开发者、用户或首批用户及安装该软件的计算中心。1.3定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。1.4参考资料列出有用的参考资料,如:a. 本工程的经核准的方案任务书或合同、上级机关的批文;b. 属于本工程的其他已发表的文件;c. 本文件中各处引用到的文件资料,包括所要用到的软件开发标准。 列出这些文件的标题、文件编号、发表日期和出版单位,说明能够取得这些文件的来源。2.软件征述2.1软件的构造结合软件系统所具有的功能包括输入、处理和输出提供该软件的总体构造图表。 2.2程序表列出本系统内每个程序的标识符、编号和助记名。2.3文卷表列出将由本系统引用、建立或更新的每个永久性文卷,说明它们各自的标识符、编号、助记名、存储 媒体和存储要求。 3.安装与初始化一步一步地说明为使用本软件而需要进展的安装与初始化过程,包括程序的存载形式,安装与初始 化过程中的全部操作命令,系统对这些命令的反响与答复,表征安装工作完成的测试实例等。如果有的 话,还应说明安装过程中所需用到的专用软件。4.运行说明 所谓一个运行是指提供一个启动控制信息后,直到计算机系统等待另一个启动控制信息时为止的 计算机系统执行的全部过程。 4.1运行表 列出每种可能的运行,摘要说明每个运行的目的,指出每个运行各自所执行的程序。 4.2运行步骤 说明从一个运行转向另一个运行以完成整个系统运行的步骤。 4.3运行1标识符说明 把运行1的有关信息,以对操作人员为最方便最有用的形式加以说明。 运行控制 列出为本运行所需要的运行流向控制的说明。 操作信息 给出为操作中心的操作人员和管理人员所需要的信息,如: a. 运行目的; b. 操作要求; c. 启动方法,如应请启动由所遇到的请求信息启动、预定时间启动、等; d. 预计的运行时间和解题时间;操作命令; f. 与运行有联系的其他事项。 输入输出文卷 提供被本运行建立、更新或的数据文卷的有关信息,如: a. 文卷的标识符或标号; b. 记录媒体; c. 存留的目录表; d. 文卷的支配如确定保存或废弃的准则、是否要分配给其他承受者、占用硬设备的优先级以及*控制等有关规定。 输出文段 提供本软件输出的每一个用于提示、说明、或应答的文段包括菜单的有关信息,如: a. 文段的标识符; b. 输出媒体屏幕显示、打印、; c. 文字容量; d. 分发对象; e. *要求。 输出文段的复制 对由计算机产生,而后需用其他方法复制的那些文段提供有关信息,如: a. 文段的标识符; b. 复制的技术手段; c. 纸张或其他媒体的规格; d. 装订要求; e. 分发对象; f. 复制人数。 恢复过程 说明本运行故障后的恢复过程。 4.4运行2标识符说明 用与本手册4.3条相类似的方式介绍另一个运行的有关信息。 5.非常规过程 提供有关应急操作或非常规操作的必要信息,如出错处理操作、向后备系统的切换操作以及其他必 须向程序维护人员交待的事项和步骤。 6.远程操作 如果本软件能够通过远程终端控制运行,则在本章说明通过远程终端运行本软件的操作过程。自标准化信息网附录10 模块开发卷宗模块开发卷宗的编制内容要求如下:1. 标题软件系统名称和标识符 模块名称和标识符如果本卷宗包含多于一个的模块,则用这组模块的功能标识代替模块名程序编制员签名卷宗的修改文本序号修改完成日期 卷宗序号说明本卷宗在整个卷宗中的序号编排日期说明整个卷宗最近的一次编排日期2. 模块开发情况表3. 功能说明扼要说明本模块或本组模块的功能,主要是输入、要求的处理、输出。可以从系统设计说明书中摘录。同时列出在软件需求说明书中对这些功能的说明的章、条、款。4. 设计说明 说明本模块或本组模块的设计考虑,包括: a. 在系统设计说明书中有关对本模块或本组模块设计考虑的表达,包括本模块在软件系统中所处的层次,它同其他模块的接口; b. 在程序设计说明书中有关对本模块或本组模块的设计考虑,包括本模块的算法、处理流程、牵涉到的数据文卷设计限制、驱动方式和出错信息等; c. 在编制目前已通过全部测试的源代码时实际使用的设计考虑。 5. 原代码清单 要给出所产生的本模块或本组模块的第一份无语法错的源代码清单以及已通过全部测试的当前有效的源代码清单。 6. 测试说明 说明直接要经过本模块或本组模块的每一项测试,包括这些测试各自的标识符和编号、进展这些测试的目的、所用的配置和输入、预期的输出及实际的输出。 7. 复审的结论 把实际测试的结果,同软件需求说明书、系统设计说明书、程序设计说明书中规定的要求进展比拟和给出结论。自国家计算机标准和文件模板附录11 测试方案测试方案的编制内容要求如下:1. 引言1.1 编写目的本测试方案的具体编写目的,指出预期的读者范围。1.2 背景说明:a. 测试方案所附属的软件系统的名称; b. 该开发工程的历史,列出用户和执行此工程测试的计算中心,说明在开场执行本测试方案之前必须完成的各项工作。1.3 定义列出本文件中用到的专门术语的定义和外文首字母组词的原词组。1.4 参考资料列出要用到的参考资料,如:a. 本工程的经核准的方案任务书或合同、上级机关的批文;b. 属于本工程的其他已发表的文件;2. 方案2.1 软件说明提供一份图表,并逐项说明被测软件的功能、输入和输出等质量指标,作为表达测试方案的提纲。2.2 测试内容列出组装测试和确认测试中的每一项测试内容的名称标识符、这些测试的进度安排以及这些测试的内容和目的,例如模块功能测试、接口正确性测试、数据文卷存取的测试、运行时间的测试、设计约束和极限的测试等。2.3 测试1标识符给出这项测试内容的参与单位及被测试的部位。 进度安排给出对这项测试的进度安排,包括进展测试的日期和工作内容如熟悉环境。培训、准备输入数据等。 条件陈述本项测试工作对资源的要求,包括: a. 设备所用到的设备类型、数量和预定使用时间;b. 软件列出将被用来支持本项测试过程而本身又并不是被测软件的组成局部的软件,如测试驱动程序、测试监控程序、仿真程序、桩模块等等; c. 人员列出在测试工作期间预期可由用户和开发任务组提供的工作人员的人数。技术水平及有关的预备知识,包括一些特殊要求,如倒班操作和数据键入人员。 测试资料列出本项测试所需的资料,如:a. 有关本项任务的文件;b. 被测试程序及其所在的媒体;c. 测试的输入和输出举例;d. 有关控制此项测试的方法、过程的图表。 测试培训说明或引用资料说明为被测软件的使用提供培训的方案。规定培训的内容、受训的人员及从事培训的工作人员。2.4 测试2标识符用与本测试方案2.3条相类似的方式,说明用于另一项及其后各项测试内容的测试工作方案。3. 测试设计说明3.1 测试1标识符说明对第一项测试内容的测试设计考虑。 控制说明本测试的控制方式,如输入是人工、半自动或自动引入、控制操作的顺序以及结果的记录方法。 输入说明本项测试中所使用的输入数据及选择这些输入数据的策略。 输出说明预期的输出数据,如测试结果及可能产生的中间结果或运行信息。 过程说明完成此项测试的一个个步骤和控制命令,包括测试的准备、初始化、中间步聚和运行完毕方式。 3.2 测试2标识符用与本测试方案3.l条相类似的方式,说明第2项及其后各项测试工作的设计考虑。4. 评价准则 4.1 范围 说明所选择的测试用例能够接查的范围及其局限性。 4.2 数据整理 陈述为了把测试数据加工成便于评价的适当形式,使得测试结果可以同,结果进展比拟而要用到的转换处理技术,如手工方式或自动方式;如果是用自动方式整理数据,还要说明为进展处理而要用到的硬件、软件资源。 4
展开阅读全文
相关资源
正为您匹配相似的精品文档
相关搜索

最新文档


当前位置:首页 > 压缩资料 > 基础医学


copyright@ 2023-2025  zhuangpeitu.com 装配图网版权所有   联系电话:18123376007

备案号:ICP2024067431-1 川公网安备51140202000466号


本站为文档C2C交易模式,即用户上传的文档直接被用户下载,本站只是中间服务平台,本站所有文档下载所得的收益归上传人(含作者)所有。装配图网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对上载内容本身不做任何修改或编辑。若文档所含内容侵犯了您的版权或隐私,请立即通知装配图网,我们立即给予删除!