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