软件设计国家标准文档.docx
- 文档编号:4404884
- 上传时间:2022-12-01
- 格式:DOCX
- 页数:43
- 大小:40.76KB
软件设计国家标准文档.docx
《软件设计国家标准文档.docx》由会员分享,可在线阅读,更多相关《软件设计国家标准文档.docx(43页珍藏版)》请在冰豆网上搜索。
软件设计国家标准文档
操作手册〔GB8567——88〕
1引言
编写目的
说明编写这份操作手册的目的,指出预期的读者。
前景
说明:
a. 这份操作手册所描述的软件系统的名称;
b. 该软件项目的任务提出者、开发者、用户〔或首批用户〕及安装该软件的计算中心。
定义
列出本文件中用到的专门术语的定义和外文首字母组词的原词组。
参考资料
列出有用的参考资料,如:
a. 本项目的经核准的计划任务书或合同、上级机关的批文;
b. 属于本项目的其他已发表的文件;
c. 本文件中各处引用的文件、资料,包括所列出的这些文件资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。
2软件征述
软件的结构
结合软件系统所具有的功能包括输入、处理和输出提供该软件的总体结构图表。
程序表
列出本系统内每个程序的标识符、编号和助记名。
文卷表
列出将由本系统引用、建立或更新的每个永久性文卷,说明它们各自的标识符、编号、助记名、存储媒体和存储要求。
3安装与初始化
一步一步地说明为使用本软件而需要进行的安装与初始化过程,包括程序的存载形式,安装与初始化过程中的全部操作命令,系统对这些命令的反应与答复,表征安装工作完成的测试实例等。
如果有的话,还应说明安装过程中所需用到的专用软件。
4运行说明
所谓一个运行是指提供一个启动控制信息后,直到电脑系统等待另一个启动控制信息时为止的电脑系统执行的全部过程。
运行表
列出每种可能的运行,摘要说明每个运行的目的,指出每个运行各自所执行的程序。
运行步骤
说明从一个运行转向另一个运行以完成整个系统运行的步骤。
运行1〔标识符〕说明
把运行1的有关信息,以对操作人员为最方便最有用的形式加以说明。
运行控制
列出为本运行所需要”的运行流向控制的说明。
操作信息
给出为操作中心的操作人员和管理人员所需要的信息,如:
a. 运行目的;
b. 操作要求;
c. 启动方法如应请启动〔由所遇到的请求信息启动〕、预定时间启动、…,··等;
d. 预计的运行时间和解题时间;
e. 操作命令;
f. 与运行有联系的其他事项。
输入一输出文卷
提供被本运行建立、更新或访问的数据文卷的有关信息,如:
a. 文卷的标识符或标号;
b. 记录媒体;
c. 存留的目录表;
d. 文卷的支配如确定保留或废弃的准则、是否要分配给其他接受者、占用硬设备的优先级以及保密控制等有关规定。
输出文段
提供本软件输出的每一一个用于提示、说明、或应答的文段〔包括“菜单”〕的有关信息,如:
a. 文段的标识符;
b. 输出媒体〔屏幕显示、打印、……〕;
c. 文字容量;
d. 分发对象;
e. 保密要求。
输出文段的复制
对由电脑产生,而后需用其他方法复制的那些文段提供有关信息,如:
a.文段的标识符;
b.复制的技术手段;
c.纸张或其他媒体的规格;
d.装订要求;
e.分发对象;
f. 复制份数。
恢复过程
说明本运行故障后的恢复过程。
运行2〔标识符〕说明
用与本手册条相类似的方式介绍另一个运行的有关信息。
5非常规过程
提供有关应急操作或非常规操作的必要信息,如出错处理操作、向后备系统的切换操作以及其他必须向程序维护人员交待的事项和步骤。
6远程操作
如果本软件能够通过远程终端控制运行,则在本章说明通过远程终端运行本软件的操作过程。
测试分析报告〔GB8567——88〕
1引言
编写目的
说明这份测试分析报告的具体编写目的,指出预期的阅读范围。
背景
说明:
a. 被测试软件系统的名称;
b. 该软件的任务提出者、开发者、用户及安装此软件的计算中心,指出测试环境与实际运行环境之间可能存在的差异以及这些差异对测试结果的影响。
定义
列出本文件中用到的专问术语的定义和外文首字母组词的原词组。
参考资料
列出要用到的参考资料,如:
a.本项目的经核准的计划任务书或合同、上级机关的批文;
b.属于本项目的其他已发表的文件;
c.本文件中各处引用的文件、资料,包括所要用到的软件开发标准。
列出这些文件的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。
2测试概要
用表格的形式列出每一项测试的标识符及其测试内容,并指明实际进行的测试工作内容与测试计划中预先设计的内容之间的差异,说明作出这种改变的原因。
3测试结果及发现
测试1〔标识符〕
把本项测试中实际得到的动态输出〔包括内部生成数据输出〕结果同对于动态输出的要求进行比较,陈述其中的各项发现。
测试2〔标识符〕
用类似本报告条的方式给出第2项及其后各项测试内容的测试结果和发现。
4对软件功能的结论
功能1〔标识符〕
能力
简述该项功能,说明为满足此项功能而设计的软件能力以及经过一项或多项测试已证实的能力。
限制
说明测试数据值的范围〔包括动态数据和静态数据〕,列出就这项功能而言,测试期间在该软件中查出的缺陷、局限性。
功能2〔标识符〕
用类似本报告的方式给出第2项及其后各项功能的测试结论。
....
5分析摘要
能力
陈述经测试证实了的本软件的能力。
如果所进行的测试是为了验证一项或几项特定性能要求的实现,应提供这方面的测试结果与要求之间的比较,并确定测试环境与实际运行环境之间可能存在的差异对能力的测试所带来的影响。
缺陷和限制
陈述经测试证实的软件缺陷和限制,说明每项缺陷和限制对软件性能的影响,并说明全部测得的性能缺陷的累积影响和总影响。
建议
对每项缺陷提出改良建议,如:
a.各项修改可采用的修改方法;
b.各项修改的紧迫程度;
c.各项修改预计的工作量;
d.各项修改的负责人。
评价
说明该项软件的开发是否已到达预定目标,能否交付使用。
6测试资源消耗
总结测试工作的资源消耗数据,如工作人员的水平级别数量、机时消耗等。
测试计划〔GB8567——88〕
1引言
编写目的
本测试计划的具体编写目的,指出预期的读者范围。
背景
说明:
a.测试计划所从属的软件系统的名称;
b.该开发项目的历史,列出用户和执行此项目测试的计算中心,说明在开始执行本测试计划之前必须完成的各项工作。
定义
列出本文件中用到的专门术语的定义和外文首字母组词的原词组。
参考资料
列出要用到的参考资料,如:
a.本项目的经核准的计划任务书或合同、上级机关的批文;
b.属于本项目的其他已发表的文件;
c.本文件中各处引用的文件、资料,包括所要用到的软件开发标准。
列出这些文件的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。
2计划
软件说明
提供一份图表,并逐项说明被测软件的功能、输入和输出等质量指标,作为表达测试计划的提纲。
测试内容
列出组装测试和确认测试中的每一项测试内容的名称标识符、这些测试的进度安排以及这些测试的内容和目的,例如模块功能测试、接口正确性测试、数据文卷存取的测试、运行时间的测试、设计约束和极限的测试等。
测试1〔标识符〕
给出这项测试内容的参与单位及被测试的部位。
进度安排
给出对这项测试的进度安排,包括进行测试的日期和工作内容〔如熟悉环境。
培训、准备输入数据等〕。
条件
陈述本项测试工作对资源的要求,包括:
a. 设备所用到的设备类型、数量和预定使用时间;
b. 软件列出将被用来支持本项测试过程而本身又并不是被测软件的组成部分的软件,如测试驱动程序、测试监控程序、仿真程序、桩模块等等;
c. 人员列出在测试工作期间预期可由用户和开发任务组提供的工作人员的人数。
技术水平及有关的预备知识,包括一些特殊要求,如倒班操作和数据键入人员。
测试资料
列出本项测试所需的资料,如:
a. 有关本项任务的文件;
b. 被测试程序及其所在的媒体;
c. 测试的输入和输出举例;
d. 有关控制此项测试的方法、过程的图表。
测试培训
说明或引用资料说明为被测软件的使用提供培训的计划。
规定培训的内容、受训的人员及从事培训的工作人员。
测试2〔标识符〕
用与本测试计划条相类似的方式说明用于另一项及其后各项测试内容的测试工作计划。
3测试设计说明
测试1〔标识符〕
说明对第一项测试内容的测试设计考虑。
控制
说明本测试的控制方式,如输入是人工、半自动或自动引入、控制操作的顺序以及结果的记录方法。
输入
说明本项测试中所使用的输入数据及选择这些输入数据的策略。
输出
说明预期的输出数据,如测试结果及可能产生的中间结果或运行信息。
过程
说明完成此项测试的一个个步骤和控制命令,包括测试的准备、初始化、中间步聚和运行结束方式。
测试2〔标识符〕
用与本测试计划条相类似的方式说明第2项及其后各项测试工作的设计考虑。
4评价准则
范围
说明所选择的测试用例能够接查的范围及其局限性。
数据整理
陈述为了把测试数据加工成便于评价的适当形式,使得测试结果可以同,已知结果进行比较而要用到的转换处理技术,如手工方式或自动方式;如果是用自动方式整理数据,还要说明为进行处理而要用到的硬件、软件资源。
尺度
说明用来判断测试工作是否能通过的评价尺度,如合理的输出结果的类型、测试输出结果与预期输出之间的容许偏离范围、允许中断或停机的最大次数。
概要设计说明书〔GB8567——88〕
1引言
编写目的
说明编写这份概要设计说明书的目的,指出预期的读者。
背景
说明:
a. 待开发软件系统的名称;
b. 列出此项目的任务提出者、开发者、用户以及将运行该软件的计算站〔中心〕。
定义
列出本文件中用到的专门术语的定义和外文首字母组词的原词组。
参考资料
列出有关的参考文件,如:
a.本项目的经核准的计划任务书或合同,上级机关的批文;
b.属于本项目的其他已发表文件;
c.本文件中各处引用的文件、资料,包括所要用到的软件开发标准。
列出这些文件的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。
2总体设计
需求规定
说明对本系统的主要的输入输出项目、处理的功能性能要求,详细的说明可参见附录C。
运行环境
简要地说明对本系统的运行环境〔包括硬件环境和支持环境〕的规定,详细说明参见附录C。
基本设计概念和处理流程
说明本系统的基本设计概念和处理流程,尽量使用图表的形式。
结构
用一览表及框图的形式说明本系统的系统元素〔各层模块、子程序、公用程序等〕的划分,扼要说明每个系统元素的标识符和功能,分层次地给出各元素之间的控制与被控制关系.
功能器求与程序的关系
本条用一张如下的矩阵图说明各项功能需求的实现同各块程序的分配关系:
程序1
程序2
……
程序n
功能需求1
√
功能需求2
√
……
功能需求n
√
√
人工处理过程
说明在本软件系统的工作过程中不得不包含的人工处理过程〔如果有的话〕。
尚未问决的问题
说明在概要设计过程中尚未解决而设计者认为在系统完成之前必须解决的各个问题。
3接口设计
用户接口
说明将向用户提供的命令和它们的语法结构,以及软件的答复信息。
外部接口
说明本系统同外界的所有接口的安排包括软件与硬件之间的接口、本系统与各支持软件之间的接口关系。
内部接口
说明本系统之内的各个系统元素之间的接口的安排。
4运行设计
运行模块组合
说明对系统施加不同的外界运行控制时所引起的各种不同的运行模块组合,说明每种运行所历经的内部模块和支持软件。
运行控制
说明每一种外界的运行控制的方式方法和操作步骤。
运行时间
说明每种运行模块组合将占用各种资源的时间。
5系统数据结构设计
逻辑结构设计要点
给出本系统内所使用的每个数据结构的名称、标识符以及它们之中每个数据项、记录、文卷和系的标识、定义、长度及它们之间的层次的或表格的相互关系。
物理结构设计要点
给出本系统内所使用的每个数据结构中的每个数据项的存储要求,访问方法、存取单位、存取的物理关系〔索引、设备、存储区域〕、设计考虑和保密条件。
数据结构与程序的关系
说明各个数据结构与访问这些数据结构的形式:
6系统出错处理设计
出错信息
用一览表的方式说朗每种可能的出错或故障情况出现时,系统输出信息的形式、含意及处理方法。
补救措施
说明故障出现后可能采取的变通措施,包括:
a. 后备技术说明准备采用的后备技术,当原始系统数据万一丧失时启用的副本的建立和启动的技术,例如周期性地把磁盘信息记录到磁带上去就是对于磁盘媒体的一种后备技术;
b. 降效技术说明准备采用的后备技术,使用另一个效率稍低的系统或方法来求得所需结果的某些部分,例如一个自动系统的降效技术可以是手工操作和数据的人工记录;
c. 恢复及再启动技术说明将使用的恢复再启动技术,使软件从故障点恢复执行或使软件从头开始重新运行的方法。
系统维护设计
说明为了系统维护的方便而在程序内部设计中作出的安排,包括在程序中专门安排用于系统的检查与维护的检测点和专用模块。
各个程序之间的对应关系,可采用如下的矩阵图的形式;
开发进度月报〔GB8567——88〕
1、标题
开发中的软件系统的名称和标识符
分项目名称和标识符
分项目负责人签名
本期月报编写人签名
本期月报的编号及所报告的年月
2、工程进度与状态
进度
列出本月内进行的各项主要活动,并且说明本月内遇到的重要事件,这里所说的重要事件是指一个开发阶段〔即软件生存周期内各个阶段中的某一个,例如需求分析阶段〕的开始或结束,要说明阶段名称及开始〔或结束〕的日期。
状态
说明本月的实际工作进度与计划相比,是提前了、按期完成了、或是推迟了?
如果与计划不一致,说明原因及准备采取的措施。
3资额耗用与状态
资额耗用
主要说明本月份内耗用的工时与机时。
工时
分为三类:
a. 管理用工时包括在项目管理〔制订计划、布置工作、收集数据、检查汇报工作等〕方面耗用的工时;
b. 服务工时包括为支持项目开发所必须的服务工作及非直接的开发工作所耗用的工时;
c. 开发用工时要分各个开发阶段填写。
机时
说明本月内耗用的机时,以小时为单位,说明电脑系统的型号。
状态
说明本月内实际耗用的资源与计划相比,是超出了、相一致、还是不到计划数?
如果与计划不一致,说明原因及准备采取的措施。
4经费支出与状态
经费支出
支持性费用
列出本月内支出的支持性费用,一般可按如下七类列出,并给出本月支持费用的总和:
a.房租或房屋折旧费;
b.社工资、奖金、补贴;
c.培训费包括给教师的酬金及教室租金;
d.资料费包括复印及购买参考资料的费用;
e.会议费召集有关业务会议的费用;
f. 旅差费;
g.其他费用。
设备购置费
列出本月内支出的设备购置费,一般可分如下三类:
a.购买软件的名称与金额;
b.购买硬设备的名称、型号、数量及金额;
c.已有硬设备的折旧费。
状态
说明本月内实际支出的经费与计划相比较,是超过了。
相符合、还是不到计划数?
如果与计划不一致,说明原因及准备采取的措施。
5下个月的工作计划
6建议
本月遇到的重要问题和应引起重视的问题以及因此产生的建议。
可行性研究报告GB8567——88
1引言
编写目的
说明编写本可行性研究报告的目的,指出预期的读者。
背景
说明:
A. 所建议开发的软件系统的名称;
B. 本项目的任务提出者、开发者、用户及实现该软件的计算中心或电脑网络;
C.该软件系统同其他系统或其他机构的基本的相互来往关系。
定义
列出本文件中用到的专门术语的定义和外文首字母组词的原词组。
参考资料
列出用得着的参考资料,如:
1. 本项目的经核准的计划任务书或合同、上级机关的批文;
2. 属于本项目的其他已发表的文件;
3. 本文件中各处引用的文件、资料,包括所需用到的软件开发标准。
列出这些文件资料的标题、文件编号、发表日期和出版单位,说明能够得到这些文件资料的来源。
2、可行性研究的前提
说明对所建议的开发项目进行可行性研究的前提,如要求、目标、假定、限制等。
要求
说明对所建议开发的软件的基本要求,如:
A. 功能;
B. 性能;
C. 输出如报告、文件或数据,对每项输出要说明其特征,如用途、产生频度、接口以及分发对象;
D. 输入说明系统的输入,包括数据的来源、类型、数量、数据的组织以及提供的频度;
E. 处理流程和数据流程用图表的方式表示出最基本的数据流程和处理流程辅之以表达;
F. 在安全与保密方面的要求;
G. 同本系统相连接的其他系统;
H. 完成期限。
目标
说明所建议系统的主要开发目标,如:
A. 人力与设备费用的减少;
B. 处理速度的提高;
C. 控制精度或生产能力的提高;
D. 管理信息服务的改良;
E. 自动决策系统的改良;
F. 人员利用率的改良。
条件、假定和限制
说明对这项开发中给出的条件、假定和所受到的限制,如:
a.所建议系统的运行寿命的最小值;
b.进行系统方案选择比较的时间;
c.经费、投资方面的来源和限制;
d.法律和政策方面的限制;
e.硬件、软件、运行环境和开发环境方面的条件和限制;
f. 可利用的信息和资源;
g.系统投入使用的最晚时间。
进行可行性研究的方法
说明这项可行性研究将是如何进行的,所建议的系统将是如何评价的。
摘要说明所使用的基本方法和策略,如调查、加权、确定模型、建立基准点或仿真等。
评价尺度
说明对系统进行评价时所使用的主要尺度,如费用的多少、各项功能的优先次序、开发时间的长短及使用中的难易程度。
3对现有系统的分析
这里的现有系统是指当前实际使用的系统,这个系统可能是电脑系统,也可能是一个机械系统甚至是一个人工系统。
分析现有系统的目的是为了进一步阐明建议中的开发新系统或修改现有系统的必要性。
处理流程和数据流程
说明现有系统的基本的处理流程和数据流程。
此流程可用图表即流程图的形式表示,并加以表达。
工作负荷
列出现有系统所承担的工作及工作量。
费用开支
列出由于运行现有系统所引起的费用开支,如人力、设备、空间、支持性服务、材料等项开支以及开支总额。
人员
列出为了现有系统的运行和维护所需要的人员的专业技术类别和数量。
设备
列出现有系统所使用的各种设备。
局限性
列出本系统的主要的局限性,例如处理时间赶不上需要,响应不及时,数据存储能力不足,处理功能不够等。
并且要说明,为什么对现有系统的改良性维护已经不能解决问题。
4所建议的系统
本章将用来说明所建议系统的目标和要求将如何被满足。
对所建议系统的说明
概括地说明所建议系统,并说明在第2章中列出的那些要求将如何得到满足,说明所使用的基本方法及理论根据。
处理流程和数据流程
给出所建议系统的处理流程和数据流程。
改良之处
按条中列出的目标,逐项说明所建议系统相对于现存系统具有的改良。
影响
说明在建立所建议系统时,预期将带来的影响,包括:
对设备的影响
说明新提出的设备要求及对现存系统中尚可使用的设备须作出的修改。
对软件的影响
说明为了使现存的应用软件和支持软件能够同所建议系统相适应。
而需要对这些软件所进行的修改和补充。
对用户单位机构的影响
说明为了建立和运行所建议系统,对用户单位机构、人员的数量和技术水平等方面的全部要求。
对系统运行过程的影响
说明所建议系统对运行过程的影响,如:
a.用户的操作规程;
b.运行中心的操作规程;
c.运行中心与用户之间的关系;
d.源数据的处理;
e.数据进入系统的过程;
f. 对数据保存的要求,对数据存储、恢复的处理;
g.输出报告的处理过程、存储媒体和调度方法;
h.系统失效的后果及恢复的处理方法。
对开发的影响
说明对开发的影响,如:
a. 为了支持所建议系统的开发,用户需进行的工作;
b. 为了建立一个数据库所要求的数据资源;
c. 为了开发和测验所建议系统而需要的电脑资源;
d. 所涉及的保密与安全问题。
对地点和设施的影响
说明对建筑物改造的要求及对环境设施的要求。
对经费开支的影响
扼要说明为了所建议系统的开发,设计和维持运行而需要的各项经费开支。
局限性
说明所建议系统尚存在的局限性以及这些问题未能消除的原因。
技术条件方面的可行性
本节应说明技术条件方面的可行性,如:
a.在当前的限制条件下,该系统的功能目标能否到达;
b.利用现有的技术,该系统的功能能否实现;
c.对开发人员的数量和质量的要求并说明这些要求能否满足;
d.在规定的期限内,本系统的开发能否完成。
5可选择的其他系统方案
扼要说明曾考虑过的每一种可选择的系统方案,包括需开发的和可从国内国外直接购买的,如果没有供选择的系统方案可考虑,则说明这一点。
可选择的系统方案1
参照第4章的提纲,说明可选择的系统方案1,并说明它未被选中的理由。
可选择的系统方案2
按类似条的方式说明第2个乃至第n个可选择的系统方案。
......
6投资及效益分析
支出
对于所选择的方案,说明所需的费用。
如果已有一个现存系统,则包括该系统继续运行期间所需的费用。
基本建设投资
包括采购、开发和安装以下各项所需的费用,如:
a. 房屋和设施;
b. ADP设备;
c. 数据通讯设备;
d. 环境保护设备;
e. 安全与保密设备;
f. ADP操作系统的和应用的软件;
g. 数据库管理软件。
其他一次性支出
包括以下各项所需的费用,如:
a.研究〔需求的研究和设计的研究〕;
b.开发计划与测量基准的研究;
c.数据库的建立;
d.ADP软件的转换;
e.检查费用和技术管理性费用;
f. 培训费、旅差费以及开发安装人员所需要的一次性支出;
g.人员的退休及调动费用等。
非一次性支出
列出在该系统生命期内按月或按季或按年支出的用于运行和维护的费用,包括:
a.设备的租金和维护费用;
b.软件的租金和维护费用;
c.数据通讯方面的租金和维护费用;
d.人员的工资、奖金;
e.房屋、空间的使用开支;
f. 公用设施方面的开支;
g.保密安全方面的开支;
h.其他经常性的支出等。
收益
对于所选择的方案,说明能够带来的收益,这里所说的收益,表现为开支费用的减少或防止、过失的减少、灵活性的增加、动作速度的提高和管理计划方面的改良等,包括;
一次性收益
说明能够用人民币数目表示的一次性收益,可按数据处理、用户、管理和支持等项分类表达,如:
a.开支的缩减包括改良了的系统的运行所引起的开支缩减,如资源要求的减少,运行效率的改良,数据进入、存贮和恢复技术的改良,系统性能的可监控,软件的转换和优化,数据压缩技术的采用,处理的集中化/分布化等;
b.价值的增升包括由于一个应用系统的使用价值的增升所引起的收益,如资源利用的改良,管理和运行效率的改良以及出错率的减少等;
c.其他如从多余设备出售回收的收入等。
非一次性收益
说明在整个系统生命期内由于运行所建议系统而导致的按月的、按年的能用人民币数目表示的收益,包括开支的减少和防止。
不可定量的收益
逐项列出无法直接用人民币表示的收益,如服务的改良,由操作失误引起的风险的减少,信息掌握情况的改良,组织机构给外界形象的改善等。
有些不
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 软件设计 国家标准 文档