技术研发模版Word下载.docx
《技术研发模版Word下载.docx》由会员分享,可在线阅读,更多相关《技术研发模版Word下载.docx(31页珍藏版)》请在冰豆网上搜索。
(3)V1.00
为正式版本。
此时的版本已经经过讨论,试用,修改,补充和不断完善,并且
V1.00
以前欠缺的文档与
试用过程
中的文档都已经按照
版本的要求整理完毕,此时的
版已经成熟,可以整体升级到
版。
版本的文档规
范将作为公司内部与技术研发工作相关的所有人员在今后相当一段时间内共同遵守的规范,并且将文档的撰写工作作为技术研
发的一个重要组成部分正式纳入到技术研发工作中。
(4)V1.00
规范将具有强制性和高约束力。
(注:
Vi.00,i=0,1,2,…表示
i
版本系列;
Vi.mn,i,m,n=0,1,2,…表示
版本系列下的改动或升级)
第二部分目录索引
一﹑版本控制规则
二﹑立项
1﹑说明
2﹑模板
三﹑需求分析
四﹑可行性分析
五﹑功能定义
2.
模板
六﹑概要设计
1﹑硬件部分
(1)说明
(2)模板
2﹑软件部分
七﹑详细设计
八﹑测试
1﹑测试流程
2﹑测试要求
(1)硬件部分
(2)软件部分
3﹑测试模板
九﹑从研发到产品的过渡
(1)要求
十﹑技术支持
十一﹑文档工作的评估与审核
(1)评估标准
(2)审核要点
第三部分内容
(1)版本状态:
Beta/测试版,Release/正式版,Changing/变更
(2)版本号:
版本号以三位数字表示,格式为
i.jk(i=0,1,2,…,n;
jk=01,…,99)
a.Beta
版,i=0
b.第一次正式发布的
Release
版,1.00
c.用
Changing
来表示
Beta
或
版本的修改或升级
d.小的改动或升级
i,j
保持不变,只增加
k
值即可,k
的升值幅度为修改或升级处的数目,当
值达到或增加至
9
时,j=j+1,
k=0
e.比较大的改动如,一次修改或升级处的数目>
10,功能性的增加或改变,则
保持不变,增加
j
值。
如果是功能性的修改或
变动,每有一项
j+1;
如果是>
10
的非功能性的修改,每
处修改,j+1,个数部分用
来表示
f.重大变动,i
值增加
g.累计功能变动超过百次,i+1,jk=00
立项管理(Project
Initialization
Management,PIM)的目的是采纳符合公司最大利益的立项建议,通过立项管理使该建议成为
正式的项目(合法化)。
杜绝不符合公司最大利益的立项建议被采纳,避免公司人力资源的,资金,时间的浪费。
立项管理是决策行为,目标是“做正确的事情”(do
right
things)。
而立项之后的研发管理活动是保证项目团队“正确地做事情”(do
things
right)。
“正确的决策”+“正确地执行”才有可能产生好的产品。
1﹑说明:
(1)立项:
任何一次研发工作的启动,包括全新的项目和在以往的项目基础上进行升级或改版的项目,都需要进行立项的工作。
(2)项目分级:
为了明晰立项的工作,使之有条理,可操作,所以将项目区分为一级项目和二级项目两个不同的等级
a﹑一级项目:
包括全新的项目的启动,原有项目的重大改版和升级
b﹑二级项目:
在以往项目的基础上进行的非重大的版本修改和完善
(3)项目审批:
a﹑
所有一级项目必须由项目负责人提交项目申请计划书,并就项目的相关情况向总经理和技术总监书面陈述或面对面沟通,得
到总经理和技术总监的审批签字后方能启动;
b﹑
一级项目必须附加需求分析与可行性分析
c﹑
二级项目可以由部门经理指定或由项目负责人申请得到部门经理审批签字后即可执行,不必交由总经理和技术总监审批签字;
d﹑对于二级项目,必须将项目计划申请书(纸介质)交由技术文档负责人归档,总经理及技术总监对二级项目的进展情况具有知
情权,而项目负责人具有向总经理和技术总监汇报(主动或被动)项目相关情况的义务;
e﹑项目申请计划书一式两份:
纸介质文档与电子文档。
纸介质文档作为技术档案由专门负责人员备份归档。
电子文档按规范要求
存储在公司指定的文档服务器上。
(4)权利,责任与义务
总经理,技术总监,部门经理对其所具有审批权限的项目申请计划书具有否决的权利;
项目申请人有权要求否决人说明被否决的理由,而且否决人必须在被否决的项目申请计划书中陈述否决理由;
具有审批权限的人对于项目的合理性,需求性,可行性等判断负有全权责任;
2﹑项目申请计划书
项目编号
项目申请计划书/立项建议书
EPF2003NOX-01
级
别
一级项目
□二级项目
类别
申
请
人
负责人
项目名称
□指定项目
申请项目
Su
基于
GPRS
的图像传输
版本说明
申请日期
组
成
员
产品名称
V0.10
2003-8-18
Su,Zhang,Yu
G-BIU(Hardware,GPRS-Based
Image
Unit
),
G-BIUST(Software
,G-BIU
Support
Toolkit)
资源配置需求
理由陈述
近期
目标(年月日~
年月日)
成本简要核算
中
长
期
(年月日~
(暂时可不添此项)
远
问题(在此陈述进行该项目可能遇到和需要解决的问题,除了技术层面外,还包括设备,
人员配备等方方面面的主要问题)
问题与解决
解决方法针对以上的问题,提出解决建议
备注说明
审批结果
审批意见
□通过
□否决
审批日期
审批人签字
三﹑需求分析:
如果说立项管理是为了解决
do
和
的问题,那么需求分析就是要解决
what
的问题。
需
求产生目标,目标引领方向。
好的需求分析不仅要解决“需要做什么”
同时明确“什么不需要做”。
最好的,可能产生最大利益的产品
是“恰如其分”的产品。
所谓“恰如其分”就是:
产品的功能恰好满足那些特定的需求,产品功能不多也不少。
一般的情况下,总结出
“需好做什么”比区分“什么不需要做”要来的容易,但“什么不需要做”的界定往往会影响到成本投入和利益产出的比例。
(1)需求分析工作的安排:
进行一项产品的开发工作的一般流程应该是:
市场调查—需求分析—可行性研究—立项审核—概要设计
(总体设计)—详细设计—单元测试—集成测试—修改完善—项目评估,审核—批量生产—投放市场—技术支持与售后服务。
(2)需求的种类:
需求的本质上都来源于市场,但是在具体表现上又有所不同。
有的需求直接由用户提出,目标明确;
而有些需求
则是我们从市场的零星反馈中总结出来的,带有预见性和自主性。
(3)需求分析的主要目的:
从市场的反馈或对市场的观察与预见中总结出市场的需求,并用理性的思维对这些需求进行分析和总结,
将需求明确,为后面的工作奠定基础。
(4)需求分析的作用:
需求分析是市场与技术的转换点。
经过需求分析后,工作的重心即由市场转移到技术,明确的需求分析是真
正进行研发工作的起点,是进行产品开发一系列后序工作的基础。
(5)需求在进行研发的过程中如果发生变更,需要填写“需求变更说明书”
2﹑模板
1
配置编号
目标用户
EPF2003NOX-02
陈述产品的目标用户
需求分析说明书/报告
作者
提交时间
内容
级别
□A
□B
□C
需求陈述
2
解决方法简单描述针对需求的初步解决意向
附加说明
讨论意见
项目评审委
员会结论
A
需求:
紧急,重要
B
重要,不紧急
C
非
A,B
类需求
模板
需求/功能变更
说明书
EPF2003NOX-02-01
G-BIU(GPRS-Based
Unit)
历史版本
V2.00
改后版本
时间
V2.17
2003-8-19
变更内容是否允许
变更项1
3
D
M
是
否
变更属性中
代表增加,D
代表删除,M
代表修改
项目评审委员会给出是否进行变更的意见,由评委会主席签字生效
四﹑技术可行性分析
可行性分析是进行研发工作的重要环节,详细周到的可行性分析与论证为即将启动的项目把握一道至关重要的关口。
技术可行性分析要求从技术层面上分析论证项目的可行性,即能否“做得到,做得快,做得好”。
可行性分析报告由项目申请责任人
总结,撰写,并提交到项目评审委员会审阅。
有项目申请/建议书,需求定义和需求报告仍然不能进行实质性的开发,必须要进行可行性分析,可行性分析包括几个部分
(1)市场分析:
a.分析总结市场的发展趋势,说明产品处于市场的什么发展阶段,粗略估计产品的生命周期
b.本产品和同类产品的价格比对
c.统计产品当前市场总额,竞争对手所占的份额,分析本产品有哪些比较优势,可能占有多少市场份额
d.为产品定位,即确定产品用户群,分析产品消费群体特征,消费方式及影像市场的因素分析
(2)政策分析
a.分析有无相关政策“支持”或“限制”
b.分析有无地方政府或其他机构的“扶持”或“干扰”
(3)竞争分析
a.分析竞争对手的市场状况,产品的优点与缺点
b.预测可能形成的竞争的特点与周期
(4)技术可行性分析
(5)时间和资源可行性分析
a.按正常的运作,从产品开发到投入市场,时间上是否来得及
b.计划中的人员能否及时到位
c.计划中的软硬件需求能否及时到位
d.成本核算能否负担得起
(6)知识产权分析
a.是否已经存在某些专利将妨碍本产品的开发与推广
b.产品能否得到知识产权的保护
技术可行性分析报告
配置编号EPF2003NOX-03报告撰写人提交时间2003-8-19
由项目负责人总结,撰写
可行性论述
主要从能否“做得到”,“做得快”,“做得好”的角度分析
如果能“做得到”,“做得快”,“做得好”,需要给出通过怎样的方法保证
如果不能,需要给出理由
由技术秘书总结
讨论意见撰写人提交报告后到项目评审委员会后,项目评审委员组织人员对报告的“可行性论述”展开讨论,技术秘书总结
各方意见,记述在此栏
员会意见
项目评审委员会给出整体意见,供决策人参考
1.说明:
功能定义是对
的明确界定,是针对明确的需求来定义产品功能的过程。
是产品设计的实质性阶段,此
后的研发工作将围绕功能定义展开,功能定义说明书是参与研发的人员进行工作的基础文档,是产品测试与评审,用户手册
的编制,市场宣传的主要依据。
2.模版
功能定义说明书
配置编号EPF2003NOX-04负责人提交时间2003-8-19
功能描述
功能项
1、硬件部分:
为了简化操作流程,使文档既能体现设计原理与设计思路,又具有良好的操作性,所以对于硬件部分的概要设计要求只
要求给出原理图,思路描述,主要器件,主要器件的技术参数。
概要设计报告(H)
原理图
EPF2003NOX-05-H
负责人
时间
在此添入原理图配置编号,原理图配置编号由技术文档秘书统一编制,编号编制方法待讨论,
(改动:
EPF2003NOX-05-H-01)
设计思路描述基本要求:
负责人必须对关键的设计思想进行清楚的描述
器件名称用途
技术参数参考
主要器件
及技术参数
资料名称编号
主要参考资料1
●按照
重要,关键性器件—>
主要器件—>
辅助性器件的顺序描述主要器件及技术参数栏。
●每一种参考资料都有自己的编号如:
EPF2003NOX-05-H-R1
2、软件部分:
软件部分的概要设计需要提交的报告有:
概要设计报告,界面设计报告,数据库设计报告
概要设计报告(S)
EPF2003NOX-05-S-01
作者
当前版本
V1.20
术语
解释
V1.00,V1.07,V1.17
术语与缩写解释G-BIAS即
GPS-Based
Integrated
Application
System
﹡系统应当遵循的标准或规范
﹡软硬件环境(包括运行环境与开发环境)的约束
﹡接口/协议的约束
设计约束﹡用户界面的约束
*软件质量约束,包括正确性,健壮性,可靠性,效率(性能)
易用性,清晰性,安全性,可扩展性,兼容
性,可移植性。
(如果有约束,逐一填写;
如果不存在约束,可不填)
﹡扩展策略—为了方便扩展,现在采取的措施
设计策略﹡复用策略—说明本系统在当前以及将来的复用策略
﹡折衷策略—如果存在两个主要目标难以同时优化时如何折衷
系统总体结构描
述
软件
开发环境配置硬件
网络
主要开发工具及语言
硬件
包括操作系统,第三方软件平台
运行环境要求
数据库
资料配置编号来源
参考资料1
其他说明
﹡如果系统比较复杂,首先将系统分解成若干子系统,对各个子系统绘制逻辑图,说明子系统的功能
*解释如何以及为什么如此分解系统
﹡说明子系统间如何如何协调工作,以实现元系统的功能
﹡如果子系统
N
仍然需要分解成模块,则
(1)绘制模块逻辑图
(2)陈述分解理由
(3)说明模块间如何协调工作,从而实现子系统的功能
﹡如果系统相对简单,给出用工具
Visio
绘制的系统逻辑结构图
界面设计报告
界面设计报告(S)
EPF2003NOX-05-S-02
历史版本
V1.00,v1.07,v1.17
绘制界面视图
界面结构及风格
(1)主界面:
需要给出界面元素的作用与操作
(2)子界面:
给出子界面的主要作用
第三方界面元素
名称
来源
作用
控件,组件,函数
库及其来源
数据库设计报告主要完成数据库的物理设计,即表的结构设计与对表结构的第三范式处理
数据库设计报告(S)
EPF2003NOX-05-S-03
表汇总
A
B
C
列名
表名
数据类型(经度范围)
约束条件
备注
A1
补充说明
可以访问的表与列访问权限
角色与权限角色
角色
1.
硬件部分,硬件部分的详细设计主要体现在下位机软件的代码上,所以详细设计文档的内容集中在对代码的要求上面,代码要求
(1)所有的代码模块必须用文件的方式组织
(2)在每一个文件中的开头以注释的方式写如下内容:
Copyright(c)2003,**公司,硬件开发部
*All
rights
reserved
*文件名称:
*文件标识:
文件标识可以统一规定,也可以自己选择
*摘要:
简要描述该文件的内容
*
*当前版本:
*作者:
输入作者或修改者的名字
*完成日期:
*取代版本:
*原作者:
(3)如果用
语言开发
a.必须将.H
文件与.C
文件区分开来,在.H
中定义全局变量,结构,联合,自定义群体等,如链表;
函数的声明
b.在定义函数体前,以注释方式写如下内容
*函数的主要作用
*输入输出参数的含义
(4)全局变量的定义要集中,并说明用途
(5)主要变量必须在定义之后说明用途
(6)所有函数的定义必须给出函数的作用
所有函数定义列
表
流程图
详细设计报告(H)
EPF2003NOX-06-H
函数定义
2003-8-20
主要用途
外部接口
接口/库名
来源
外部接口/库1
内部通讯协议
外部协议
通讯协议
填入内部通讯协议文档配置编号
如
SMPP,S7
等
2.软件部分
软件部分的详细设计报告内容相对较多,所以设计报告分成若干部分
详细设计报告(SP1)
系统架构
EPF2003NOX-06-S-01
如果能用图表示,必须用图表示,不好用图表示的部分,可以用文字描述
名称
作用
使用
主要控件/组件1
类/结构1
主要的数据结构
关键算法
类名
数据结构
算法
描述
实现过程
自定义消息
消息名称
消息
ID
Invoke
条件
主要控件一栏包括:
●第三方控件,如
MapX,FlatStyle
等,在使用此类控件中必须给出此控件的作用,来源如购买,Share
等;
必须简要描
述此类控件的使用方法,如果控件本身带有资料描述,必须以附录资料的形式给出资料
●主要的类/结构:
程序中所有用到的类,包括自己独立封装的类,从固有的类中集成下来的类,简要陈述类的作用。
如果
回使用建模工具,则需要用类图来描述出类的结构,继承关系等。
●主要的数据结构,如结构(记录),链表,栈,队列,图,树及作用
●关键算法:
关键不是复杂,任何一个程序都有关键算法,这里的“关键”的引申含义为:
主要,重要。
必须给出算法的
作用与实现的思路过程描述
详细设计报告(SP2)
EPF2003NOX-06-S-02
内部接口(方法/
函数/过程)
接口
参数描述
Map.Distance()
接口
宿主
●所谓接口,不过是函数在特定概念下的称谓。
外部接口,程序中所使用的外部函数。
例如,在使用MapX
控件时,需要使
用
Map.Distance()接口函数来计算距离,那么既需要描述出
Map.Distance()的作用与参数描述
●内部接口:
所谓宿主,即指包括此接口的自定义或从固