软件开发文档编程序DOC.docx
《软件开发文档编程序DOC.docx》由会员分享,可在线阅读,更多相关《软件开发文档编程序DOC.docx(33页珍藏版)》请在冰豆网上搜索。
软件开发文档编程序DOC
软件开发文档编程序(DOC)
————————————————————————————————作者:
————————————————————————————————日期:
l范围
本标准规定了软件产品开发研制过程质量职责及控制要求。
本标准适用于本公司研制的计算机各类型软件的管理。
2引用标准
GB8567—88计算机软件产品开发文件编制指南
3定义
不需用。
4职责
4.1设计部门负责人批准软件开发项目任务书。
4.2技术发展部负责组织对公司下达的软件项目进行各阶段的评审。
4.3物流部经理负责组织项目的最终检测。
4.4项目负责人负责组织对软件项目的各阶段进行考核、质量控制、组织接口协调文档的发布批准及文档更改审批。
4.5项目负责人(软件负责人)负责:
a、制定软件课题开发计划和进度安排及资源需求;
b、进行总体设计;
c、提供阶段评审资料;
d、协调技术接口。
4.6标准档案室管理员负责文档的存贮、保管和处理。
5工作程序与要求
5.1公司下达的软件项目立项后,由技术发展部下达[新产品研制任务书]。
5.2软件项目
5.2.1公司立项项目由技术发展部负责组织评审。
a、项目负责人(软件负责人)于评审前3天填写[评审申请表],并备齐评审资料,交技术发展部。
b、技术发展部审批评审申请表,并将有关资料提前3-5天下发评审组成员以供分工审阅,
c、评审组长主持评审会,并填写[评审报告];评审结束,技术发展部负责收回评审资料交项目组存档。
5.2.2凡上级下达的项目,若上级部门(或系统组织单位)对评审另有要求时,则按其执行;否则,按5.2.1条执行。
5.2.4若项目既有软件开发,又有硬件开发,其评审是分开(软件、硬件)还是合并进行,由设计部门负责人决定。
5.3软件项目的检测
5.3.1项目负责人负责组织完成下述工作。
a、测试阶段的检测;
b、软件课题的系统检测;
c、软件版本存档前的检测。
对以上测试发现的问题,由项目组填写[软件测试修改单],经分析原因和采取纠正措施及回归测试后,由项目负责人审批,方可列入正式版本。
5.3.2物流部经理负责组织软件版本存档前的最终检测,并在[版本送检(启用)通知单]上签署检测结果。
5.4设计部门负责人批准软件项目开发计划。
5.5设计部门负责人审批各项目负责人资格,并负责:
a、考核各阶段的进度完成情况;
b、及时协调开发中组织接口及计划修改;
c、控制项目开发各阶段的设计输入、设计输出、技术状态和各阶段的验
证,并对软件的正确性、文档的完整性负责。
5.6项目负责人(软件负责人)负责组织:
a、制定项目开发计划,若软件、硬件相结合的,其计划也可合并制定。
开发计划须明确划分各开发阶段,并可按开发阶段进行自主开发;
b、总体设计;
c、提供各阶段文档(包括评审文档),并于鉴定后一周内存入标准档案室;
d、组织软件(版本)检测,并对检测结果负责;
e、协调技术接口;
f、定期填报工作进度,若进度计划需修改,应在报表中申述(进度报表既可按月也可按项目分阶段填报)。
5.7软件的交付管理
按[版本启用/存档细则]执行。
5.8软件版本管理
5.8.1应顾客需要进行软件版本升级或修订时,设计部门负责人确定项目负责人,组织软件人员实施。
5.8.2软件负责人发出[版本送检(启用)通知单]升级的版本由物流部组织检测合格后,由软件负责人将新版本存入标准档案室;并在[版本档案]中详细记录升级内容,存入项目档案中。
5.8.3技术人员在为顾客服务的现场,遇到需要版本修订时,应先电告项目负责人,经认可后,回厂填写[用户服务档案],必要时项目负责人应组织评审和检测。
5.9文档要求
5.9.1各阶段需具备的基本文档及文档格式(见附录)
5.9.2鉴定需具备的文档参见附录。
6支持文件
7记录
7.1质量记录
7.1.1JL/PLA10.05-2002版本启用通知单
7.1.2JL/PLA14.00-2002用户服务档案
7.1.3JL/PLA07.06-2002软件测试修改单
以上记录由标准档案室保存三年。
7.2工作记录
7.2.3版本档案
以上记录由标准档案室保存三年。
7.3附录
附录一:
软件产品文件表
附录二:
版本启用/存档实施细则
附录三:
概要设计说明书
附录四:
需求说明书
附录五:
软件开发规范
附录六:
程序设计若干规定
附录一:
软件产品文件表
序号
文件名称
文件
简号
产品
产品的组成部门
成套软件
整件
整件
软件
1
任务委托书
RW
●
○
2
可行性研究报告
KY
●
○
3
软件需求说明
RX
●
○
○
○
4
数据要求说明书
SY
○
○
○
5
项目开发计划
XK
○
6
概要设计说明书
GS
○
○
○
7
详细设计说明书
QS
○
○
○
8
数据库设计说明书
SG
○
○
○
9
测试计划
CJ
○
○
○
10
程序
CX
●
●
●
11
测试分析报告
CF
○
○
12
用户手册
YS
●
○
○
13
操作手册
CS
●
○
○
14
程序维护手册
CW
○
○
○
15
项目开发总结报告
XZ
●
●
16
使用报告
SB
●
●
17
产品标准
—
●
●
18
媒体内程序/数据目录
MM
●
●
●
19
成套软件明细表
MX
●
20
整件明细表
MX
●
●
21
成套运用文件清单
YQ
●
○
22
整件汇总表
ZH
○
○
23
鉴定报告
JB
●
●
24
用户反馈信息
YX
○
○
25
维护记录文件
WJ
○
○
26
版本更新通知
BT
○
○
注:
●表示必须编制的文件;○表示可根据产品的需要制定。
湖南计算机股份有限公司
用户服务档案
JL/PLA14.00-2002
出差人
出差时间
出差地点
用户名称
产品名称
版本号
实际费用
(元)
使用的系统环境:
发现的问题:
解决情况:
改动的程序模块:
用户意见:
办事处意见:
处理结果(回厂后经协调或评审结论):
湖南计算机股份有限公司
版本档案
(工作记录)
编号:
产品名称
版本号
版本适用范围
源版本
取代版本号
版本源程序压缩文件名
代码和
提交人
提交时间
存档日期
配备的输入方法:
修改记录:
备注:
软件测试修改单
JL/PLA07.06-2002
软件名称
测试人
日期
测试问题:
测试人:
日期:
原因分析:
签字:
日期:
纠正措施:
签字:
日期:
回归测试:
签字:
日期:
审批意见:
批准人:
日期:
附录二:
版本启用/存档实施细则
为了规范版本的管理,减少版本的数量,文档资料的管理和保存,文档的及时更新,以及便于电子化的管理和规范工作流程,特制定该实施细则。
一、工作流程和任务:
说明:
1.内部测试:
进行白盒测试,要求对源程序进行检查,分析出可能影响的模块,并对相应的模块进行测试。
2.外部测试:
进行黑盒测试,对整个系统进行测试。
3.审核:
检查文件的完整性和正确性。
4.资料审查:
检查文件的完整性和格式的正确性。
5.批准:
审查该版本是否可以发行。
委派他人对提交的文档进行抽查,验证其正确性和完备性。
6.编号、录入数据、刻盘:
光盘的卷标为8位数字的序列号,在根目录下建立以版本编号为名称的子目录,所有提交的文档资料存放在该子目录中。
版本启用通知单
JL/PLA10.05-2002
名称
编号
状态
配套版本
简要描述
日期
光盘编号
提交人
版本号
被取代的
版本编号
验证码
适用范围
编制人
测试人
资料审查
复制
要求
修
改
的
原
因
不能合并的原因
测
试
结
果
审核意见
批准意见
说明:
栏目
描述
填写人
备注
名称
要求填写产品的全称
提交人
编号
由项目编号+分模块编号+序列号构成
项目编号由4位数字构成,分模块编号由2位数字构成,序列号由4位构成
该版本批准后,编写编号
档案管理员
日期
提交的日期
提交人
版本号
提交人
资料审查
负责检查提交文件的完整性,并将版本启用单录入计算机
档案管理员
验证码
要求复制时能验证版本正确性的关键数据(代码和、文件长度等)
提交人
简要描述
对该版本的简单描述
提交人
光盘编号
由8位数字序列号构成
档案管理员
提交人
负责提交所有的文件
主要设计者
适应范围
描述适用的用户和机器的批次
提交人
状态
作废/使用
档案管理员
编制人
编写该程序的人员签名
审核意见
对提交的文件负责
对被取代版本已发行产品的处理意见和该版本的使用时效
项目负责人
批准意见
技术部经理
修改原因
写明改正了的错误或新增的功能
提交人
不能合并的原因
在原来的版本基础上产生了一个新版本时,但应又不能取代原来版本时,必须说明原因。
提交人
复制要求
说明发行版本的格式,版本载体的类型(介质),复制的设备,复制的特殊要求
提交人
配套版本
当一个产品需要几个软件构成,必须主要与该版本配套的版本的编号,或关系用“/”隔开,与关系用“,”隔开
提交人
测试人
不能少于两人
测试该版本的所有人员的名单,要求签名
附录三:
概要设计说明书
概述
介绍该项目的名称、任务提出者、提出的背景,应用的目标。
功能和性能
对照软件需求说明书,来说明系统是如何满足功能和性能需求的。
开发工具和平台
描述采用何种操作系统平台、何种编程语言、开发工具进行开发。
总体结构设计
用图表和文字方式说明该系统由几个模块构成,各模块的功能、各模块之间的关系。
用数据流图描述出数据在该系统中的流动过程,在各模块输入前和输出后数据的变换。
用程序流程图描述出主要功能的实现方式。
接口设计
外部接口
说明该系统同外部所有的接口安排,包括硬件接口、软件接口、用户接口。
内部接口
说明该系统内部各个模块之间的接口安排。
系统数据结构设计
逻辑数据结构设计
给出该系统内所使用的每个数据项、记录、文件的标识